Deploying to gh-pages from @ Klipper3d/klipper@aac613bf44 🚀

This commit is contained in:
KevinOConnor
2022-12-22 00:03:43 +00:00
parent 36606abf17
commit 8d550d64f4
51 changed files with 1568 additions and 417 deletions

View File

@@ -431,17 +431,24 @@
</li>
<li class="md-nav__item">
<a href="#klipper_1" class="md-nav__link">
我在 Klipper 軟體中診斷出了一個缺陷
<a href="#i-found-a-bug-in-the-klipper-software" class="md-nav__link">
I found a bug in the Klipper software
</a>
</li>
<li class="md-nav__item">
<a href="#klipper_2" class="md-nav__link">
<a href="#klipper_1" class="md-nav__link">
我正在進行一些我想新增到 Klipper 中的改進
</a>
</li>
<li class="md-nav__item">
<a href="#klipper-github" class="md-nav__link">
Klipper github
</a>
</li>
</ul>
@@ -1337,17 +1344,24 @@
</li>
<li class="md-nav__item">
<a href="#klipper_1" class="md-nav__link">
我在 Klipper 軟體中診斷出了一個缺陷
<a href="#i-found-a-bug-in-the-klipper-software" class="md-nav__link">
I found a bug in the Klipper software
</a>
</li>
<li class="md-nav__item">
<a href="#klipper_2" class="md-nav__link">
<a href="#klipper_1" class="md-nav__link">
我正在進行一些我想新增到 Klipper 中的改進
</a>
</li>
<li class="md-nav__item">
<a href="#klipper-github" class="md-nav__link">
Klipper github
</a>
</li>
</ul>
@@ -1375,8 +1389,9 @@
<li><a href="#i-have-a-question-about-klipper">我有一個關於 Klipper 的問題</a></li>
<li><a href="#i-have-a-feature-request">我有一個功能請求</a></li>
<li><a href="#help-it-doesnt-work">我需要幫助!它炸了!</a></li>
<li><a href="#i-have-diagnosed-a-defect-in-the-klipper-software">我在 Klipper 中發現了一個缺陷</a></li>
<li><a href="#i-found-a-bug-in-the-klipper-software">I found a bug in the Klipper software</a></li>
<li><a href="#i-am-making-changes-that-id-like-to-include-in-klipper">我正在進行我想納入 Klipper 的修改</a></li>
<li><a href="#klipper-github">Klipper github</a></li>
</ol>
<h2 id="_2">社區論壇<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<p>有一個用來討論 Klipper 的 <a href="https://community.klipper3d.org">Klipper 社區 Discourse 伺服器</a></p>
@@ -1388,10 +1403,8 @@
<p>也可以在<a href="#community-forum"> Klipper 社區論壇</a>中搜索類似的問題。</p>
<p>如果你有興趣與其他 Klipper 使用者分享你的知識和經驗,那麼你可以加入<a href="#community-forum"> Klipper 社區論壇</a><a href="#discord-chat"> Klipper Discord 聊天室</a>。這兩個社區都是 Klipper 使用者間討論 Klipper 的地方。</p>
<p>我們經常收到許多並不針對 Klipper 的常規3D列印疑問。如果你有常規的疑問或遇到了常規的列印問題那麼你可能會在一般的3D列印論壇或專門針對你的印表機硬體的論壇上得到更好的答案。</p>
<p>不要在 Klipper 的 Github 上建立議題來提問。</p>
<h2 id="_3">我有一個功能請求<a class="headerlink" href="#_3" title="Permanent link">&para;</a></h2>
<p>所有的新功能都需要有感興趣並能夠實現這些功能的人。如果你想幫助實現或測試一個新功能,你可以在<a href="#community-forum"> Klipper 社區論壇</a>中搜索正在進行的開發程序。還有<a href="#discord-chat">Klipper Discord 聊天室</a>供合作者之間討論。</p>
<p>不要在 Klipper 的 Github 上建立議題來請求功能。</p>
<h2 id="_4">我需要幫助!它炸了!<a class="headerlink" href="#_4" title="Permanent link">&para;</a></h2>
<p>不幸的是,我們收到的幫助請求往往比我們能夠回答的要多。我們發現大多數問題報告的根本原因都是:</p>
<ol>
@@ -1402,34 +1415,29 @@
<p>如果你遇到了列印問題,我們建議仔細檢查印表機的硬體(所有接頭、電線、螺絲等),確認沒有任何異常。我們發現大多數列印問題都與 Klipper 軟體無關。如果你確實發現了印表機硬體的問題在一般的3D列印論壇或專門針對你的印表機硬體的論壇上搜索通常可以得到更好的答覆。</p>
<p>也可以在<a href="#community-forum"> Klipper 社區論壇</a>中查詢類似的問題。</p>
<p>如果你有興趣與其他 Klipper 使用者分享你的知識和經驗,那麼你可以加入<a href="#community-forum"> Klipper 社區論壇</a><a href="#discord-chat"> Klipper Discord 聊天室</a>。這兩個社區都是 Klipper 使用者間討論 Klipper 的地方。</p>
<p>不要在 Klipper 的 Github 上建立議題來求助。</p>
<h2 id="klipper_1">我在 Klipper 軟體中診斷出了一個缺陷<a class="headerlink" href="#klipper_1" title="Permanent link">&para;</a></h2>
<h2 id="i-found-a-bug-in-the-klipper-software">I found a bug in the Klipper software<a class="headerlink" href="#i-found-a-bug-in-the-klipper-software" title="Permanent link">&para;</a></h2>
<p>Klipper 是一個開源專案,我們誠摯的感謝貢獻者們在軟體中診斷出錯誤。</p>
<p>Problems should be reported in the <a href="#community-forum">Klipper Community Forum</a>.</p>
<p>修復bug需要提供一些重要的資訊。請遵循以下步驟</p>
<ol>
<li>首先要確定這個錯誤是在 Klipper 軟體中。如果你在想 "我有一個問題我無法找出原因因此這是一個Klipper的錯誤",那麼<strong>不要</strong>建立一個 Github 議題。在這種情況下,有興趣且有能力的人需要先找到問題的根源。如果你想分享你的研究結果或檢查其他使用者是否遇到類似的問題,那麼你可以搜索 <a href="#community-forum">Klipper 社區論壇</a></li>
<li>請確保您正在執行 <a href="https://github.com/Klipper3d/klipper ">https://github.com/Klipper3d/klipper </a> 的未修改程式碼。如果程式碼已被修改或從其他來源獲得,則您需要在報告問題之前先在 <a href="https://github.com/Klipper3d/klipper ">https://github.com/Klipper3d/klipper </a> 獲取的未修改的程式碼上重現問題。</li>
<li>如果可能的話,在不期望的事件發生后,立即在 OctoPrint 終端視窗執行一個<code>M112</code>命令。這將使 Klipper 進入 "關閉"(shutdown)狀態,並在日誌檔案中寫入額外的除錯資訊。</li>
<li>
<p>獲取事件發送時的 Klipper 日誌檔案。該日誌檔案已被設計用來給 Klipper 開發人員提供關於軟體及其執行環境的常見問題(軟體版本、硬體型別、配置、事件時間和數百個其他問題)。</p>
<ol>
<li>Make sure you are running unmodified code from <a href="https://github.com/Klipper3d/klipper">https://github.com/Klipper3d/klipper</a>. If the code has been modified or is obtained from another source, then you should reproduce the problem on the unmodified code from <a href="https://github.com/Klipper3d/klipper">https://github.com/Klipper3d/klipper</a> prior to reporting.</li>
<li>If possible, run an <code>M112</code> command immediately after the undesirable event occurs. This causes Klipper to go into a "shutdown state" and it will cause additional debugging information to be written to the log file.</li>
<li>獲取事件發送時的 Klipper 日誌檔案。該日誌檔案已被設計用來給 Klipper 開發人員提供關於軟體及其執行環境的常見問題(軟體版本、硬體型別、配置、事件時間和數百個其他問題)。<ol>
<li>Klipper 日誌檔案位於 Klipper "主機"(樹莓派)的<code>/tmp/klippy.log</code>檔案中。</li>
<li>你需要用「scp」或「sftp」程式將此日誌檔案複製到您的計算機。 「scp」程式是 Linux 和 MacOS 系統的標準配置。其他系統也通常有可用的 scp 實用程式(例如 WinSCP。如果使用圖形界面的 scp 程式無法直接複製 <code>/tmp/klippy.log</code>,可以嘗試重複點選 <code>..</code>或者<code>parent folder</code>(父資料夾)直到進入根目錄,再點選<code>tmp</code>資料夾,然後選擇<code>klippy.log</code>檔案。</li>
<li>將日誌檔案複製到你的電腦,以便將其上傳到問題報告中。</li>
<li>不要以任何方式修改日誌檔案;不要只提供日誌的片段。只有完整的未修改的日誌檔案才能夠提供必要的資訊。</li>
<li>
<p>如果日誌檔案非常大例如大於2MB那麼可能需要用 zip 或 gzip 來壓縮日誌。</p>
</li>
<li>
<p><a href="https://github.com/Klipper3d/klipper/issues">https://github.com/Klipper3d/klipper/issues</a>開一個新的GitHub議題並對問題進行清晰的描述。Klipper 開發者需要了解你採取了哪些步驟期望的結果是什麼以及實際發生了什麼結果。Klipper 的日誌檔案<strong>必須被新增到議題附件</strong><img alt="議題附件" src="img/attach-issue.png" /></p>
</li>
<li>It is a good idea to compress the log file with zip or gzip.</li>
</ol>
</li>
<li>Open a new topic on the <a href="#community-forum">Klipper Community Forum</a> and provide a clear description of the problem. Other Klipper contributors will need to understand what steps were taken, what the desired outcome was, and what outcome actually occurred. The compressed Klipper log file should be attached to that topic.</li>
</ol>
<h2 id="klipper_2">我正在進行一些我想新增到 Klipper 中的改進<a class="headerlink" href="#klipper_2" title="Permanent link">&para;</a></h2>
<h2 id="klipper_1">我正在進行一些我想新增到 Klipper 中的改進<a class="headerlink" href="#klipper_1" title="Permanent link">&para;</a></h2>
<p>Klipper 是開源軟體,我們非常感謝新的貢獻。</p>
<p>新的貢獻(包括程式碼和文件)需要通過拉取請求(PR)提交。重要資訊請參見<a href="CONTRIBUTING.html">貢獻文件</a></p>
<p>有幾個<a href="Overview.html#developer-documentation">開發人員文件</a>。如果你對程式碼有疑問,那麼你也可以在<a href="#community-forum">Klipper社區論壇</a><a href="#discord-chat">Klipper社區 Discord</a>上提問。如果你想提供你目前的進展情況,那麼你可以在 Github 上開一個問題,寫上你的程式碼的位置,修改的概述,以及對其目前狀態的描述。</p>
<p>There are several <a href="Overview.html#developer-documentation">documents for developers</a>. If you have questions on the code then you can also ask in the <a href="#community-forum">Klipper Community Forum</a> or on the <a href="#discord-chat">Klipper Community Discord</a>.</p>
<h2 id="klipper-github">Klipper github<a class="headerlink" href="#klipper-github" title="Permanent link">&para;</a></h2>
<p>Klipper github may be used by contributors to share the status of their work to improve Klipper. It is expected that the person opening a github ticket is actively working on the given task and will be the one performing all the work necessary to accomplish it. The Klipper github is not used for requests, nor to report bugs, nor to ask questions. Use the <a href="#community-forum">Klipper Community Forum</a> or the <a href="#discord-chat">Klipper Community Discord</a> instead.</p>
</article>