\usepackage[ocgcolorlinks]{ocgx2}

.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+Paper.aux
+Paper.bbl
+Paper.blg
+Paper.log
+Paper.out
+Paper.pdf
+Version.tex
+

.travis.yml

@@ -0,0 +1,19 @@
+sudo: required
+before_install:
+- sudo apt-get -qq update
+- sudo apt-get install texlive texlive-latex3
+- sudo apt install texlive-latex-extra
+script:
+- ./build.sh
+deploy:
+  provider: script
+  script: ./travis_deploy.sh
+  skip_cleanup: true
+  on:
+    branch: master
+env:
+  global:
+    - ENCRYPTION_LABEL="19a81de38b62"
+    - COMMIT_AUTHOR_EMAIL="[email protected]"
+    - COMMIT_AUTHOR="Travis CI"
+    - PUSH_REPO="[email protected]:ethereum/yellowpaper.git"

Biblio.bib

@@ -1,3 +1,26 @@
+@Misc{EIP-100,
+	url = "https://github.com/ethereum/EIPs/blob/master/EIPS/eip-100.md",
+	author = "Vitalik Buterin",
+	title = "EIP-100: Change difficulty adjustment to target mean block time including uncles",
+	year = "2016",
+	month = "April",
+}
+
+@Misc{EIP-649,
+	url = "https://github.com/ethereum/EIPs/blob/master/EIPS/eip-649.md",
+	author = "Afri Schoedon and Vitalik Buterin",
+	title = "EIP-649: Metropolis Difficulty Bomb Delay and Block Reward Reduction",
+	year = "2017",
+	month = "June",
+}
+
+@Misc{EIP-2,
+	url = "https://github.com/ethereum/EIPs/blob/master/EIPS/eip-2.md",
+	title = "EIP-2: Homestead Hard-fork Changes",
+	author = "Vitalik Buterin",
+	year = "2015",
+}
+
 @Misc{cryptoeprint:2013:881,
 	Note = {{http://eprint.iacr.org/}},
 	Url = {{Cryptology ePrint Archive, Report 2013/881}},
@@ -102,7 +125,7 @@ @InProceedings{miller1997future
 }
 
 @article{buterin2013ethereum,
-	url = {{http://ethereum.org/ethereum.html}},
+	url = {{https://github.com/ethereum/wiki/wiki/White-Paper}},
 	author = {Vitalik Buterin},
 	title = {{Ethereum: A Next-Generation Smart Contract and Decentralized Application Platform}},
 	year = {{2013}},
@@ -141,4 +164,4 @@ @article{FowlerNollVo1991FNVHash
 	author = {Glenn Fowler, Landon Curt Noll, Phong Vo},
 	title = {{Fowler–Noll–Vo hash function}},
 	year = {{1991}},
-}
+}

README.md

@@ -1,13 +1,26 @@
-# yellowpaper
+# Ethereum Yellow Paper
 
+[![License: CC BY-SA 4.0](https://img.shields.io/badge/License-CC%20BY--SA%204.0-lightgrey.svg)](https://creativecommons.org/licenses/by-sa/4.0/)
 [![Gitter](https://badges.gitter.im/ethereum/yellowpaper.svg)](https://gitter.im/ethereum/yellowpaper?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-The paper comes as a single ``latex`` file ``Paper.tex``.
+The Yellow Paper is a formal definition of the Ethereum protocol, originally by Gavin Wood, currently maintained by Nick Savers and with contributions from many people around the world.
 
-It can be viewed in ``PDF`` format with ``pdflatex Paper.tex`` (local install of a current free tex distribution required).
+It is free culture work, licensed under the Creative Commons Attribution Share-Alike (CC-BY-SA) version 4.0.
 
-After creating ``Paper.pdf`` for the first time and every time the bibliography file (``Biblio.bib``) is updated, you will also need to run ``bibtex Paper`` and then ``pdflater Paper`` twice (e.g. ``bibtex Paper && pdflatex Paper && pdflatex Paper``) in order to correctly incorporate all the bibliography references.
+## Usage
 
-There are also some online tools like http://latex.informatik.uni-halle.de/latex-online/latex.php you can use for 
-compiling/preview.
+The paper comes as a single ``latex`` file ``Paper.tex``. The latest version is generally available as a PDF at https://ethereum.github.io/yellowpaper/paper.pdf or just [yellowpaper.io](http://yellowpaper.io/). If you find that the borders for links block too much text when viewing the PDF in the browser, you can instead download it and open and view it with a PDF viewer application such as Adobe Acrobat or Evince, where the borders are less likely to display over text.
 
+## How to build
+
+The paper also comes as a single ``latex`` file ``Paper.tex``, which is built as a PDF as follows.
+
+```
+git clone https://github.com/ethereum/yellowpaper.git
+cd yellowpaper
+./build.sh
+```
+This will create a PDF version of the Yellow Paper. Following building, you can also use standard `pdflatex` tools like http://latex.informatik.uni-halle.de/latex-online/latex.php for compiling/preview.
+
+## Other language versions
+- [Chinese](https://github.com/yuange1024/ethereum_yellowpaper) translated by YuanGe and GaoTianlu

build.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [ -d ".git" ]; then
+
+SHA=`git rev-parse --short --verify HEAD`
+DATE=`git show -s --format="%cd" --date=short HEAD`
+REV="$SHA - $DATE"
+
+else
+
+REV="unknown revision"
+
+fi
+
+echo "\newcommand{\YellowPaperVersionNumber}{$REV}" > Version.tex
+
+pdflatex -interaction=errorstopmode -halt-on-error Paper.tex && \
+bibtex Paper && \
+pdflatex -interaction=errorstopmode -halt-on-error Paper.tex && \
+pdflatex -interaction=errorstopmode -halt-on-error Paper.tex && \
+pdflatex -interaction=errorstopmode -halt-on-error Paper.tex