Skip to content

Commit

Permalink
Fine-tune translation III
Browse files Browse the repository at this point in the history
  • Loading branch information
Edit-Mr committed Jun 4, 2024
1 parent d82f3fe commit 8ef920c
Show file tree
Hide file tree
Showing 26 changed files with 101 additions and 109 deletions.
16 changes: 8 additions & 8 deletions src/zh-Hant/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,32 +6,32 @@ layout: default

# API

我們提供了一個廣泛的 JavaScript API 來控制導航和檢查簡報的當前狀態。如果你正在編輯單份簡報,可以通過全域對象 `Reveal` 來訪問 API。
我們提供了一個廣泛的 JavaScript API 來控制導覽和檢查簡報的當前狀態。如果你正在編輯單份簡報,可以通過全域對象 `Reveal` 來訪問 API。

### 導航
### 導覽

```javascript
// 導航到指定幻燈片
// 導覽到指定幻燈片
Reveal.slide(indexh, indexv, indexf);

// 相對導航
// 相對導覽
Reveal.left();
Reveal.right();
Reveal.up();
Reveal.down();
Reveal.prev();
Reveal.next();

// 片段導航
// 片段導覽
Reveal.navigateFragment(indexf); // (-1 表示隱藏所有片段)
Reveal.prevFragment();
Reveal.nextFragment();

// 檢查我們可以向哪些方向導航
// 檢查我們可以向哪些方向導覽
// {top: false, right: true, bottom: false, left: false}
Reveal.availableRoutes();

// 檢查我們可以向哪些片段方向導航
// 檢查我們可以向哪些片段方向導覽
// {prev: false, next: true}
Reveal.availableFragments();
```
Expand Down Expand Up @@ -110,7 +110,7 @@ Reveal.getSlides();
Reveal.hasHorizontalSlides();
Reveal.hasVerticalSlides();

// 檢查套件是否至少在任一軸上導航過一次
// 檢查套件是否至少在任一軸上導覽過一次
Reveal.hasNavig;

atedHorizontally();
Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/auto-animate.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ reveal.js 可以自動在幻燈片之間添加動畫。你只需在兩個相鄰

## 元素如何匹配

當你在兩個自動動畫幻燈片之間導航時,我們將盡力自動找到兩個幻燈片中的匹配元素。對於文本,如果文本內容和節點類型都相同,我們將其視為匹配。對於圖片、視頻和 iframes,我們比較 `src` 屬性。除此以外我們還會考慮元素在 DOM 中出現的順序。
當你在兩個自動動畫幻燈片之間導覽時,我們將盡力自動找到兩個幻燈片中的匹配元素。對於文本,如果文本內容和節點類型都相同,我們將其視為匹配。對於圖片、視頻和 iframes,我們比較 `src` 屬性。除此以外我們還會考慮元素在 DOM 中出現的順序。

