Skip to content

Add comprehensive docs & example .schema.yaml file with all available configuration #1031

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

Draft
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

murataharu0803
Copy link

@murataharu0803 murataharu0803 commented Jun 20, 2025

Pull request

  • Add example.schema.yaml file with all available configurations and their types.

  • Temporarily generated a comprehensive document about different components with AI.

The markdown document is generated through AI by @harlos0517 and has not been thorougly reviewed by any human developer. The accuracy of the information provided is not guaranteed. The initial version is generated with Amazon Q with claude-3.5-sonnet.

This pull request is work in progress and not yet ready to merge. Feel free to give edit suggestions or corrections in the comments section.

Some other notes

Issue tracker

Fixes will automatically close the related issue: none

Feature

Describe feature of pull request: as stated above

Unit test

  • Done

Manual test

  • Done

Code Review

  1. Unit and manual test pass
  2. GitHub Action CI pass
  3. At least one contributor reviews and votes
  4. Can be merged clean without conflicts
  5. PR will be merged by rebase upstream base

Additional Info

中州韻的各位開發者你好,我是來自臺灣的網頁開發者,叫做哈洛斯 (Harlos) 。若此 Pull Request 驚動或冒犯到各位我非常抱歉,但做為一名開發者 (程序員) 我想要為這偉大的專案貢獻一份心力。

最近透過開發者同好發現了小狼毫輸入法,以及它背後的引擎——中州韻 (RIME) 。我在研究輸入法設定檔時遇到了困難,但是卻找不到相關的定義文件。於是我找到了這個專案,並徹夜研讀程式碼。讓我意外的是,即使已經多年沒有接觸 C/C++ 的我,居然還算是能看懂,而這也要歸功於各位開發者乾淨清晰的架構。

然而我的能力還是有限,所以先暫時透過搜尋找到所有使用設定檔之處,整理好成範例設定檔,並且暫時請 AI 協助分析這些元件的功能。如果各位開發者願意,歡迎來給予建議與修正。如果我的行為違反你們的開發流程或習慣,也請務必告知我。

我認為這樣的文件能夠幫助更多人更容易了解中州韻背後的運作原理,並更能夠輕易地自訂輸入法,甚至開發出新的輸入法。作為全職開發者時間和精力很有限,雖然能做的不多,但希望如此能拋磚引玉。先在此感謝各位的閱讀。

@murataharu0803 murataharu0803 marked this pull request as draft June 20, 2025 11:36
@lotem
Copy link
Member

lotem commented Jul 10, 2025

感謝拾柴。

doc/example.schema.yaml
輸入方案代碼模板,很多網友提出過,我感覺很難包羅萬象,因爲有的選項會根據組件的配置增減;另外,如果沒有詳盡的註解,用家也很難利用。將來也許應當考慮用問答程序輔助生成輸入方案。

相比之下文檔和示例對用家更有幫助。

在 WIki 開闢一個頁面如何?
https://github.com/rime/home/wiki

Wiki 比代碼更方便在線編輯,且可以與已有文檔互相引用。
不過之前寫的文檔確實結構不佳,不方便檢索。

https://github.com/LEOYoon-Tsaw/Rime_collections/blob/master/Rime_description.md
這份文檔也收集了衆多選項,我認爲應當抄來,再把現有文檔重新組織。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy