Merge pull request #3432 from NervosBeijingCommunity/shooter

[solidity/en,cn] Solidity code should not be mixed with Javascript code

solidity.html.markdown

@@ -5,6 +5,7 @@ contributors:
   - ["Nemil Dalal", "https://www.nemil.com"]
   - ["Joseph Chow", ""]
   - ["Bhoomtawath Plinsut", "https://github.com/varshard"]
+  - ["Shooter", "https://github.com/liushooter"]
 ---
 
 Solidity lets you program on [Ethereum](https://www.ethereum.org/), a
@@ -237,7 +238,7 @@ uint x[][5]; // arr with 5 dynamic array elements (opp order of most languages)
 // Dictionaries (any type to any other type)
 mapping (string => uint) public balances;
 balances["charles"] = 1;
-console.log(balances["ada"]); // is 0, all non-set key values return zeroes
+// balances["ada"] result is 0, all non-set key values return zeroes
 // 'public' allows following from another contract
 contractName.balances("charles"); // returns 1
 // 'public' created a getter (but not setter) like the following:
@@ -403,8 +404,12 @@ event LogSent(address indexed from, address indexed to, uint amount); // note ca
 // Call
 LogSent(from, to, amount);
 
-// For an external party (a contract or external entity), to watch using
-// the Web3 Javascript library:
+/**
+
+For an external party (a contract or external entity), to watch using
+the Web3 Javascript library:
+
+// The following is Javascript code, not Solidity code
 Coin.LogSent().watch({}, '', function(error, result) {
     if (!error) {
         console.log("Coin transfer: " + result.args.amount +
@@ -415,6 +420,8 @@ Coin.LogSent().watch({}, '', function(error, result) {
             "Receiver: " + Coin.balances.call(result.args.to));
     }
 }
+**/
+
 // Common paradigm for one contract to depend on another (e.g., a
 // contract that depends on current exchange rate provided by another)
 

zh-cn/solidity-cn.html.markdown

@@ -6,8 +6,9 @@ contributors:
   - ["Nemil Dalal", "https://www.nemil.com"]
   - ["Joseph Chow", ""]
   - ["Bhoomtawath Plinsut", "https://github.com/varshard"]
+  - ["Shooter", "https://github.com/liushooter"]
 translators:
-  - ["Bob Jiang", "https://github.com/bobjiang"]  
+  - ["Bob Jiang", "https://github.com/bobjiang"]
 ---
 
 Solidity 使你在[以太坊](https://www.ethereum.org/)上编程，一个基于区块链的虚拟机，
@@ -20,7 +21,7 @@ Solidity 是一种与 Javascript 和 C 的相似的、静态类型的合约编
 以太坊合约的例子包括众筹、投票以及盲拍（私密拍卖）。
 
 Solidity 代码中存在高风险和高成本的错误，因此你必须非常小心地进行测试并慢慢地发布。**随着
-以太坊的快速变化，本文档不可能是最新的，所以你应该关注最新的的 solidity 聊天室和以太网博客。 
+以太坊的快速变化，本文档不可能是最新的，所以你应该关注最新的的 solidity 聊天室和以太网博客。
 照搬这里的代码，会存在重大错误或弃用代码模式的风险。（说人话--别照抄例子中的代码）**
 
 与其他代码不同，可能还需要添加如暂停、弃用和限制使用的设计模式，来降低风险。本文档主要讨论语法，
@@ -50,7 +51,7 @@ contract SimpleBank { // 单词首字母大写
     // 声明函数外的状态变量，合约生命周期内可用
 
     // 地址映射到余额的字典，总是要小心数字的溢出攻击
-    mapping (address => uint) private balances;    
+    mapping (address => uint) private balances;
 
     // "private" 的意思是其他合约不能直接查询余额，但对于区块链上的其他方来说，数据仍然是可见的。
 
@@ -67,7 +68,7 @@ contract SimpleBank { // 单词首字母大写
         owner = msg.sender;
     }
 
-    /// @notice 存款 ether (以太币) 
+    /// @notice 存款 ether (以太币)
     /// @return 存款后用户的余额
     function deposit() public payable returns (uint) {
         // 使用 'require' 来检测用户的输入，'assert' 是内部常量
@@ -159,7 +160,7 @@ address public owner;
 owner.transfer(SOME_BALANCE); // 失败后还原
 
 // 还可以调用较低级别的 .send ， 转账失败会返回 false
-if (owner.send) {} 
+if (owner.send) {}
 // 记住：用 'if' 包着 send 函数，因为合约地址执行这些函数转账时，可能会失败
 // 另外，确保转账前先减掉余额，因为存在递归调用的风险。
 
@@ -174,7 +175,7 @@ bytes32 c;
 
 // 动态大小的字符
 bytes m; // 特殊的数组，等同于 byte[]，比 byte1 到 byte32 更贵
-// 尽可能不用 bytes 
+// 尽可能不用 bytes
 
 // 等同于 bytes，但不允许长度或索引的访问
 string n = "hello"; // UTF8存储，注意双引号而不是单引号
@@ -212,12 +213,12 @@ names.length; // 获得数组长度
 names.length = 1; // 可以设定长度（仅针对 storage 中的动态数组）
 
 // 多维数组
-uint x[][5]; // 5个动态数组元素的数组(和多数语言的顺序相反) 
+uint x[][5]; // 5个动态数组元素的数组(和多数语言的顺序相反)
 
 // 字典类型 (任一类型到其他类型的映射)
 mapping (string => uint) public balances;
 balances["charles"] = 1;
-console.log(balances["ada"]); // 所有没有设定key值的，返回0
+// balances["ada"]得到 0, 所有没有设定key值的，返回0
 // 'public' 允许跟着（调用）另一份合约
 contractName.balances("charles"); // returns 1
 // 'public' 创建 getter （而不是 setter ）如下：
@@ -248,13 +249,13 @@ Bank c = Bank(msg.sender, 5);
 
 c.balance = 5; // 设为新值
 delete b;
-// 设为初始值，结构内所有变量设为0，除了 mapping 
+// 设为初始值，结构内所有变量设为0，除了 mapping
 
 // 枚举
 enum State { Created, Locked, Inactive }; // 常常作为状态机
 State public state; // 声明枚举变量
 state = State.Created;
-// 枚举类型可以显性化的转换为 ints 
+// 枚举类型可以显性化的转换为 ints
 uint createdState = uint(State.Created); //  0
 
 // 数据位置：内存（Memory） vs. 存储（storage） vs. 调用数据（calldata）
@@ -286,7 +287,7 @@ msg.gas; // 剩余 gas
 
 // ** tx - 交易信息 **
 tx.origin; // 本次交易的发送者地址
-tx.gasprice; // 本次交易的 gas price 
+tx.gasprice; // 本次交易的 gas price
 
 // ** block - 当前区块信息 **
 now; // 当前时间（大概）block.timestamp的别名 (采用的 Unix 时间)
@@ -373,17 +374,22 @@ event LogSent(address indexed from, address indexed to, uint amount); // 注意
 // 调用
 LogSent(from, to, amount);
 
-// 对于外部方（合约或外部实体），使用 Web3 Javascript 库来监听
-Coin.LogSent().watch({}, '', function(error, result) {
-    if (!error) {
-        console.log("Coin transfer: " + result.args.amount +
-            " coins were sent from " + result.args.from +
-            " to " + result.args.to + ".");
-        console.log("Balances now:\n" +
-            "Sender: " + Coin.balances.call(result.args.from) +
-            "Receiver: " + Coin.balances.call(result.args.to));
+/*
+    // 对于外部方（合约或外部实体），使用 Web3 Javascript 库来监听
+    // 以下是javascript代码,不是solidity代码
+    Coin.LogSent().watch({}, '', function(error, result) {
+        if (!error) {
+            console.log("Coin transfer: " + result.args.amount +
+                " coins were sent from " + result.args.from +
+                " to " + result.args.to + ".");
+            console.log("Balances now:\n" +
+                "Sender: " + Coin.balances.call(result.args.from) +
+                "Receiver: " + Coin.balances.call(result.args.to));
+        }
     }
-}
+
+*/
+
 // 一个合约依赖另一个合约的共同范例（例如，合约取决于另一个合约提供的当前汇率）
 
 // C. 修饰器
@@ -416,13 +422,13 @@ modifier checkValue(uint amount) {
 
 // 6. 判断和循环
 
-// 所有基本的逻辑判断都有效 - 包括 if else, for, while, break, continue 
+// 所有基本的逻辑判断都有效 - 包括 if else, for, while, break, continue
 // return - 但不跳转
 
 // 语法同 javascript, 但没有从非布尔值到布尔值的类型转换
 // (必须使用比较操作符获得布尔变量值)
 
-// 请注意由用户行为决定的循环 - 因为合约对于代码块具有最大量的 gas 限制 - 
+// 请注意由用户行为决定的循环 - 因为合约对于代码块具有最大量的 gas 限制 -
 // 如果超过限制该代码则将失败
 // 例如：
 for(uint x = 0; x < refundAddressList.length; x++) {
@@ -514,7 +520,7 @@ function remove() {
 // 步骤: 1. 承诺某事, 2. 揭示承诺
 keccak256("some_bid_amount", "some secret"); // commit
 
-// 以后调用合约的 reveal 函数，展示出用 SHA3 哈希的 bid 加 secret 
+// 以后调用合约的 reveal 函数，展示出用 SHA3 哈希的 bid 加 secret
 reveal(100, "mySecret");
 
 // B. 存储优化
@@ -571,7 +577,7 @@ contract SomeOracle {
 // addSubscriber 添加订阅者
 
 // F. 状态机
-// 参见如下的例子，枚举类型的 State 和 修饰器 inState 
+// 参见如下的例子，枚举类型的 State 和 修饰器 inState
 
 
 // *** 例子: 众筹的例子（与 Kickstarter 大致相似）***
@@ -714,7 +720,7 @@ contract CrowdFunder {
 // 10. 其他原生的函数
 
 // 货币单位
-// 货币使用 wei 来定义，以太币的最小单位 = 1 wei; 
+// 货币使用 wei 来定义，以太币的最小单位 = 1 wei;
 uint minAmount = 1 wei;
 uint a = 1 finney; // 1 ether == 1000 finney
 // 其他单位，请参阅: http://ether.fund/tool/converter
@@ -814,6 +820,6 @@ someContractAddress.callcode('function_name');
 - 常见设计模式列表 (throttling, RNG, version upgrade)
 - 常见的安全反模式
 
-请随意发送 pull request 或者发邮件给作者  nemild -/at-/ gmail 
+请随意发送 pull request 或者发邮件给作者  nemild -/at-/ gmail
 
 或者发邮件给译者 jiangxb -/at-/ gmail.com