Skip to content

Commit

Permalink
Fine-tune translation I
Browse files Browse the repository at this point in the history
  • Loading branch information
Edit-Mr committed Jun 4, 2024
1 parent e5da020 commit 4329fa4
Show file tree
Hide file tree
Showing 17 changed files with 45 additions and 47 deletions.
2 changes: 1 addition & 1 deletion src/zh-Hant/auto-animate.md
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,7 @@ Reveal.on('autoanimate', (event) => {
</div>
</div>

## 示例:在列表之間進行動畫
## 範例:在列表之間進行動畫

我們單獨處裡每一個列表項目,讓你可以在不同項目之間進行動畫。

Expand Down
4 changes: 2 additions & 2 deletions src/zh-Hant/code.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ reveal.js 有一個強大的功能,就是為程式碼添加顏色 — 由 [hig

## 行號與高亮

你可以通過在你的 `<code>` 標籤上添加 `data-line-numbers` 屬性來啟用行號。如果你想高亮特定行,可以使用同一屬性提供以逗號分隔的行號列表。例如,在以下示例中,第 3 行和第 8-10 行被高亮:
你可以通過在你的 `<code>` 標籤上添加 `data-line-numbers` 屬性來啟用行號。如果你想高亮特定行,可以使用同一屬性提供以逗號分隔的行號列表。例如,在以下範例中,第 3 行和第 8-10 行被高亮:

```html
<pre><code data-line-numbers="3,8-10">
Expand Down Expand Up @@ -96,7 +96,7 @@ reveal.js 有一個強大的功能,就是為程式碼添加顏色 — 由 [hig

#### 行號偏移 <span class="r-version-badge new">4.2.0</span>

如果你想展示一長串代碼的片段,你可以偏移行號。在下面的示例中,我們設置 `data-ln-start-from="7"` 使行號從 7 開始。
如果你想展示一長串代碼的片段,你可以偏移行號。在下面的範例中,我們設置 `data-ln-start-from="7"` 使行號從 7 開始。

```html
<pre><code data-line-numbers data-ln-start-from="7">
Expand Down
4 changes: 2 additions & 2 deletions src/zh-Hant/course.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,7 @@ hide_ads: true
| 起步 | <!-- --> |
| :--------------------------------------------- | -------: |
| **起步** | 時長 |
| &nbsp; 安裝 reveal.js 和設置開發服務器| 5:40 |
| &nbsp; 安裝 reveal.js 和設置開發伺服器| 5:40 |
| &nbsp; 創建幻燈片,互相鏈接並保存草稿。 | 10:04 |
| &nbsp; 配置你的簡報。 | 8:23 |
| &nbsp; 使用垂直幻燈片。 | 9:05 |
Expand All @@ -87,4 +87,4 @@ hide_ads: true
| &nbsp; 自定義鍵盤快捷鍵。 | 15:04 |
| &nbsp; 與源代碼一起工作。 | 21:09 |

{.toc .hide-header}
{.toc .hide-header}
4 changes: 2 additions & 2 deletions src/zh-Hant/creating-plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ layout: default

{.key-value}

這裡是一個示例插件,當按下 T 鍵時,它會在簡報中洗牌所有幻燈片。注意,我們導出一個返回新插件對象的函數。這樣做是因為同一頁面上可能有[多個簡報實例](/zh-hant/initialization/#multiple-presentations),而每個實例都應該擁有我們插件的自己的實例。
這裡是一個範例插件,當按下 T 鍵時,它會在簡報中洗牌所有幻燈片。注意,我們導出一個返回新插件對象的函數。這樣做是因為同一頁面上可能有[多個簡報實例](/zh-hant/initialization/#multiple-presentations),而每個實例都應該擁有我們插件的自己的實例。

```js
// toaster.js
Expand Down Expand Up @@ -50,7 +50,7 @@ Reveal.initialize({

### 異步插件

如果你的插件需要在 reveal.js 完成初始化之前運行異步代碼,它可以返回一個 Promise。這裡是一個會延遲初始化三秒的示例插件
如果你的插件需要在 reveal.js 完成初始化之前運行異步代碼,它可以返回一個 Promise。這裡是一個會延遲初始化三秒的範例插件

```js
let WaitForIt = {
Expand Down
36 changes: 17 additions & 19 deletions src/zh-Hant/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,71 +6,71 @@ layout: default

# 安裝

我們提供三種不同的安裝 reveal.js 的方式,取決於您的使用情況和技術經驗
我們提供三種不同安裝 reveal.js 的方式,取決於你的使用情境和技術經驗

1. [基本設置](#%E5%9F%BA%E6%9C%AC%E8%A8%AD%E7%BD%AE) 是開始使用的最簡單方法。無需設置任何構建工具。
1. [完整設置](#full-setup) 可讓您訪問更改 reveal.js 源代碼所需的構建工具。它包括一個網絡服務器,如果您想要加載外部 Markdown 文件則需要此服務器(基本設置配合您自選的本地網絡服務器也可以)。
1. 如果您想在項目中使用 reveal.js 作為依賴項,您可以[從 npm 安裝](#%E5%BE%9E-npm-%E5%AE%89%E8%A3%9D)
1. [完整設置](#full-setup) 可讓你訪問更改 reveal.js 源代碼所需的構建工具。它包括一個網頁伺服器,如果你想要加載外部 Markdown 文件則需要此伺服器(基本設置配合你自訂的網頁伺服器也可以)。
1. 如果你想在項目中使用 reveal.js 作為依賴項,你可以 [從 npm 安裝](#%E5%BE%9E-npm-%E5%AE%89%E8%A3%9D)

#### 下一步

安裝完 reveal.js 後,我們推薦查看 [Markup](/markup/)[配置選項](/config/) 指南。
安裝完 reveal.js 後,我們推薦你查看 [Markup](/zh-hant/markup/)[配置選項](/zh-hant/config/) 指南。

## 基本設置

我們力求以盡可能多的人都能使用的方式分發 reveal.js。基本設置是我們開始使用的最廣泛訪問方式,只需要您擁有一個網絡瀏覽器。無需經過構建過程或安裝任何依賴
我們希望能讓盡可能多的人使用 reveal.js。基本設置是大家最常使用的方式,你只需要有一個瀏覽器。無需經過構建過程或安裝任何依賴套件

1. 下載最新版本的 reveal.js <https://github.com/hakimel/reveal.js/archive/master.zip>
1. 解壓並替換 index.html 中的示例內容為您自己的
1. 在瀏覽器中打開 index.html 查看
2. 解壓並替換 index.html 中的範例內容為你自己的
3. 在瀏覽器中打開 index.html 查看

就是這麼簡單 🚀

## 完整設置 <span class="text-gray-500 font-normal">- 推薦</span>{id="full-setup"}

某些 reveal.js 功能,如外部 Markdown,要求簡報從本地網絡服務器運行。以下指令將設置這樣的服務器以及完成對 reveal.js 源代碼所需的所有開發任務。
某些 reveal.js 功能,如外部 Markdown,簡報需要從本地網頁伺服器執行。以下指令將設置這樣的伺服器以及完成對 reveal.js 源代碼所需的所有開發任務。

1. 安裝 [Node.js](https://nodejs.org/) (10.0.0 或更高版本)

1. 克隆 reveal.js 倉庫
2. 克隆 reveal.js 倉庫

```shell
$ git clone https://github.com/hakimel/reveal.js.git
```

1. 移動到 reveal.js 文件夾並安裝依賴
3. 移動到 reveal.js 資料夾並安裝依賴

```shell
$ cd reveal.js && npm install
```

1. 提供簡報並監控源文件的更改
4. 提供簡報並監控源文件的更改

```shell
$ npm start
```

1. 打開 <http://localhost:8000> 查看您的簡報
5. 打開 <http://localhost:8000> 查看你的簡報

### 開發服務器端口
### 開發伺服器端口

開發服務器默認使用 8000 端口。您可以使用 `port` 參數切換到不同的端口:
開發伺服器默認使用 8000 端口。你可以使用 `port` 參數切換到不同的端口:

```shell
npm start -- --port=8001
```

## 從 npm 安裝

框架發布到並可從 [npm](https://www.npmjs.com/package/reveal.js) 安裝。請注意,reveal.js 面向瀏覽器並包含 CSS、字體及其他資源,因此 npm 依賴使用案例可能受限
reveal.js 有上架至 [npm](https://www.npmjs.com/package/reveal.js) 可以直接安裝。請注意,reveal.js 面向瀏覽器並包含 CSS、字體及其他資源,因此使用 npm 安裝許多功能可能會受限

```shell
npm install reveal.js
# 或者
yarn add reveal.js
```

安裝後,您可以將 reveal.js 作為 ES 模塊導入:
安裝後,你可以將 reveal.js 作為 ES 模塊導入:

```js
import Reveal from 'reveal.js';
Expand All @@ -82,9 +82,7 @@ let deck = new Reveal({
deck.initialize();
```


還需要包括 reveal.js 的樣式和一個[簡報主題](/themes/)
你還需要包括 reveal.js 的樣式和一個 [簡報主題](/zh-hant/themes/)

```html
<link rel="stylesheet" href="/node_modules/reveal.js/dist/reveal.css" />
Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/links.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,4 +62,4 @@ layout: default
<button class="navigate-next">下一個</button>
```

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

## Markdown 插件

這個功能由內置的 Markdown 插件提供支持,該插件反過來使用 [marked](https://github.com/chjj/marked) 進行所有解析。Markdown 插件包含在我們的默認簡報示例中。如果您想手動將其添加到新的簡報中,這是操作方式:
這個功能由內置的 Markdown 插件提供支持,該插件反過來使用 [marked](https://github.com/chjj/marked) 進行所有解析。Markdown 插件包含在我們的默認簡報範例中。如果您想手動將其添加到新的簡報中,這是操作方式:

```html
<script src="plugin/markdown/markdown.js"></script>
Expand All @@ -55,7 +55,7 @@ layout: default

您可以將內容寫入一個單獨的文件,並讓 reveal.js 在運行時加載它。注意分隔符參數,它決定了外部文件中的幻燈片如何分隔:`data-separator` 屬性定義水平幻燈片的正則表達式(默認為 `^\r?\n---\r?\n$`,即以換行符為界的水平線)和 `data-separator-vertical` 定義垂直幻燈片(默認禁用)。`data-separator-notes` 屬性是一個正則表達式,用於指定當前幻燈片講者筆記的開始(默認為 `notes?:`,因此它會匹配 "note:" 和 "notes:")。`data-charset` 屬性是可選的,指定加載外部文件時使用哪種字符集。

在本地使用時,此功能要求 reveal.js [從本地網絡服務器運行](/zh-hant/installation/#full-setup)以下示例自定義了所有可用選項
在本地使用時,此功能要求 reveal.js [從本地網頁伺服器運行](/zh-hant/installation/#full-setup)以下範例自定義了所有可用選項

```html
<section
Expand Down
2 changes: 1 addition & 1 deletion 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 Down
8 changes: 4 additions & 4 deletions src/zh-Hant/math.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ layout: default
</script>
```

在此示例中,我們使用了 KaTeX 排版器,但你也可以選擇使用[MathJax 2](#mathjax-2)[3](#mathjax-3-4.2.0)
在此範例中,我們使用了 KaTeX 排版器,但你也可以選擇使用[MathJax 2](#mathjax-2)[3](#mathjax-3-4.2.0)

現在插件已註冊,我們可以開始在幻燈片中添加 [LaTeX](https://en.wikipedia.org/wiki/LaTeX) 公式。

Expand Down Expand Up @@ -80,7 +80,7 @@ Reveal.initialize({
});
```

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

加載(https://cdn.jsdelivr.net/npm/katex)。要使用固定版本,將 `version` 設為例如 `0.13.18`

Expand Down Expand Up @@ -117,7 +117,7 @@ Reveal.initialize({
});
```

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

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

Expand All @@ -143,6 +143,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`
2 changes: 1 addition & 1 deletion src/zh-Hant/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ layout: default
1. 在文檔中包含插件腳本。(有些插件可能還需要樣式。)
1. 通過在初始化時將其包含在 `plugins` 數組中來告訴 reveal.js 關於插件。

這是一個示例
這是一個範例

```html
<script src="plugin/markdown/markdown.js"></script>
Expand Down
4 changes: 2 additions & 2 deletions src/zh-Hant/postmessage.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# postMessage API

框架內建了 postMessage API,當需要與另一個窗口中的演示文稿進行通信時可以使用。以下示例展示了如何讓給定窗口中的 reveal.js 實例進行到第二張幻燈片:
框架內建了 postMessage API,當需要與另一個窗口中的演示文稿進行通信時可以使用。以下範例展示了如何讓給定窗口中的 reveal.js 實例進行到第二張幻燈片:

```javascript
<window>.postMessage( JSON.stringify({ method: 'slide', args: [ 2 ] }), '*' );
Expand All @@ -27,7 +27,7 @@ window.addEventListener('message', (event) => {

## postMessage 回調

當您通過 postMessage API 調用任何方法時,reveal.js 會發送一條帶有返回值的消息。這樣做是為了讓您可以調用 getter 方法並查看結果。查看此示例
當您通過 postMessage API 調用任何方法時,reveal.js 會發送一條帶有返回值的消息。這樣做是為了讓您可以調用 getter 方法並查看結果。查看此範例

```javascript
<revealWindow>.postMessage( JSON.stringify({ method: 'getTotalSlides' }), '*' );
Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/presentation-state.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ layout: default

# 簡報狀態

可以通過使用 `getState` 方法來獲取簡報的當前狀態。狀態對象包含將簡報恢復到首次調用 `getState` 時的所有必要信息。有點像快照。它是一個簡單的對象,可以輕易地被序列化並持久化或通過網絡發送
可以通過使用 `getState` 方法來獲取簡報的當前狀態。狀態對象包含將簡報恢復到首次調用 `getState` 時的所有必要信息。有點像快照。它是一個簡單的對象,可以輕易地被序列化並持久化或通過網頁發送

```javascript
// 移動到第 1 張幻燈片
Expand Down
2 changes: 1 addition & 1 deletion src/zh-Hant/react.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ import 'reveal.js/dist/theme/black.css'; // "black" 主題只是一個例子

還建議使用 refs 來維護對幻燈片集容器 `div` 和相應的 `reveal` 實例的引用。這些 refs 可以幫助確保每個幻燈片集只初始化一次。

#### 下面是一個完整的工作示例
#### 下面是一個完整的工作範例

```ts
// App.tsx
Expand Down
6 changes: 3 additions & 3 deletions src/zh-Hant/scroll-view.md
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ scrollSnap: 'mandatory';

如果您更喜歡一個更密集的布局,並且多個幻燈片同時可見,將 `scrollLayout` 選項設置為 `compact`。這將使每個幻燈片的寬度與視口一致,高度根据您的長寬比(幻燈片寬度/高度)需要而設定。

您可以在下面的示例中看到兩種模式之間的區別。從緊湊布局開始。
您可以在下面的範例中看到兩種模式之間的區別。從緊湊布局開始。

```js
Reveal.initialize({
Expand Down Expand Up @@ -164,6 +164,6 @@ Reveal.initialize({
</div>
</div>

## 示例
## 範例

如果您正在尋找可滾動的 reveal.js 幻燈片示例,這裡有一個很好的示例https://slides.com/news/scroll-mode/scroll
如果您正在尋找可滾動的 reveal.js 幻燈片範例,這裡有一個很好的範例https://slides.com/news/scroll-mode/scroll
4 changes: 2 additions & 2 deletions src/zh-Hant/speaker-view.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ reveal.js 提供了一個演講者筆記插件,可以在單獨的瀏覽器窗

或者,您可以在幻燈片的 `data-notes` 屬性中添加您的筆記,如 `<section data-notes="Something important"></section>`

在本地使用時,此功能要求 reveal.js [從本地網絡服務器運行](/zh-hant/installation/#full-setup)
在本地使用時,此功能要求 reveal.js [從本地網頁伺服器運行](/zh-hant/installation/#full-setup)

```html/3-5
<section>
Expand Down Expand Up @@ -72,6 +72,6 @@ Note:

節奏計時器可以通過在 `Reveal` 配置塊中配置 `defaultTiming` 參數來啟用,該參數指定每張幻燈片的秒數。120 可以是一個合理的經驗法則。或者,您可以通過設置 `totalTime` 來啟用計時器,這設置了您的演示總長度(也以秒為單位)。如果兩個值都指定了,`totalTime` 將優先,`defaultTiming` 將被忽略。無論基準時間方法如何,也可以通過設置幻燈片 `<section>``data-timing` 屬性(同樣是以秒為單位)來給出時間。

## 服務器端演講者筆記
## 伺服器端演講者筆記

在某些情況下,可能希望在與演示的設備不同的設備上運行筆記。基於 Node.js 的筆記插件允許您使用與其客戶端對應物相同的筆記定義來做到這一點。請參見 <https://github.com/reveal/notes-server>.
2 changes: 1 addition & 1 deletion src/zh-Hant/upgrading.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,4 +64,4 @@ Multiplex 和 Notes Server 插件已從 reveal.js 核心移出到它們自己的
### 其他

- 移除了 `Reveal.navigateTo`,改用 `Reveal.slide`
- 我們已切換到 gulp 和 rollup 作為構建系統。確保執行 `npm install` 以獲得最新的依賴項。服務器仍然使用 `npm start` 啟動,與之前相同。
- 我們已切換到 gulp 和 rollup 作為構建系統。確保執行 `npm install` 以獲得最新的依賴項。伺服器仍然使用 `npm start` 啟動,與之前相同。
4 changes: 2 additions & 2 deletions src/zh-Hant/vertical-slides.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,15 +10,15 @@ layout: default

您也可以在單個頂級幻燈片內嵌套多個幻燈片,以創建一個垂直堆疊。這是一種將內容在您的演示中邏輯分組的絕佳方式,並使包含可選幻燈片變得方便。

在演示時,您使用左/右箭頭來逐步瀏覽頂級(水平)幻燈片。當您到達一個垂直堆疊時,您可以選擇性地按上/下箭頭來查看垂直幻燈片,或者通過按右箭頭來跳過它們。以下是一個顯示此操作中的鳥瞰圖的示例
在演示時,您使用左/右箭頭來逐步瀏覽頂級(水平)幻燈片。當您到達一個垂直堆疊時,您可以選擇性地按上/下箭頭來查看垂直幻燈片,或者通過按右箭頭來跳過它們。以下是一個顯示此操作中的鳥瞰圖的範例

<picture>
<img src="https://static.slid.es/support/reveal.js-vertical-slides.gif" alt="帶有垂直幻燈片的幻燈片布局">
</picture>

## 標記

以下是一個簡單的垂直堆疊的標記示例
以下是一個簡單的垂直堆疊的標記範例

```html
<section>水平幻燈片</section>
Expand Down

0 comments on commit 4329fa4

Please sign in to comment.