Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

mostly finished chinese translation of website #1

Open
wants to merge 14 commits into
base: main
Choose a base branch
from
9 changes: 9 additions & 0 deletions content/Get Help/_index.cht.md
@@ -0,0 +1,9 @@
---
title: "Get Help"
date: 2022-08-10T14:58:43+02:00
draft: false
weight: 4
---
Cantara 是一個志願者項目,因此對於本項目並無專業支援。但是如果您有任何的疑問以及困難,開發者將會非常樂於提供支援。最適宜的聯繫方式是 [提出一個 GitHub issue](https://www.github.com/reckel-jm/cantara/issues)。

GitHub 是一個免費的軟體協作平臺。您可以在 GitHub 輕鬆創建一個帳戶,針對您的疑問或困難提出一個 GitHub issue。
29 changes: 29 additions & 0 deletions content/contribute/_index.cht.md
@@ -0,0 +1,29 @@
---
title: "Contribute"
date: 2022-07-19T18:41:23+02:00
draft: false
weight: 5
---

Cantara 是一個以無數的耐心與熱情開發的免費軟體。如果您喜歡它,考慮去做下面的事情之一將會讓我非常感激。我感到非常高興以及榮幸您使用 Cantara!

## 給予反饋、建議、或是錯誤匯報

如果您發現了任何問題,想要提出建議,或者想要回報一個錯誤,請 [在 Cantara 的 GitHub repository 中提出一個 issue](https://github.com/reckel-jm/cantara/issues)。我對於此項目的開發完全位於 GitHub 上,因此這將是最好的方法。 若您沒有 GitHub 帳戶並且不想註冊一個,請向您擁有GitHub的朋友請求協助。

## 將 Cantara 翻譯成其他語言

目前,Cantara 只有德文、英文、以及中文版本。若您可以將 Cantara 翻譯成其他語言,請聯繫我!

## 推薦 Cantara

越多的人使用 Cantara,Cantara 程式就會變得越好!請您根據您的渠道推薦 Cantara。

## 請不要給我提供捐款,而是給其他的人或組織提供資金支援

雖然我仍然是一個「窮」學生😃,但是我的經濟狀況並不需要援助。但是現在這個世界上有許多的人正在遭受苦難,需要幫助。如果您喜歡 Cantara 並且發現您在使用 Cantara 時節省了一些資金,請您考慮資助我下面列出的我非常感激並且也想要資助的非營利組織:

* [OpenDoors](https://www.opendoors.de/):一個為全世界受迫害基督徒提供援助的基督教組織。
* [Missioneswerk Werner Heukelbach](https://www.heukelbach.org/):一個在德國傳播福音的傳教士組織。

感謝您的幫助!
33 changes: 33 additions & 0 deletions content/contribute/translate.cht.md
@@ -0,0 +1,33 @@
---
title: "翻譯"
date: 2022-08-10T15:11:10+02:00
---

Cantara 可以被容易地翻譯為其他語言。通過翻譯,您將可以向全世界推廣本程式,所以非英文、德文使用者也可以使用 Cantara。

## 如何翻譯

Cantara 使用將翻譯的語言字符串存儲在一種二進位語言的語言文件 (`*.mo`-文件)。 這種文件可以用如 [Poedit](https://poedit.net/) 編輯器經由臨時模板文件 [cantara.pot](https://github.com/reckel-jm/cantara/blob/master/locals/cantara.pot) 進行編輯。

如果您要將 Cantara 翻譯成新的語言,請按以下步驟進行:

1. 下載 [cantara.pot](https://github.com/reckel-jm/cantara/blob/master/locals/cantara.pot) 並使用合適的編輯器打開。
2. 將字符串翻譯成所需的目標語言。
3. 將翻譯後的內容導出為 `.mo`文件 **但請保留翻譯的 `.po` 文件!**
4. 複製 `language.mo` 文件至 `<cantara-dir>/languages/language/cantara.mo` (將 `language` 替換為目標語言的短代碼,如德文 *de*、英文 *en*、中文 *zh* 等)。
5. 以 `--lang` 啟動項運行 Cantara 以測試您的翻譯。

`cantara --lang=<language code>`


6. 若翻譯運行良好,請在 GitHub 上發起一個 Pull request,以便其他人也可以使用您的翻譯。

## 目前翻譯狀況

目前,Cantara 被翻譯為如下語言:

| 語言 | 完成度 |
|-----|--------|
| 英文 | 100 % |
| 德文 | 100 % |
| 中文 | 100 % |
49 changes: 49 additions & 0 deletions content/imprint/_index.cht.md
@@ -0,0 +1,49 @@
---
title: "頁面條款及數據安全"
date: 2022-08-10T15:39:43+02:00
hidden: true
---

## 頁面條款

本站點由以下人士運行:

Jan Martin Reckel
Ulbrichtstraße 7
09126 Chemnitz

請使用 GitHub 進行所有與軟體相關的聯繫請求。

本網頁內容按原樣提供,對於信息潛在的準確性問題不提供任何保證。作者對外部鏈接或參考不承擔任何責任。

## 數據安全

### 關於本頁面

此網頁沒有任何联系表格或任何可以保存或跟踪用戶數據的功能。此網頁沒有使用分析工具。

此網頁託管在 GitHub 上,地址如下:

GitHub Inc.
88 Colin P Kelly Jr St
San Francisco, CA 94107
United States

GitHub 在訪問此網頁時可能會收集以下日誌記錄數據:

* IP 位址
* 先前訪問的網頁地址
* 請求的數據與實踐
* 與格林威治標準時的時差
* 請求內容
* HTTP 狀態碼
* 瀏覽器與操作系統信息
* 傳輸數據量

我們無權訪問這些數據,因此不會以任何目的使用它們

若您在使用 GitHub 上的 Pull requests、提交問題等功能,將適用其數據隱私規定。

### 關於 Cantara 應用程式

Cantara 不收集或提交任何數據。其配置文件保存在您本地的文件系統上。 Cantara 沒有連接到互聯網和跟踪功能。
30 changes: 30 additions & 0 deletions content/quick start/_index.cht.md
@@ -0,0 +1,30 @@
---
title: "快速開始"
date: 2022-07-21T11:04:06+02:00
draft: false
weight: 2
---

使用 Cantara **非常簡單**並可按照以下三個步驟完成:

1. 下載 Cantara
2. 收集歌曲
3. 運行並配置 Cantara

由於您可以在 [教程]({{< ref "/tutorial/_index.en.md" >}})中找到一個附有下載鏈接的詳細說明文檔,本頁面只提供一些簡短的建議。

## 下載 Cantara

針對不同操作系統的下載鏈接

* 前往 [下載與安裝教程]({{< ref "/tutorial/Install Cantara.en.md" >}}) 以了解更多信息。
* 查看 [ Github 上的發布頁面](https://github.com/reckel-jm/cantara/releases) 以獲得更多選擇。

## 收集歌曲

使用如 CCLI 歌曲選擇 或其它數據庫等系統獲取您想要唱的歌曲的歌詞。
不知道從哪裡開始? [看看這裡]({{< ref "/tutorial/Where to get the songs.en.md" >}}).

## 運行與配置 Cantara

Cantara 的配置對於大多數情況應是不言自明的。若您需要更多信息,您也可以前往 [教程]({{< ref "/tutorial/How to use it.en.md" >}})。
44 changes: 44 additions & 0 deletions content/releasenotes/_index.cht.md
@@ -0,0 +1,44 @@
---
title: "發佈版本通知"
date: 2022-08-02T16:34:40+02:00
draft: false
weight: 2

---

此頁面包含關於不同版本的更改以及未來計劃的信息。

---

## 發佈

### 版本 2.3.1 (2022-08-12)

這是一個跟進 版本 2.3 的次要版本

#### 改進

- 版本 2.3.1 提供了對背景圖像的支持。可以調整其透明度或亮度。

#### Bug 修復

- 修復了一個 CCLI 許可中的拼寫錯誤,現在是 `ccli-licensenumber`
- 完善了德文翻譯

### 版本 2.3 (2022-08-02)

版本 2.3 在經過了測試與進一步開發後發佈。

#### 改進

* 提供 CCLI 歌曲選擇格式支援*
* 支援歌曲播放過程中動態顯示的元數據。
* 源碼改進
* 為將來開發作出的源代碼及抽象改進
* 歌曲顯示的錯誤修正

與往常一樣,我期待反饋、建議以及錯誤報告。

謝謝!

[前往 Github 的發佈頁](https://github.com/reckel-jm/cantara/releases/tag/v2.3)
40 changes: 40 additions & 0 deletions content/tutorial/How Cantara Works.cht.md
@@ -0,0 +1,40 @@
---
title: "Cantara 如何工作"
date: 2022-07-19T15:37:14+02:00
draft: false
toc: true
weight: 1
---

## 背景故事

在我上文理中學的時候,我成為了一個青年團契的領導。在進行我們的活動時,我們喜歡以歌唱開始。然而我們遇到了一些問題:我們往往沒有足夠的讚美歌曲書籍可以使用,其內容也未必與我們想要唱的歌曲完全匹配。在那時我嘗試尋找一些歌曲展示程式,但很快便以失望告終:大部分的程式要麼是商業化程式,要么對於我們的非常簡單的基礎功能需求來說過於臃腫複雜:參加敬拜的人應該能夠自發地選擇想要唱的歌曲,而目標程式可以展示這些歌曲。

在這時我決定進行 Cantara 應用程式的開發。這個名字來自拉丁文詞彙 「cantare」 (吟唱),但是這個程式不是真的會唱歌,而是像一個程式一樣工作。選擇這個名稱的另一個原因是那時我在教堂裡擔任管風琴手的職位,管風琴手的德文是「Kantor」,與拉丁文「cantare」同源,聽起來也很相似。

後來我領導了 [世界上最棒的學生組織](https://www.smd-chemnitz.de) 😃,在擔任這個職位時,這個程式慢慢的更新了,增添了例如多熒幕顯示支持、直接將歌詞文本導出到剪貼板等等新功能,使其可以在沒有投影儀的小團體中使用。Cantara 的開發將會繼續,希望它能成長為我們敬拜偉大天父所用的一個小工具!

## 工作流程

{{<mermaid align="left">}}
graph LR;
A[曲庫] -->|收集歌曲| B(歌曲列表)
B --> C(選擇歌曲)
C --> D{生成展示數據}
D --> E[運行展示]
D --> F[複製歌詞到剪貼板]
{{< /mermaid >}}

Cantara 從文件系統中 *一個特定資料夾* 中獲取歌曲,此文件夾被稱為 *曲庫* 。每首歌曲都是一個簡單的文本文檔,可以用您喜歡的任何文本編輯器進行編輯。Cantara 將從不包含文件擴展名的文件名稱中識別歌曲標題。所以例如您有這樣一首歌:

Amazing Grace.song

Cantara 將會識別名為以 song 格式寫成的「Amazing Grace」歌曲(關於 song 格式,請參考下節)。

{{% notice 提示 %}}
曲庫目錄可以便捷的通過如 NextCloud 或 Git 一類的雲端服務進行分發與同步。如此您可以將您的歌曲發放給整個小組或者組織。
{{% /notice %}}

{{% notice 警告 %}}
Cantara 的開發者不對隨著歌詞的公開使用和分發而出現的版權問題負責。確保您已經獲得了使用歌曲歌詞的權利!在德意志聯邦共和國,宗教活動逼商業活動享有更多的版權自由。但是請確保您的組織在使用過程中不會出現任何法律問題。
{{% /notice %}}