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>