commit | a03a2fee56a9c147929e42df604e98563c5a933e | [log] [tgz] |
---|---|---|
author | pissang <bm2736892@gmail.com> | Tue Jan 12 16:22:13 2021 +0800 |
committer | pissang <bm2736892@gmail.com> | Tue Jan 12 16:22:13 2021 +0800 |
tree | 26a3d281917dc117de2f895975883c9c7c2373b4 | |
parent | 58c2a98ad5727e924ef23d3a1e674c0e1e3cddba [diff] |
fix tutorial entry
Do not need other project.
npm run dev
It will:
For example: Embed a example in doc:
~[700x300](${galleryViewPath}doc-example/aria-pie&edit=1&reset=1)
Provide a example link in doc:
[vertically scrollable legend](${galleryEditorPath}pie-legend&edit=1&reset=1)
Provide a website link in doc:
[Apache ECharts (incubating) website](${websitePath}/en/download.html)
A ~
can be used to refer to a option item in the same doc. For example:
[xAxis.name](~xAxis.name)
If intending to reference an anchor in different doc, it can be:
[itemStyle](option.html#series.itemStyle)
// Good Some description {{ use: partial-xxx }} Some other description // Bad Some description about {{ use: partial-inline-xxx }}
// Good {{ if: ${prefix} !== '#' }} 表示同一层级的节点的颜色饱和度 选取范围。 {{ else }} 本系列默认的节点的颜色饱和度 选取范围。 {{ /if }} 数值范围 0 ~ 1。 // Bad {{ if: ${prefix} !== '#' }}表示同一层级的节点的{{ else }}本系列默认的{{ /if }} 颜色饱和度 选取范围。数值范围 0 ~ 1。 // Good {{ if: ${prefix} !== '#' }} It indicates the range of saturation (color alpha) for nodes in a level. {{ else }} It indicates the range of saturation (color alpha) for nodes of the series. {{ /if }} The range of values is 0 ~ 1. // Bad It indicates the range of saturation (color alpha) {{ if: ${prefix} !== '#' }}for nodes in a level {{ else }} of the series{{ /if }}. The range of values is 0 ~ 1.
Option docs needs to be formatted before commit.
Run
npm run format
Make sure have a double review on the git diff after formatted.
After you finished editing doc of one language. You can use following script to sync it to another language.
# zh to en node tool/patchLanguage --from=zh --to=en # en to zh node tool/patchLanguage --from=en --to=zh
Sync will move the structure. It will make editing of other languages much easier.
Again make sure have a double review on the git diff after syncing.