在無法自動匹配的情況下,你可以給你想要動畫之間的對象添加匹配的 `data-id` 屬性。我們優先匹配 `data-id` 值而不是自動匹配。

Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/auto-slide.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Reveal.initialize({

`autoSlideMethod` 屬性可以更改自動撥放的方向。

我們預設將按順序播放所有幻燈片,包括水平和[垂直](/zh-hant/vertical-slides/)幻燈片。如果你只想沿頂層導航並忽略垂直幻燈片,你可以提供一個調用 `Reveal.right()` 的函式。
我們預設將按順序播放所有幻燈片,包括水平和[垂直](/zh-hant/vertical-slides/)幻燈片。如果你只想沿頂層導覽並忽略垂直幻燈片,你可以提供一個調用 `Reveal.right()` 的函式。

```js
Reveal.configure({
Expand Down
20 changes: 10 additions & 10 deletions src/zh-Hant/config.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Reveal.initialize({
// 決定控制出現的位置,"edges" 或 "bottom-right"
controlsLayout: 'bottom-right',

// 向後導航箭頭的可見性規則;"faded", "hidden" 或 "visible"
// 向後導覽箭頭的可見性規則;"faded", "hidden" 或 "visible"
controlsBackArrows: 'faded',

// 顯示簡報進度條
Expand Down Expand Up @@ -58,13 +58,13 @@ Reveal.initialize({
// 標記是否應監控哈希並相應地更改幻燈片
respondToHashChanges: true,

// 啟用跳轉到幻燈片的導航快捷鍵
// 啟用跳轉到幻燈片的導覽快捷鍵
jumpToSlide: true,

// 將每次幻燈片更改推送到瀏覽器歷史記錄。意味著 `hash: true`
history: false,

// 啟用用於導航的鍵盤快捷
// 啟用用於導覽的鍵盤快捷

keyboard: true,
Expand All @@ -84,7 +84,7 @@ Reveal.initialize({
// 幻燈片的垂直居中
center: true,

// 啟用具有觸控輸入的設備上的觸控導航
// 啟用具有觸控輸入的設備上的觸控導覽
touch: true,

// 循環播放簡報
Expand All @@ -93,7 +93,7 @@ Reveal.initialize({
// 將簡報方向更改為從右到左
rtl: false,

// 更改我們的導航方向的行為
// 更改我們的導覽方向的行為
//
// "default"
// 左/右箭頭鍵在水平幻燈片之間步進,上/下箭頭鍵在垂直幻燈片之間步進。空格鍵步進
Expand All @@ -111,7 +111,7 @@ Reveal.initialize({
// 1.2 2.2
// 1.3 2.3
//
// 如果你在幻燈片 1.3 上並向右導航,你通常會從 1.3 -> 2.1。如果使用 "grid",相同的導航將帶你
// 如果你在幻燈片 1.3 上並向右導覽,你通常會從 1.3 -> 2.1。如果使用 "grid",相同的導覽將帶你
// 從 1.3 -> 2.3。
navigationMode: 'default',

Expand Down Expand Up @@ -190,13 +190,13 @@ Reveal.initialize({
// 用戶輸入後停止自動播放
autoSlideStoppable: true,

// 自動播放時用於導航的函式(默認為 navigateNext)
// 自動播放時用於導覽的函式(默認為 navigateNext)
autoSlideMethod: null,

// 指定你認為你將花在每張幻燈片上的平均時間(秒)。這用於在演講者視圖中顯示配速計時器
defaultTiming: null,

// 啟用通過鼠標滾輪進行幻燈片導航
// 啟用通過鼠標滾輪進行幻燈片導覽
mouseWheel: false,

// 在 iframe 預覽覆蓋層中打開鏈接
Expand All @@ -208,7 +208,7 @@ Reveal.initialize({

postMessage: true,

// 通過 postMessage 將所有 reveal.js 事件派發給父窗口
// 通過 postMessage 將所有 reveal.js 事件派發給父視窗
postMessageEvents: false,

// 當頁面可見性改變時聚焦 body 以確保鍵盤快捷鍵工作
Expand Down Expand Up @@ -240,7 +240,7 @@ Reveal.initialize({
// 離當前幻燈片可見的幻燈片數
viewDistance: 3,

// 在移動設備上離當前幻燈片可見的幻燈片數
// 在行動裝置上離當前幻燈片可見的幻燈片數
// 建議將此數字設置為比 viewDistance 更低的數字以節省資源。
mobileViewDistance: 2,

Expand Down
4 changes: 2 additions & 2 deletions src/zh-Hant/initialization.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# 初始化

最常見的 reveal.js 使用情景是有一個覆蓋整個視口的單一簡報。從 4.0 版本開始,我們也支持在同一頁面上同時運行[多個簡報](#multiple-presentations),以及將庫作為一個[ES 模塊](#es-module)引入。
最常見的 reveal.js 使用情景是有一個覆蓋整個視窗的單一簡報。從 4.0 版本開始,我們也支持在同一頁面上同時運行[多個簡報](#multiple-presentations),以及將庫作為一個[ES 模塊](#es-module)引入。

如果你的頁面上只有一個簡報,我們建議使用全域的 `Reveal` 對象來初始化 reveal.js。`Reveal.initialize` 函式接受一個參數;一個 reveal.js 的[配置對象](/zh-hant/config/)

Expand All @@ -29,7 +29,7 @@ Reveal.initialize().then(() => {

要在同一頁面上並排運行多個簡報,你可以創建叫做 `Reveal` 的 class 的實例。`Reveal` 構造函數接受兩個參數;簡報的 `.reveal` HTML 元素根以及一個可選的[配置對象](/zh-hant/config/)

請注意,你還需要將[嵌入式](/zh-hant/presentation-size/#嵌入式)配置選項設置為真。這個標誌使得簡報按照它們的 `.reveal` 根元素的大小進行自我調整,而不是按照瀏覽器視口。你還需要手動為每個 `.reveal .deck*` 元素定義 `width``height` 的 CSS 屬性,才能看到它們顯示出來。
請注意,你還需要將[嵌入式](/zh-hant/presentation-size/#嵌入式)配置選項設置為真。這個標誌使得簡報按照它們的 `.reveal` 根元素的大小進行自我調整,而不是按照瀏覽器視窗。你還需要手動為每個 `.reveal .deck*` 元素定義 `width``height` 的 CSS 屬性,才能看到它們顯示出來。

默認情況下,reveal.js 會捕獲文檔中的所有鍵盤事件。對於嵌入式簡報,我們建議使用 `keyboardCondition: 'focused'` 初始化,這樣鍵盤事件只有在觀眾聚焦簡報時才會被捕獲。

Expand Down
14 changes: 7 additions & 7 deletions src/zh-Hant/jump-to-slide.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,23 +6,23 @@ layout: default

# 跳轉到幻燈片 <span class="r-version-badge coming">4.5.0</span>

你可以使用 reveal.js 的跳轉到幻燈片快捷鍵直接跳到特定的幻燈片。以下是操作函式
你可以使用 reveal.js 的跳轉到幻燈片快捷鍵直接跳到特定的幻燈片。以下是操作方式

1. 按 G 啟動
2. 輸入幻燈片編號或 id
3. 按 Enter 確認

## 導航到幻燈片編號
## 導覽到幻燈片編號

當跳轉到一個幻燈片時,你可以輸入數字值或字符串。如果你提供一個數字,reveal.js 將導航到所需的幻燈片編號。如果你輸入一個字符串,reveal.js 將嘗試定位一個具有匹配 `id` 的幻燈片並導航到它
當跳轉到一個幻燈片時,你可以輸入數字值或字符串。如果你提供一個數字,reveal.js 將導覽到所需的幻燈片編號。如果你輸入一個字符串,reveal.js 將嘗試定位一個具有匹配 `id` 的幻燈片並導覽到它

這裡有一些不同輸入及其導航結果的範例
這裡有一些不同輸入及其導覽結果的範例

| 輸入 | 結果 |
| :------ | :--------------------------------------------------- |
| 5 | 導航到幻燈片編號 5 |
| 6/2 | 導航到水平幻燈片 6,垂直幻燈片 2 |
| the-end | 導航到具有此 id 的幻燈片(`<section id="the-end">`|
| 5 | 導覽到幻燈片編號 5 |
| 6/2 | 導覽到水平幻燈片 6,垂直幻燈片 2 |
| the-end | 導覽到具有此 id 的幻燈片(`<section id="the-end">`|

{.key-value}

Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/layout.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# 布局

我們提供了幾種不同的輔助類,用於控制布局並設計你的內容。我們目標是在即將到來的版本中添加更多這些類,因此請密切關注
我們提供了幾種不同的輔助 class,用於控制布局並設計你的內容。我們目標是在即將到來的版本中添加更多這種 class,因此請保持密切關注

如果你希望更改簡報的尺寸、縮放和居中,請參見[簡報大小](/zh-hant/presentation-size/)

Expand Down
6 changes: 3 additions & 3 deletions src/zh-Hant/links.md
Original file line number Diff line number Diff line change
Expand Up @@ -45,9 +45,9 @@ layout: default
<a href="#/3/2">前往第三張幻燈片中的第二個垂直幻燈片</a>
```

## 導航鏈接
## 導覽鏈接

你可以添加相對導航鏈接,這與內置的方向控制箭頭的工作方式類似。這是通過在 `.reveal` 容器內的任何可點擊 HTML 元素上添加以下類之一來實現的。
你可以添加相對導覽鏈接,這與內置的方向控制箭頭的工作方式類似。這是通過在 `.reveal` 容器內的任何可點擊 HTML 元素上添加以下類之一來實現的。

```html
<button class="navigate-left">左</button>
Expand All @@ -62,4 +62,4 @@ layout: default
<button class="navigate-next">下一個</button>
```

每個導航元素都會自動根據當前幻燈片的導航路線有效性獲得 `enabled` 的 class。例如,如果你在第一張幻燈片上,只有 `navigate-right` 會獲得 `enabled` 的 class,因為向左導航是不可能的。這樣可以直觀的告诉使用者往哪些方向是可行的。
每個導覽元素都會自動根據當前幻燈片的導覽路線有效性獲得 `enabled` 的 class。例如,如果你在第一張幻燈片上,只有 `navigate-right` 會獲得 `enabled` 的 class,因為向左導覽是不可能的。這樣可以直觀的告诉使用者往哪些方向是可行的。
8 changes: 3 additions & 5 deletions src/zh-Hant/markdown.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# Markdown

使用 Markdown 編寫簡報內容不僅可能,而且往往更方便。要創建一個 Markdown 幻燈片,請在你的 `<section>` 元素中添加 `data-markdown` 屬性,並將內容包裹在 `<textarea data-template>` 中,如下例所示。
使用 Markdown 編寫簡報內容不僅可行,而且往往更方便。要創建一個 Markdown 幻燈片,請在你的 `<section>` 元素中添加 `data-markdown` 屬性,並將內容包裹在 `<textarea data-template>` 中,如下例所示。

```html
<section data-markdown>
Expand Down Expand Up @@ -36,7 +36,7 @@ layout: default
</div>
</div>

注意,這對縮進(避免混合使用制表符和空格)和換行(避免連續換行)很敏感。
注意,它對縮進(避免混合使用制表符和空格)和換行(避免連續換行)很敏感。

## Markdown 插件

Expand Down Expand Up @@ -74,9 +74,7 @@ layout: default

## 元素屬性

特殊語法(通過 HTML 註釋)可用於為 Markdown 元素添加屬性。這對於片段等很

有用。
特殊語法(通過 HTML 註釋)可用於為 Markdown 元素添加屬性。這對於片段等很有用。

```html
<section data-markdown>
Expand Down
14 changes: 7 additions & 7 deletions src/zh-Hant/markup.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# 標記

這是一個完全運作的 reveal.js 簡報的基本範例:
這是一個完整的 reveal.js 簡報的基本範例:

```html
<html>
Expand All @@ -31,7 +31,7 @@ layout: default

簡報的標記層次結構需要是 `.reveal > .slides > section`,其中 `section` 元素代表一個幻燈片,可以無限重復。

如果你在另一個 `section` 內放置多個 `section` 元素,它們將被顯示為[垂直幻燈片](/zh-hant/vertical-slides/)。垂直幻燈片的第一個是其他幻燈片的“根”(在頂部),並將包括在水平序列中。例如:
如果你在另一個 `section` 內放置多個 `section` 元素,它們將被顯示為[垂直幻燈片](/zh-hant/vertical-slides/)。垂直幻燈片的第一個是其他幻燈片的「根」(在頂部),並將包括在水平序列中。例如:

```html
<div class="reveal">
Expand All @@ -55,17 +55,17 @@ layout: default
</div>
</div>

同樣可以使用 [Markdown](/zh-hant/markdown/) 編寫簡報
你同樣可以使用 [Markdown](/zh-hant/markdown/) 撰寫簡報

## 視口
## 視窗

reveal.js 的視口是確定簡報在網頁上的大小的包裝器 DOM 元素。默認情況下,這將是 `body` 元素。如果你在同一頁面上包含多個簡報,每個簡報的 `.reveal` 元素將作為它們的視口
reveal.js 的視窗是確定簡報在網頁上的大小的包裝器 DOM 元素。默認情況下,這將是 `body` 元素。如果你在同一頁面上包含多個簡報,每個簡報的 `.reveal` 元素將作為它們的視窗

視口在 reveal.js 初始化時始終帶有 叫做 `reveal-viewport` 的 class 。
視窗在 reveal.js 初始化時始終帶有叫做 `reveal-viewport` 的 class 。

## 幻燈片狀態

如果你在幻燈片 `<section>` 上設置了 `data-state="make-it-pop"`,當該幻燈片打開時,"make-it-pop" 將作為類應用於[視口元素](#viewport)。這允許你根據活動幻燈片對頁面應用廣泛的風格更改
如果你在幻燈片 `<section>` 上設置了 `data-state="make-it-pop"`,當該幻燈片打開時,"make-it-pop" 將作為類應用於[視窗元素](#視窗)。這使得你可以根據幻燈片的狀態應用樣式

```html
<section data-state="make-it-pop"></section>
Expand Down
14 changes: 6 additions & 8 deletions src/zh-Hant/math.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ layout: default

## Markdown

如果你想在 Markdown 寫的簡報中包含數學公式,你需要用反引號將公式包起來。這樣可以避免 LaTeX 和 Markdown 語法之間的衝突。例如:
如果你想在 Markdown 寫的簡報中插入數學公式,你需要用反引號將公式包起來。這樣可以避免 LaTeX 和 Markdown 語法之間的衝突。例如:

```html
<section data-markdown>`$$ J(\theta_0,\theta_1) = \sum_{i=0} $$`</section>
Expand All @@ -62,7 +62,7 @@ layout: default

### KaTeX <span class="r-version-badge new">4.2.0</span>

通过 `katex` 配置對象調整選項。以下是默認的插件配置。如果你不打算更改這些值,則無需包括 `katex` 配置選項。
通過 `katex` 配置對象調整選項。以下是默認的插件配置。如果你不打算更改這些值,則無需添加 `katex` 配置選項。

```js
Reveal.initialize({
Expand All @@ -80,9 +80,7 @@ Reveal.initialize({
});
```

注意,默認情況下最新的 KaTeX 從遠程伺服器

加載(https://cdn.jsdelivr.net/npm/katex)。要使用固定版本,將 `version` 設為例如 `0.13.18`
注意,默認情況下會從外部伺服器取得最新版本的 KaTeX(https://cdn.jsdelivr.net/npm/katex)。要使用固定版本,將 `version` 設為例如 `0.13.18`

如果你想離線使用 KaTeX,你需要下載庫的副本(例如通過 npm)並使用 `local` 配置選項(則 `version` 選項將被忽略),例如:

Expand Down Expand Up @@ -119,7 +117,7 @@ Reveal.initialize({

注意,最新的 MathJax 2 從遠程伺服器加載。要使用固定版本,將 mathjax 設為例如 https://cdn.jsdelivr.net/npm/[email protected]/MathJax.js。

如果你想離線使用 MathJax,你需要下載庫的副本(例如通過 npm)並將 `mathjax` 指向本地副本。
如果你想離線使用 MathJax,你需要下載函式庫的副本(例如通過 npm)並將 `mathjax` 指向本地副本。

### MathJax 3 <span class="r-version-badge new">4.2.0</span>

Expand All @@ -143,6 +141,6 @@ Reveal.initialize({
});
```

注意,最新的 MathJax 3 從遠程伺服器加載。要使用固定版本,將 `mathjax` 設為例如 <https://cdn.jsdelivr.net/npm/[email protected]/es5/tex-mml-chtml.js>。此外,配置現在是 URL 的一部分,默认載入 `tex-mml-chtml`,它能識別 TeX 和 MathML 表示的數學公式,並使用 HTML 和 CSS 生成輸出(CommonHTML 輸出格式)。這是一個非常通用的配置,但這也是他很龐大的原因,因此你可能需要考慮一個更輕量,更符合你需求的配置,例如 `tex-svg`
注意,最新的 MathJax 3 從遠程伺服器加載。要使用固定版本,將 `mathjax` 設為例如 <https://cdn.jsdelivr.net/npm/[email protected]/es5/tex-mml-chtml.js>。此外,配置現在是 URL 的一部分,默認載入 `tex-mml-chtml`,它能識別 TeX 和 MathML 表示的數學公式,並使用 HTML 和 CSS 生成輸出(CommonHTML 輸出格式)。這是一個非常通用的配置,但這也是它很龐大的原因,因此你可能需要考慮一個更輕量,更符合你需求的配置,例如 `tex-svg`

如果你想離線使用 MathJax,你需要下載庫的副本(例如通過 npm)並相應地調整 `mathjax`
如果你想離線使用 MathJax,你需要下載庫的副本(例如通過 npm)並相應地調整 `mathjax`
2 changes: 1 addition & 1 deletion src/zh-Hant/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# 概覽模式

按下「ESC」或「O」鍵來開啟或關閉概覽模式。當你處於這種模式時,你仍然可以在幻燈片之間導航,就像你在你的簡報上方 1000 英尺高的地方一樣
按下「ESC」或「O」鍵來開啟或關閉概覽模式。當你處於這種模式時,你仍然可以在幻燈片之間導覽,就像你在你的簡報上方 1000 公尺高的地方一樣

<picture><img src="/images/docs/overview.png" alt="具有垂直幻燈片的幻燈片布局"></picture>

Expand Down
6 changes: 3 additions & 3 deletions src/zh-Hant/pdf-export.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ layout: default

# PDF 輸出

簡報可以通過特殊的列印樣式表導出為 PDF。這裡有一個已經上傳到 SlideShare 的導出簡報的例子https://slideshare.net/hakimel/revealjs-300。
簡報可以通過特殊的列印樣式表導出為 PDF。這裡有一個已經上傳到 SlideShare 的導出簡報的範例https://slideshare.net/hakimel/revealjs-300。

注意:此功能目前僅確認在 [Google Chrome](https://google.com/chrome)[Chromium](https://www.chromium.org/Home) 中工作
注意:此功能目前僅確認在 [Google Chrome](https://google.com/chrome)[Chromium](https://www.chromium.org/Home) 中可行

## 操作說明

Expand All @@ -24,7 +24,7 @@ layout: default

## 演講者筆記

你的[演講者筆記](/zh-hant/speaker-view/)可以通過啟用 `showNotes` 選項包含在 PDF 輸出中
你的[演講者筆記](/zh-hant/speaker-view/)可以通過啟用 `showNotes` 選項包含在輸出的 PDF

```js
Reveal.configure({ showNotes: true });
Expand Down
Loading

0 comments on commit 8ef920c

Please sign in to comment.