Homestead-Guide-CN（Homestead指南中文版）

The Ethereum Homestead Guide-CN is the Chinese version of the reference documentation accompanying the Homestead release of the Ethereum project, which is an unofficial project created by Rivers Yang, a programmer with 15+ years experience in software technology.

The Original English version is Hosted on ReadTheDocs

HOW YOU CAN HELP

I start this project just for my personal interest and for the tech learning in Smart Contract (Blockchain) area. I welcome any contributor for this project, and you better are Chinese too. :-)

GETTING STARTED

This project uses Sphinx (http://www.sphinx-doc.org/en/stable/index.html) to build html that is published to Read the Docs. To run this documentation on your computer, you should do the following:

Prerequisites

• Python 2.6 or later
• git

Install Sphinx, etc

For OSX/Linux users (based on instructions here: https://read-the-docs.readthedocs.org/en/latest/getting_started.html). Sphinx as of 1.4.0 no longer automatically installs sphinx_rtd_theme, hence its addition below.

• From command line: sudo pip install sphinx sphinx_rtd_theme

For Windows users:

• http://www.sphinx-doc.org/en/stable/install.html#windows-install-python-and-sphinx

Get source code

• git clone: https://github.com/ethereum/homestead-guide.git

Build and view html

• In a terminal window, go to your homestead-guide directory.
• make html
• cd build/html
• open index.html (open in web browser)
• Tip: each time you run make html, just reload your browser to view changes

RESOURCES

Homestead

• Homestead Guide online: https://ethereum-homestead.readthedocs.org/en/latest/index.html
• Github: https://github.com/ethereum/homestead-guide
• Gitter: https://gitter.im/ethereum/homestead-guide
• Google doc: https://docs.google.com/document/d/1rVjrNgaDRAQdPp4rGqWrEk5fPgiHff0xsYGCyf06oM8/edit

Legacy Docs

• Ethereum Wiki: https://github.com/ethereum/wiki/wiki
• Frontier Guide: https://ethereum.gitbooks.io/frontier-guide/content/ (see below for converted files)
• Souptacular's Giant List of Ethereum Resources: https://souptacular.gitbooks.io/ethereum-tutorials-and-tips-by-hudson/content/giant_ethereum_resource_list.html

Read the Docs and Sphinx

• Read the Docs: https://read-the-docs.readthedocs.org/en/latest/getting_started.html
• Sphinx docs: http://www.sphinx-doc.org/en/stable/contents.html
• reStructuredText Primer: http://www.sphinx-doc.org/en/stable/rest.html
• RST cheat sheet: https://github.com/ralsina/rst-cheatsheet/blob/master/rst-cheatsheet.rst

Directory structure

homestead-guide
  build    - workdir, not commited to repo
  source   - actual content in rst
    conf.py - sphinx configuration
  old-docs-for-reference (Frontier era stuff)
    wiki    - the legacy wiki
    gitbook - the legacy gitbook resources (converted to rst)
  make.bat - windows command to build docs
  Makefile - platforms with make to build docs

Roadmap for Homestead Guide (Old)

• boilerplate using sphinx-quickstart
• settings in conf.py
• code up index with proposed structure
• compile/deploy on readthedocs
• include cheatsheat, rst/sphinx/readthedocs resources
• reach out to community reddit - homestead documentation initiative
• allocate chapters to people (ideally author and reviewer)
• migrate old wiki under frontier/wiki (all md files converted to rst)
• migrate old frontier-guide content under frontier/gitbook (all md content converted to rst)
• script to annotate entire wiki with legacy warning

Strategy for migrating old fronter-guide content (Old)

• temporaritly include resources about the documentation project within the book itself * rst cheatsheet * rst/sphinx/readthedocs resources * compilation/deployment instructions * link to issues and process * style guide, conventions
• include the rst conversion of the wiki
• include the rst conversion of the gitbook