translate README to Chinese

[diguage]

No description provided.

[diguage]

Why have all checks failed?

[pepijnve]

Unrelated issues. Trying to get all tests working on Travis and Appveyor. That requires two versions of phantomjs in parallel.

[pepijnve]

Thanks for making this translation btw. I'm a little bit reluctant to merge this since it's something I can't maintain myself and I'm worried it will be out of sync with the English README all the time.
@mojavelinux do you have translations for Asciidoctor documentation? If so, how do you keep all translations in sync?

[diguage]

Now, I write my documents with Asciidoctor. I like Asciidoctor. So, I'll keep Chinese translations in sync.

I want to introduce Asciidoctor to Chinese poeple. I am translating all the Asciidoctor documents to Chinese. asciidoctor/asciidoctor.org#585

I translated the README of Asciidoctor to Chinese. asciidoctor/asciidoctor#1772

[mojavelinux]

If found the secret to keeping translations up to date is simply a good relationship with the community. There's no silver bullet, aside from dedicated people. Human powered ;)

I asked @diguage to send the translation here as part of an ongoing effort to add translations to asciidoctor.org. I would much rather have the translation in the upstream project than sitting downstream in asciidoctor.org, which really should just be a documentation aggregator.

To help make it clear who the current maintainer of the translation is, it's important to have the field "translator" (or "translators") in the AsciiDoc header, perhaps even shown at the top of the page like we do at http://arquillian.org/guides/getting_started_zh_cn/. If an issue comes in to update the README, just mention the translator to give that person a chance to update.

[diguage]

I added the issue about translator field asciidoctor/asciidoctor#1755.

[mojavelinux]

You don't need to wait on a change in core to add the translators. Just add it to the metadata to the header:

:translators: D瓜哥

Then reference it somewhere in the text:

ifdef::env-github[Translated by: {translators}]

When we render it on the website, we might decide to place it somewhere more strategic, which is why I put it behind a conditional.

[mojavelinux]

What's important is to get the information into the document. We can always deal with how we show it later.

[diguage]

The checks have failed. How to resolve the problem?

[pepijnve]

You don't need to fix these. These are due to failures on master that I need to fix.

[diguage]

There is the discussion about the disclamer: asciidoctor/asciidoctor-maven-plugin#223

[pepijnve]

Sorry for the delay in merging this PR. I've been swamped with other tasks and simply didn't find the time to get this done until now.

[mojavelinux]

👍