[incubator-echarts-doc] branch doc-revise created (now 91057cd)

[wa...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wangdd pushed a change to branch doc-revise
in repository https://gitbox.apache.org/repos/asf/incubator-echarts-doc.git.


      at 91057cd  fix: option/title、option/texe-style of doc

This branch includes the following new commits:

     new 91057cd  fix: option/title、option/texe-style of doc

The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@echarts.apache.org
For additional commands, e-mail: commits-help@echarts.apache.org

[incubator-echarts-doc] 01/01: fix: option/title、option/texe-style of doc

[wa...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

wangdd pushed a commit to branch doc-revise
in repository https://gitbox.apache.org/repos/asf/incubator-echarts-doc.git

commit 91057cd2465b91ea282c541608c8d1f9409da231
Author: Wdingding <wa...@gmail.com>
AuthorDate: Wed Nov 6 14:38:16 2019 +0800

    fix: option/title、option/texe-style of doc
---
 zh/option/component/title.md    |  42 ++++++++--------
 zh/option/partial/text-style.md | 103 ++++++++++++++++++++--------------------
 2 files changed, 75 insertions(+), 70 deletions(-)

diff --git a/zh/option/component/title.md b/zh/option/component/title.md
index c9c34ac..ce4dbf3 100644
--- a/zh/option/component/title.md
+++ b/zh/option/component/title.md
@@ -4,36 +4,35 @@
 
 # title(Object)
 
-标题组件，包含主标题和副标题。
+图表的标题组件，包含主标题和副标题。
 
-在 ECharts 2.x 中单个 ECharts 实例最多只能拥有一个标题组件。但是在 ECharts 3 中可以存在任意多个标题组件，这在需要标题进行排版，或者单个实例中的多个图表都需要标题时会比较有用。
+在 ECharts 中可以使用任意多个标题组件。在需要对标题进行排版，或者单个实例中的多个图表都需要使用标题时都会比较有用。（注意，在 ECharts 2.x 中，单个 ECharts 实例中最多只能有一个标题组件。）
 
-**例如下面不同缓动函数效果的示例，每一个缓动效果图都带有一个标题组件：**
+例如，在下面不同缓动函数效果的示例中，每一个缓动效果的图表都带有一个标题组件：
 ~[700x400](${galleryViewPath}line-easing&edit=1&reset=1)
 
 {{use: partial-component-id(prefix="#")}}
 
 ## show(boolean) = true
 
-是否显示标题组件。
+是否显示标题组件。默认为显示，若不想显示标题可将 show 设为 false。
 
 ## text(string) = ''
 
-主标题文本，支持使用 `\n` 换行。
+主标题文本。文本支持使用 `\n` 换行。
 
 ## link(string) = ''
 
-主标题文本超链接。
+主标题文本的超链接。
 
 ## target(string) = 'blank'
 
-指定窗口打开主标题超链接。
+指定在哪个窗口打开主标题文本的超链接。
 
 **可选：**
 
-+ `'self'` 当前窗口打开
-
-+ `'blank'` 新窗口打开
++ `'self'` 使用当前窗口打开链接。
++ `'blank'` 在新窗口中打开链接。
 
 ## textStyle
 
@@ -56,16 +55,17 @@
 
 ## sublink(string) = ''
 
-副标题文本超链接。
+副标题文本的超链接。
 
 
 ## subtarget(string) = 'blank'
 
-指定窗口打开副标题超链接，可选：
+指定在哪个窗口打开副标题文本的超链接。
 
-+ `'self'` 当前窗口打开
+**可选：**
 
-+ `'blank'` 新窗口打开
++ `'self'` 使用当前窗口打开链接。
++ `'blank'` 在新窗口中打开链接。
 
 
 ## subtextStyle
@@ -80,15 +80,19 @@
 
 ## textAlign(string) = 'auto'
 
-整体（包括 text 和 subtext）的水平对齐。
+整体文本（包括 text 和 subtext）水平对齐。
+
+**可选：**
 
-可选值：`'auto'`、`'left'`、`'right'`、`'center'`。
+`'auto'`、`'left'`、`'right'`、`'center'`。
 
 ## textVerticalAlign(string) = 'auto'
 
-整体（包括 text 和 subtext）的垂直对齐。
+整体文本（包括 text 和 subtext）垂直对齐。
+
+**可选：**
 
-可选值：`'auto'`、`'top'`、`'bottom'`、`'middle'`。
+`'auto'`、`'top'`、`'bottom'`、`'middle'`。
 
 ## triggerEvent(boolean) = false
 
@@ -100,7 +104,7 @@
 
 ## itemGap(number) = 10
 
-主副标题之间的间距。
+主标题和副标题之间的间距。
 
 {{use: partial-rect-layout(componentName="grid ")}}
 
diff --git a/zh/option/partial/text-style.md b/zh/option/partial/text-style.md
index c6d02d2..d64a1fb 100644
--- a/zh/option/partial/text-style.md
+++ b/zh/option/partial/text-style.md
@@ -96,7 +96,7 @@ label: {
 
 #${prefix} color(Color)=${defaultColor|default('"#fff"')}
 
-${name}文字的颜色。
+${name}文本的颜色。
 
 
 {{if: ${enableAutoColor} }}
@@ -106,46 +106,46 @@ ${name}文字的颜色。
 
 #${prefix} fontStyle(string)='normal'
 
-${name}文字字体的风格
+${name}文本字体的样式。
 
 可选：
-+ `'normal'`
-+ `'italic'`
-+ `'oblique'`
++ `'normal'` 正常的字体。
++ `'italic'` 斜体，如果当前字体无可用的斜体版本，会选用倾斜体 (oblique) 替代。
++ `'oblique'` 倾斜体，如果当前字体无可用的斜体版本，会选用斜体 (italic) 替代。
 
 
 #${prefix} fontWeight(string)=${defaultFontWeight|default('normal')}
 
-${name}文字字体的粗细
+${name}字体的粗细。
 
-可选：
-+ `'normal'`
-+ `'bold'`
-+ `'bolder'`
-+ `'lighter'`
-+ 100 | 200 | 300 | 400...
+**可选：**
++ `'normal'` 默认值。正常粗细的字体。与 400 等值。
++ `'bold'` 加粗的字体。与 700 等值。
++ `'bolder'` 比正常字体更粗。
++ `'lighter'` 比正常字体更细。
++ 100 | 200 | 300 | 400... 更大的数值代表更粗的字体重量。400 等同于 normal 正常粗细。
 
 
 #${prefix} fontFamily(string)='sans-serif'
 
-${name}文字的字体系列
+${name}文本的字体系列。
 
 还可以是 'serif' , 'monospace', 'Arial', 'Courier New', 'Microsoft YaHei', ...
 
 #${prefix} fontSize(number)=${defaultFontSize|default(12)}
 
-${name}文字的字体大小
+${name}文本的字体大小
 
 
  {{ if: !${noAlign} }}
 #${prefix} align(string)=${defaultAlign}
 
-文字水平对齐方式，默认自动。
+文本的水平的对齐方式，默认为自动。
 
-可选：
-+ `'left'`
-+ `'center'`
-+ `'right'`
+**可选：**
++ `'left'` 文本在其左边缘对齐。
++ `'center'` 文本水平居中。
++ `'right'` 文本在其右边缘对齐。
 
 {{ use: partial-text-style-rich-inherit(
     name='align',
@@ -157,12 +157,12 @@ ${name}文字的字体大小
 {{ if: !${noVerticalAlign} }}
 #${prefix} verticalAlign(string)=${defaultVerticalAlign}
 
-文字垂直对齐方式，默认自动。
+文本的垂直的对齐方式，默认为自动。
 
-可选：
-+ `'top'`
-+ `'middle'`
-+ `'bottom'`
+**可选：**
++ `'top'` 文本在其顶部边缘对齐。
++ `'middle'` 文本垂直居中。
++ `'bottom'` 文本在其底部边缘对齐。
 
 {{ use: partial-text-style-rich-inherit(
     name='verticalAlign',
@@ -175,7 +175,7 @@ ${name}文字的字体大小
 
 #${prefix} lineHeight(number)
 
-行高。
+多行文本的行高间距。
 
 {{ use: partial-text-style-rich-inherit(
     name='lineHeight',
@@ -186,11 +186,11 @@ ${name}文字的字体大小
 
 #${prefix} backgroundColor(string|Object)='transparent'
 
-文字块背景色。
+文本的背景色。
 
-可以是直接的颜色值，例如：`'#123234'`, `'red'`, `'rgba(0,23,11,0.3)'`。
+属性的值可以为颜色值，例如：`'#123234'`, `'red'`, `'rgba(0,23,11,0.3)'`。
 
-可以支持使用图片，例如：
+也支持使用图片作为背景，例如：
 
 ```js
 backgroundColor: {
@@ -202,7 +202,7 @@ backgroundColor: {
 }
 ```
 
-当使用图片的时候，可以使用 `width` 或 `height` 指定高宽，也可以不指定自适应。
+当使用图片时，可以用 `width` 或 `height` 来指定背景图片的高、宽。如果不指定，图片则会自适应。
 
 {{if: ${enableAutoColor} }}
 {{ use: partial-text-style-auto-color-desc }}
@@ -210,7 +210,7 @@ backgroundColor: {
 
 #${prefix} borderColor(string)='transparent'
 
-文字块边框颜色。
+文字块的边框颜色。
 
 {{if: ${enableAutoColor} }}
 {{ use: partial-text-style-auto-color-desc }}
@@ -218,7 +218,7 @@ backgroundColor: {
 
 #${prefix} borderWidth(number)=0
 
-文字块边框宽度。
+文字块的边框宽度。
 
 #${prefix} borderRadius(number|Array)=0
 
@@ -226,54 +226,55 @@ backgroundColor: {
 
 #${prefix} padding(number|Array)=0
 
-文字块的内边距。例如：
+文字块的内边距。
 
+**例如：**
 + `padding: [3, 4, 5, 6]`：表示 `[上, 右, 下, 左]` 的边距。
-+ `padding: 4`：表示 `padding: [4, 4, 4, 4]`。
-+ `padding: [3, 4]`：表示 `padding: [3, 4, 3, 4]`。
++ `padding: 4`：表示 `padding: [4, 4, 4, 4]`，即四个边的内边距都为 4。
++ `padding: [3, 4]`：表示 `padding: [3, 4, 3, 4]`，即第一个值为上下两边的内边距，第二个值为左右两边的内边距。
 
-注意，文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
+**注意：**文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
 
 #${prefix} shadowColor(string)='transparent'
 
-文字块的背景阴影颜色。
+文字块阴影的颜色。
 
 #${prefix} shadowBlur(number)=0
 
-文字块的背景阴影长度。
+文字块阴影的长度。
 
 #${prefix} shadowOffsetX(number)=0
 
-文字块的背景阴影 X 偏移。
+文字块阴影在 X （水平）方向的偏移量。
 
 #${prefix} shadowOffsetY(number)=0
 
-文字块的背景阴影 Y 偏移。
+文字块阴影在 Y （垂直）方向的偏移量。
 
 {{ /if }}
 
 
 #${prefix} width(number|string)
 
-文字块的宽度。一般不用指定，不指定则自动是文字的宽度。在想做表格项或者使用图片（参见 `backgroundColor`）时，可能会使用它。
+文字块的宽度。一般不用指定，自动显示为文字的宽度。在需要表格项或者使用图片（参见 `backgroundColor`）时，可能会使用指定它。
 
-注意，文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
+**注意：**文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
 
-`width` 也可以是百分比字符串，如 `'100%'`。表示的是所在文本块的 `contentWidth`（即不包含文本块的 `padding`）的百分之多少。之所以以 `contentWidth` 做基数，因为每个文本片段只能基于 `content box` 布局。如果以 `outerWidth` 做基数，则百分比的计算在实用中不具有意义，可能会超出。
+`width` 也可以是百分比字符串，如 `'100%'`。表示的是所在文本块的 `contentWidth`（即不包含文本块的 `padding`）的百分之多少。之所以用 `contentWidth` 做基数，因为每个文本片段只能基于 `content box` 布局。如果以 `outerWidth` 做基数，则百分比的计算在实用中不具有意义，可能会超出。
 
-注意，如果不定义 `rich` 属性，则不能指定 `width` 和 `height`。
+**注意：**如果不定义 `rich` 属性，则不能指定 `width` 和 `height`。
 
 #${prefix} height(number|string)
 
 文字块的高度。一般不用指定，不指定则自动是文字的高度。在使用图片（参见 `backgroundColor`）时，可能会使用它。
 
-注意，文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
+**注意：**文字块的 `width` 和 `height` 指定的是内容高宽，不包含 `padding`。
 
-注意，如果不定义 `rich` 属性，则不能指定 `width` 和 `height`。
+**注意：**如果不定义 `rich` 属性，则不能指定 `width` 和 `height`。
 
 #${prefix} textBorderColor(string)='transparent'
 
-文字本身的描边颜色。
+文字描边的颜色。
 
 {{if: ${enableAutoColor} }}
 {{ use: partial-text-style-auto-color-desc }}
@@ -281,23 +282,23 @@ backgroundColor: {
 
 #${prefix} textBorderWidth(number)=0
 
-文字本身的描边宽度。
+文字描边的宽度。
 
 #${prefix} textShadowColor(string)='transparent'
 
-文字本身的阴影颜色。
+文字阴影的颜色。
 
 #${prefix} textShadowBlur(number)=0
 
-文字本身的阴影长度。
+文字阴影的长度。
 
 #${prefix} textShadowOffsetX(number)=0
 
-文字本身的阴影 X 偏移。
+文字阴影在 X （水平）方向的偏移量。
 
 #${prefix} textShadowOffsetY(number)=0
 
-文字本身的阴影 Y 偏移。
+文字阴影在 Y （垂直）方向的偏移量。
 
 
 


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@echarts.apache.org
For additional commands, e-mail: commits-help@echarts.apache.org