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

This commit is contained in:
KevinOConnor
2022-08-04 00:04:04 +00:00
parent 4fde85297a
commit f90c212542
22 changed files with 261 additions and 261 deletions

View File

@@ -1284,7 +1284,7 @@
<p>請注意 <a href="https://community.klipper3d.org">Klipper Community Discourse server</a> 也可以用來尋找和分享配置檔案。</p>
<h2 id="_2">準則<a class="headerlink" href="#_2" title="Permanent link">&para;</a></h2>
<ol>
<li>Select the appropriate config filename prefix:<ol>
<li>選擇適當的配置文件名前綴:<ol>
<li><code>printer</code>字首用於主流製造商出售的印表機。</li>
<li><code>generic</code>字首用於通用3D印表機主板。</li>
<li><code>kit</code>的字首用於按照公開規範組裝的3D印表機例如Voron V2.4)。這些 "套件 "印表機通常與普通的印表機不同在它們通常不被製造商銷售。</li>
@@ -1292,8 +1292,8 @@
<li><code>example</code>字首是用來描述印表機運動學。這種型別的配置通常只與新型別的印表機運動學的程式碼一起新增。</li>
</ol>
</li>
<li>All configuration files must end in a <code>.cfg</code> suffix. The <code>printer</code> config files must end in a year followed by <code>.cfg</code> (eg, <code>-2019.cfg</code>). In this case, the year is an approximate year the given printer was sold.</li>
<li>Do not use spaces or special characters in the config filename. The filename should contain only characters <code>A-Z</code>, <code>a-z</code>, <code>0-9</code>, <code>-</code>, and <code>.</code>.</li>
<li>所有配置文件都必須以 <code>.cfg</code> 後綴結尾。 <code>printer</code> 配置文件必須以年份結尾,後跟 <code>.cfg</code>(例如,<code>-2019.cfg</code>)。在這種情況下,年份是給定打印機銷售的大致年份。</li>
<li>不要在配置文件名中使用空格或特殊字符。文件名應僅包含字符<code>A-Z</code><code>a-z</code><code>0-9</code><code>-</code><code>.</code></li>
<li><code>printer</code>, <code>generic</code>, 和 <code>kit</code> 示例配置檔案必須保證 Klipper 能夠正常啟動而不出錯。這些配置檔案應該被新增到 <a href="https://github.com/Klipper3d/klipper/blob/master/test/klippy/printers.test">test/klippy/printers.test</a> 迴歸測試用例中。將新的配置檔案新增到該測試用例的適當部分,並按該部分的字母順序排列。</li>
<li>該配置示例應該是印表機的 "stock "配置。(在klipper的倉庫中有太多定製的配置。)同樣地我們只為具有主流流行性的印表機、套件和板子新增配置檔案的例子至少應該有100個正在使用中。考慮使用<a href="https://community.klipper3d.org">Klipper Community Discourse server</a>進行其他配置。</li>
<li>Only specify those devices present on the given printer or board. Do not specify settings specific to your particular setup.<ol>
@@ -1308,15 +1308,15 @@
<li>不要將欄位文件複製到示例配置檔案中。(這樣做會造成維護方面的負擔,因為對文件的更新需要在很多地方進行修改。)</li>
<li>配置檔案的例子不應包含 "SAVE_CONFIG "部分。如果有必要把SAVE_CONFIG部分的相關欄位複製到主配置區的適當部分。</li>
<li>使用<code>field: value</code>的語法,而不要使用<code>field=value</code></li>
<li>When adding an extruder <code>rotation_distance</code> it is preferable to specify a <code>gear_ratio</code> if the extruder has a gearing mechanism. We expect the rotation_distance in the example configs to correlate with the circumference of the hobbed gear in the extruder - it is normally in the range of 20 to 35mm. When specifying a <code>gear_ratio</code> it is preferable to specify the actual gears on the mechanism (eg, prefer <code>gear_ratio: 80:20</code> over <code>gear_ratio: 4:1</code>). See the <a href="Rotation_Distance.html#using-a-gear_ratio">rotation distance document</a> for more information.</li>
<li>增加擠出機 <code>rotation_distance</code> 時,如果擠出機有傳動機構,最好指定 <code>gear_ratio</code>。我們希望示例配置中的 rotation_distance 與擠出機中滾齒的周長相關 - 它通常在 20 35mm 的範圍內。當指定 <code>gear_ratio</code> 時,最好指定機構上的實際齒輪(例如,更喜歡 <code>gear_ratio: 80:20</code> 而不是 <code>gear_ratio: 4:1</code>)。有關詳細信息,請參閱 [旋轉距離文檔]</li>
<li>避免定義那些被設定為預設值的欄位值。例如,不應該指定<code>min_extrude_temp: 170</code>,因為這已經是預設值。</li>
<li>在可能的情況下行數不應超過80列。</li>
<li>避免在配置檔案中新增歸屬或修訂資訊。例如,避免新增類似 "此檔案由......建立 "的行。將歸屬和修改歷史放在git提交資訊中。</li>
</ol>
</li>
<li>Do not use any deprecated features in the example config file.</li>
<li>不要在示例配置文件中使用任何已棄用的功能。</li>
<li>不要在示例配置檔案中禁用預設安全系統。例如,一個配置不應該指定一個自定義的 <code>max_extrude_cross_section</code>。不要啟用除錯功能。例如,不應該有一個 <code>force_move</code> 配置部分。</li>
<li>All known boards that Klipper supports can use the default serial baud rate of 250000. Do not recommend a different baud rate in an example config file.</li>
<li>Klipper 支持的所有已知板都可以使用默認串行波特率 250000。不要在示例配置文件中推薦不同的波特率。</li>
</ol>
<p>通過建立github "pull request "來提交配置檔案示例。也請遵循<a href="CONTRIBUTING.html">contribution document</a>中的指示。</p>