diff --git a/contributing.md b/contributing.md index 73a05ee7..066d53fa 100644 --- a/contributing.md +++ b/contributing.md @@ -69,3 +69,21 @@ Pull requestをすることはその変化分のコードの著作権をMaisin&C これはいずれかBoostnoteが有料の商用アプリになる可能性がある話ではありません。 もし、このアプリケーションに料金が発生する時は、Boostnote専用のCloud storageの提供やMobile appとの連動、何か特殊なプレミアム機能の提供など形になります。 現在考えられているのは、GPL v3の場合、他のライセンスとの互換が不可能であるため、もしより自由なLicense(BSD, MIT)に変える時に改めて著作権者としてライセンスし直す選択肢を残すイメージです。 + +--- + +# Contributing to Boostnote (Simplified Chinese) + +### 当您创建一个issue的时候 +我们对您的issue格式没有要求,但是我们有一个请求: + +**如果可能,请在开发者模式打开的情况下,为我们提供屏幕截图** + +(您可以通过`Ctrl+Shift+I`打开开发者模式)。 +感谢您对我们的支持。 + +### 关于您提供的Pull Request的著作权(版权)问题 +如果您提供了一个Pull Request,这表示您将您所修改的代码的著作权移交给Maisin&Co。 + +这并不表示Boostnote会成为一个需要付费的软件。如果我们想获得收益,我们会尝试一些其他的方法,比如说云存储、绑定手机软件等。 +因为GPLv3过于严格,不能和其他的一些协议兼容,所以我们有可能在将来会把BoostNote的协议改为一些较为宽松的协议,比如说BSD、MIT。 diff --git a/docs/build.md b/docs/build.md index f10d61a5..10b681c6 100644 --- a/docs/build.md +++ b/docs/build.md @@ -1,4 +1,5 @@ # Build +This page is also available in [Japanese](https://github.com/BoostIO/Boostnote/blob/master/docs/jp/build.md), [Korean](https://github.com/BoostIO/Boostnote/blob/master/docs/ko/build.md), [Russain](https://github.com/BoostIO/Boostnote/blob/master/docs/ru/build.md), and [Simplified Chinese](https://github.com/BoostIO/Boostnote/blob/master/docs/zh_CN/build.md). ## Environments * npm: 4.x diff --git a/docs/debug.md b/docs/debug.md index ce1e1226..297782dc 100644 --- a/docs/debug.md +++ b/docs/debug.md @@ -1,4 +1,6 @@ # How to debug Boostnote (Electron app) +This page is also available in [Japanese](https://github.com/BoostIO/Boostnote/blob/master/docs/jp/debug.md), [Russain](https://github.com/BoostIO/Boostnote/blob/master/docs/ru/debug.md), and [Simplified Chinese](https://github.com/BoostIO/Boostnote/blob/master/docs/zh_CN/debug.md) + Boostnote is an Electron app so it's based on Chromium; developers can use `Developer Tools` just like Google Chrome. You can toggle the `Developer Tools` like this: diff --git a/docs/zh_CN/build.md b/docs/zh_CN/build.md new file mode 100644 index 00000000..5e3bcc5e --- /dev/null +++ b/docs/zh_CN/build.md @@ -0,0 +1,56 @@ +# 构建Boostnote + +## 环境 +* npm: 4.x +* node: 7.x + +因为`$ grand pre-build`的问题,您只能使用`npm v4.x`而不能使用`npm v5.x`。 + +## 开发 + +我们使用Webpack HMR来开发Boostnote。 +在代码根目录下运行下列指令可以以默认配置运行Boostnote。 + +### 首先使用yarn安装所需的依赖包。 + +``` +$ yarn +``` + +### 接着编译并且运行Boostnote。 + +``` +$ yarn run dev-start +``` + +这个指令相当于在两个终端内同时运行`yarn run webpack`和`yarn run hot`。 + +如果出现错误`Failed to load resource: net::ERR_CONNECTION_REFUSED`,请尝试重新运行Boostnote。 +![net::ERR_CONNECTION_REFUSED](https://cloud.githubusercontent.com/assets/11307908/24343004/081e66ae-1279-11e7-8d9e-7f478043d835.png) + +### 然后您就可以进行开发了 + +当您对代码作出更改的时候,`webpack`会自动抓取并应用所有代码更改。 + +> ### 提示 +> 在如下情况中,您可能需要重新运行Boostnote才能应用代码更改 +> 1. 当您在修改了一个组件的构造函数的时候When editing a constructor method of a component +> 2. 当您新建了一个CSS类的时候(其实这和第1项是相同的,因为每个CSS类都需在组件的构造函数中被重写) + +## 部署 + +我们使用Grunt来自动部署Boostnote。 +因为部署需要协同设计(codesign)与验证码(authenticode),所以您可以但我们不建议通过`grunt`来部署。 +所以我们准备了一个脚本文件来生成执行文件。 + +``` +grunt pre-build +``` + +您只能使用`npm v5.2.0`而不能使用`npm v5.3.0`。 + +接下来您就可以在`dist`目录中找到可执行文件。 + +> ### 提示 +> 因为此可执行文件并没有被注册,所以自动更新不可用。 +> 如果需要,您也可将协同设计(codesign)与验证码(authenticode)使用于这个可执行文件中。 diff --git a/docs/zh_CN/debug.md b/docs/zh_CN/debug.md new file mode 100644 index 00000000..5f44ecd8 --- /dev/null +++ b/docs/zh_CN/debug.md @@ -0,0 +1,15 @@ +# 在Boostnote上Debug + +Boostnote基于Electron,所以Boostnote上的开发者工具和Google Chrome相同。 + +您可以像这样或者按下快捷键`Ctrl+Shift+I`打开开发者工具: +![how_to_toggle_devTools](https://cloud.githubusercontent.com/assets/11307908/24343585/162187e2-127c-11e7-9c01-23578db03ecf.png) + +开发者工具大概形如这样: +![Developer_Tools](https://cloud.githubusercontent.com/assets/11307908/24343545/eff9f3a6-127b-11e7-94cf-cb67bfda634a.png) + +您可以在`console`选项卡中找到运行错误, +也可以像这样在`debugger`选项卡中设置断点去分步Debug: +![debugger](https://cloud.githubusercontent.com/assets/11307908/24343879/9459efea-127d-11e7-9943-f60bf7f66d4a.png) + +关于具体如何使用开发者工具,详见[Chrome 官档](https://developer.chrome.com/devtools)。(如果您在中国大陆,您可能需要一个VPN才能正常访问)