From 00574dcab9a8016ecfac051448f4683aea03393b Mon Sep 17 00:00:00 2001 From: lynklody Date: Wed, 26 May 2021 02:35:32 -0700 Subject: [PATCH] Add simplified Chinese for the main README doc --- README.md | 4 +- README_zh_CN.md | 125 ++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 128 insertions(+), 1 deletion(-) create mode 100644 README_zh_CN.md diff --git a/README.md b/README.md index d1206c479..59c074a41 100644 --- a/README.md +++ b/README.md @@ -4,6 +4,8 @@ [![Build Status](https://travis-ci.com/dogecoin/dogecoin.svg?branch=master)](https://travis-ci.com/dogecoin/dogecoin) +Select Doc Language: ENG | [CN_simplified](./README_zh_CN.md) | [more...](./README.md) + Dogecoin is a cryptocurrency like Bitcoin, although it does not use SHA256 as its proof of work (POW). Taking development cues from Tenebrix and Litecoin, Dogecoin currently employs a simplified variant of scrypt. @@ -53,7 +55,7 @@ not straightforward. ## Very Much Frequently Asked Questions ❓ ### How much doge can exist? – So many puppies! 🐕 -Early 2015 (approximately a year and a half after release) there were +Early 2015 (approximately a year and a half after release) there will be approximately 100,000,000,000 coins. Each subsequent block will grant 10,000 coins to encourage miners to continue to secure the network and make up for lost wallets on hard drives/phones/lost diff --git a/README_zh_CN.md b/README_zh_CN.md new file mode 100644 index 000000000..bc2d26004 --- /dev/null +++ b/README_zh_CN.md @@ -0,0 +1,125 @@ +# 狗狗币核心 (Dogecoin Core) [DOGE, Ð] + +![Dogecoin](https://static.tumblr.com/ppdj5y9/Ae9mxmxtp/300coin.png) + +[![Build Status](https://travis-ci.com/dogecoin/dogecoin.svg?branch=master)](https://travis-ci.com/dogecoin/dogecoin) + +选择文档语言: [英文](../README.md) | 简体中文 | [其他语言...](./README_zh_CN.md) + +尽管狗狗币不使用SHA256作为它的工作量证明(POW),狗狗币也是一款类似Bitcoin的加密货币。受到Tenebrix和Litecoin的影响,狗狗币目前采用一种更简洁的加密方式。 +- **网址:** [dogecoin.com.](https://dogecoin.com) + +## 证书 – 炫酷的证书 ⚖️ +狗狗币在MIT liscence的条款下发行。详情请参见 +[COPYING](COPYING) 或者 +[opensource.org](https://opensource.org/licenses/MIT)。 + +## 开发和贡献 – omg 开发者 +目前的研发还在进行中,开发团队以及其他志愿者可以随意通过自己的代码库分支发布pull request。 + +#### 版本说明 +版本号码遵循以下语法:```major.minor.patch```。 + +#### 代码库分支(branch) +本代码库有3个branch: + +- **master(主代码库):** 稳定。包含最新版本的release,以*major.minor*形式呈现。 +- **maintenance(维护代码库):** 稳定。包含正在维护中的上一个release的最新版本。格式: ```-maint``` +- **development(正在开发代码库):** 不稳定。包含下一个release的最新代码。格式: ```-dev``` + +*Master 和 maintenance 互不干扰。最新release永远包含一个development分支。新的 pull request 应该发布于此。Maintenance 分支**只能用于调试程序**。请将新开发的功能发布在 development 分支的最高版本。* + +#### 贡献 ✍️ + +鼓励开发者为新代码来创建自己的[单元测试](src/test/README.md),或者为旧代码发布新的单元测试。用如下指令编译并运行单元测试(仅限于单元测试在配置中没有被禁用):`make check`。更多关于运行和开发单元测试的信息请查看:[/src/test/README.md](/src/test/README.md). + +RPC界面上还有由Python编写的[回归和整合测试(regression and integration tests)](/qa) ,可以在build服务器上自动运行。这些测试还可以通过以下指令来运行:`qa/pull-tester/rpc-tests.py`(前提是已经安装了[测试依赖文件(test dependencies)](/qa))。 + +代码的改变还应该由除开发者之外的其他人员进行测试。这一点对于大段改动和高危变化尤其重要。建议在pull request的描述中加入测试文档(test plan),如果测试方式并不很直接。 + +## 灰常常见的问题 ❓ + +### 到底一共可以有多少狗狗币? – 狗狗多多! 🐕 +截至2015年初(大概发行一年半的时间)将会有100,000,000,000狗狗币。 +之后的每个区块(block)将会带来10,000狗狗币来激励矿工们持续输出,增加挖矿的安全性并且对因丢失的钱包、硬盘、手机、密码等而丢失的狗狗币做出相应弥补。 + +### 挖矿须知 ⛏ + +狗狗币采用一种简洁的密钥导出函数作为每区块一分钟的工作量证明。区块奖励是固定的,且随着每100,000区块而减半。从第600,000个区块开始,一个永久性的10,000狗狗币/区块的奖励会被发放。 + +起初,我们预见了一种不同的支出方式,决定区块奖励的是将每区块的最大奖励并且应用Mersenne Twister伪随机数生成器的结果来得到一个从0到最大奖励之间的数,作为奖励。 + +然而在第145,000区块上,为了防止大验证池钻空子挖到奖励最丰厚的矿,这种形式就不适用了。与此同时,重新瞄准的难处也从每区块四小时变为每区块(每分钟)一次,使用的是DigiByte Coin开发团队的一个算法,为了减少突然增加或减少狗狗币网络哈希率的冲击。 + +**目前的区块奖励机制:** + +1–99,999: 0–1,000,000 Dogecoin + +100,000–144,999: 0–500,000 Dogecoin + +145,000–199,999: 250,000 Dogecoin + +200,000–299,999: 125,000 Dogecoin + +300,000–399,999: 62,500 Dogecoin + +400,000–499,999: 31,250 Dogecoin + +500,000–599,999: 15,625 Dogecoin + +600,000+: 10,000 Dogecoin + +**原先的区块奖励机制(一分钟区块和四小时难度调整):** + +1–99,999: 0–1,000,000 Dogecoin + +100,000–199,999: 0–500,000 Dogecoin + +200,000–299,999: 0–250,000 Dogecoin + +300,000–399,999: 0–125,000 Dogecoin + +400,000–499,999: 0–62,500 Dogecoin + +500,000–599,999: 0–31,250 Dogecoin + +600,000+: 10,000 Dogecoin + +### 请编译我吧 / Wow plz make dogecoind/dogecoin-cli/dogecoin-qt + + 以下是开发者的笔记,教你如何在你自己的平台上搭建狗狗币。这些不是什么权威指南,但包含了必要的libary, 编译flag 等等。 + + - [OSX Build Notes](doc/build-osx.md) + - [Unix Build Notes](doc/build-unix.md) + - [Windows Build Notes](doc/build-windows.md) + +### 端口们 + +- RPC 22555 +- P2P 22556 + +## 开发贴士与技巧 + +**调试编译** + +运行 `configure`, 应用 `--enable-debug` 选项, 然后 `make`. 或者运行 `configure` 应用 +`CXXFLAGS="-g -ggdb -O0"` 或者其他你需要的flag。 + +**debug.log** + +如果代码表现得很诡异,看一眼data路径下的debug.log;错误信息和调试消息都在这里。 + +`-debug=...`这个选项代表调试模式;带着这个flag去运行会打开所有的类别(并输出一个非常大的debug.log文件)。 + +Qt代码把 `qDebug()` 放到qt类别下的debug.log文件里;使用方式`-debug=qt`。 + +**测试链(testnet)和私有网络(regtest)模式** + +如果你在通过因特网测试跨机代码,在测试链上运行`-testnet`来运行“开始使用狗狗币”。 + +如果你在测试单机代码,用`-regtest`运行。 +在回归测试模式下,区块可以随时被按需制造出来;参见qa/rpc-tests/。 + +**DEBUG_LOCKORDER** + +狗狗币核心是一个多线程应用,死锁和其他多线程问题都会很难找到原因。通过`-DDEBUG_LOCKORDER`编译 (`configure CXXFLAGS="-DDEBUG_LOCKORDER -g"`)会在运行时插入检查语句来检测哪些进程被锁定并且把警告加入debug.log文件中,如果在代码中发现了不一致的地方。