en to zh translation catalogue (138 entries)

note: type: Title =
en: KiCad Command-Line Interface
zh: KiCad 命令行界面

note: type: Plain text
en: _Reference manual_
zh: _参考手册_

note: type: Plain text
en: *Copyright*
zh: *版权*

note: type: Plain text
en: This document is Copyright (C) 2023-2024 by its contributors as listed below. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.
zh: 本文档的版权归 （C） 2023-2024 所有，由下列贡献者提供。您可以根据 GNU 通用公共许可证 （http://www.gnu.org/licenses/gpl.html） 版本 3 或更高版本或知识共享署名许可证 （http://creativecommons.org/licenses/by/3.0/） 版本 3.0 或更高版本的条款分发和/或修改它。

note: type: Plain text
en: All trademarks within this guide belong to their legitimate owners.
zh: 本指南中的所有商标均属于其合法所有者。

note: type: Plain text
en: *Contributors*
zh: *贡献者*

note: type: Plain text
en: *Feedback*
zh: *反馈*

note: type: Plain text
en: The KiCad project welcomes feedback, bug reports, and suggestions related to the software or its documentation. For more information on how to submit feedback or report an issue, please see the instructions at https://www.kicad.org/help/report-an-issue/
zh: KiCad 项目欢迎与软件或其文档相关的反馈、错误报告和建议。有关如何提交反馈或报告问题的更多信息，请参阅 https://www.kicad.org/help/report-an-issue/ 上的说明

note: type: Title ==
en: Introduction to the KiCad Command-Line Interface
zh: KiCad 命令行界面简介

note: type: Plain text
en: KiCad provides a command-line interface, which is available by running the `kicad-cli` binary. With the command-line interface, you can perform a number of actions on schematics, PCBs, symbols, and footprints in an automated fashion, such as plotting Gerber files from a PCB design or upgrading a symbol library from a legacy file format to a modern format.
zh: KiCad 提供了一个命令行界面，可以通过运行 `kicad-cli` 二进制文件来使用。使用命令行界面，您可以以自动化方式对原理图、PCB、符号和封装执行许多操作，例如绘制 PCB 设计中的 Gerber 文件或将符号库从传统文件格式升级到现代格式。

note: type: Plain text
en: On macOS, the `kicad-cli` executable is located at
          `/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli`.
zh: 在 macOS 上，`kicad-cli` 可执行文件位于
          `/Applications/KiCad/KiCad.app/Contents/MacOS/kicad-cli`。

note: type: Plain text
en: The `kicad-cli` command has 5 subcommands: `fp`, `pcb`, `sch`, `sym`, and `version`. Each subcommand may have its own subcommands and arguments. For example, to export Gerber files from a PCB you could run `kicad-cli pcb export gerbers example.kicad_pcb`.
zh: `kicad-cli` 命令有 5 个子命令： `fp`、`pcb`、`sch`、`sym` 和 `version`。每个子命令都可以有自己的子命令和参数。例如，要从 PCB 导出 Gerber 文件，您可以运行 `kicad-cli pcb export gerbers example.kicad_pcb` 。

note: type: Plain text
en: You can add the `--help` or `-h` flag to see information about each subcommand. For example, running `kicad-cli pcb -h` prints usage information about the `pcb` subcommand, and `kicad-cli pcb export gerbers -h` prints usage information specifically for the `pcb export gerbers` subcommand.
zh: 您可以添加 `--help` 或 `-h` 标志来查看有关每个子命令的信息。例如，运行 `kicad-cli pcb -h` 打印有关 `pcb` 子命令的使用信息，而 `kicad-cli pcb export gerbers -h` 专门打印 `pcb export gerbers` 子命令的使用信息。

note: type: Title ==
en: Footprint commands
zh: 封装命令

note: type: Plain text
en: The `fp` subcommand exports footprints to another format or upgrades the footprint libraries to the current version of the KiCad footprint file format.
zh: `fp` 子命令将封装导出为另一种格式，或将封装库升级到 KiCad 封装文件格式的当前版本。

note: type: Title ===
en: Footprint export
zh: 封装导出

note: type: Plain text
en: The `fp export svg` command exports one or more footprints from the specified library into SVG files.
zh: `fp export svg` 命令将指定库中的一个或多个封装导出到 SVG 文件中。

note: type: Plain text
en: Usage: `kicad-cli fp export svg [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--define-var KEY=VALUE] [--theme VAR] [--footprint FOOTPRINT_NAME] [--black-and-white] INPUT_DIR`
zh: 用法：`kicad-cli fp export svg [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--define-var KEY=VALUE] [--theme VAR] [--footprint FOOTPRINT_NAME] [--black-and-white] INPUT_DIR`

note: type: Plain text
en: Positional arguments:
zh: 位置参数：

note: type: Table
en: | `INPUT_DIR`
        | Footprint library directory to export (`.pretty`).
zh: | `INPUT_DIR`
        | 要导出的封装库目录 （`.pretty`）。

note: type: Plain text
en: Optional arguments:
zh: 可选参数：

note: type: Table
en: | `-h`, `--help`
        | Show help for the footprint SVG export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output directory for the exported files. When this argument is not
          used, the files are exported to the current directory.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to export from the footprint, such
          as `F.Cu,B.Cu`. If no layers are given, all layers are exported.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          footprint editor's currently selected theme is used.
    | `--fp <footprint>`, `--footprint <footprint>`
        | The name of the specific footprint to export from the library. When this
          argument is not used, all footprints in the library are exported.
    | `--black-and-white`
        | Export footprints in black and white.
zh: |`-h`， `--help`
        | 显示封装 SVG 导出命令的帮助。
    |`-o <output dir>`， `--output <output dir>`
        | 导出文件的输出目录。不使用该参数时，文件将导出到当前目录。
    |`-l <layer list>`， `--layers <layer list>`
        | 以逗号分隔的要从封装中导出的图层名称列表，如 `F.Cu,B.Cu`。如果没有给出图层，则导出所有图层。
    |`-D <variable name>=<value>`， `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    |`-t <theme name>`， `--theme <theme name>`
        | 用于导出的主题名称。如果没有给出主题，则使用封装编辑器当前选择的主题。
    |`--fp <footprint>`， `--footprint <footprint>`
        | 要从库中导出的特定封装的名称。不使用此参数时，将导出库中的所有封装。
    |`--black-and-white`
        | 导出黑白封装。

note: type: Title ===
en: Footprint upgrade
zh: 封装升级

note: type: Plain text
en: The `fp upgrade` command upgrades the the specified footprint library from a legacy footprint format to the native format for the current version of KiCad.  If the input library is already in the current file format, no action is taken.
zh: `fp upgrade` 命令将指定的封装库从传统封装格式升级到当前版本的 KiCad 的原生格式。 如果输入库已采用当前文件格式，则不执行任何操作。

note: type: Plain text
en: Usage: `kicad-cli fp upgrade [-h] [--output OUTPUT_DIR] [--force] INPUT_DIR`
zh: 用法：`kicad-cli fp upgrade [-h] [--output OUTPUT_DIR] [--force] INPUT_DIR`

note: type: Table
en: | `INPUT_DIR`
        | Footprint library directory to upgrade (`.pretty`).
zh: | `INPUT_DIR` 
        | 要升级的封装库目录 （`.pretty`）。

note: type: Table
en: | `-h`, `--help`
        | Show help for the footprint upgrade command.
    | `-o <output dir>`, `--output <output dir>`
        | The output directory for the upgraded footprints. When this argument is
          not used, the upgraded footprints are saved over the original footprints.
    | `--force`
        | Re-save the input library even if it is already in the current file format.
zh: |`-h`， `--help`
        | 显示封装升级命令的帮助。
    |`-o <output dir>`， `--output <output dir>`
        | 升级后封装的输出目录。不使用此参数时，升级后的封装会保存在原始封装之上。
    |`--force`
        | 强制保存输入库，即使它已经是当前文件格式。

note: type: Title ==
en: PCB commands
zh: PCB 命令

note: type: Plain text
en: The `pcb` command runs a design rule check or exports a board to various other file formats, including fabrication and 3D files.
zh: `pcb` 命令运行设计规则检查或将电路板导出为各种其他文件格式，包括制造和 3D 文件。

note: type: Plain text
en: The `pcb drc` command runs a design rule check on a board and generates a report.
zh: `pcb drc` 命令在电路板上运行设计规则检查并生成报告。

note: type: Plain text
en: Usage: `kicad-cli pcb drc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format FORMAT] [--all-track-errors] [--schematic-parity] [--units UNITS] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE`
zh: 用法：`kicad-cli pcb drc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format FORMAT] [--all-track-errors] [--schematic-parity] [--units UNITS] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Board file to run DRC on.
zh: | `INPUT_FILE` 
        | 要在其上运行 DRC 的电路板文件。

note: type: Table
en: | `-h`, `--help`
        | Show help for the DRC command.
    | `-o <output filename>, `--output <output filename>`
        | Output filename for the generated DRC report. When this argument is not
          used, the output filename will be the same as the input file, with the
          `.rpt` or `.json` file extension, depending on the selected format.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `--format <format>`
        | Report file format. Options are `report` (default) or `json`.
    | `--all-track-errors`
        | Report all errors for each track.
    | `--schematic-parity`
        | Test for parity between PCB and schematic.
    | `--units <unit>`
        | Units to use in the report. Options are `mm` (default), `in`, or `mils`.
    | `--severity-all`
        | Report all DRC violations. This is equivalent to using all of the other
          DRC severity options.
    | `--severity-error`
        | Report all error-level DRC violations. This can be combined with the other
          DRC severity options.
    | `--severity-warning`
        | Report all warning-level DRC violations. This can be combined with the
          other DRC severity options.
    | `--severity-exclusions`
        | Report all excluded DRC violations. This can be combined with the other
          DRC severity options.
    | `--exit-code-violations`
        | Return an exit code depending on whether or not DRC violations exist. The
          exit code is 0 if no violations are found, and 5 if any violations are
          found.
zh: |`-h`， `--help`
        | 显示 DRC 命令的帮助。
    |`-o <output filename>`， `--output <output filename>`
        | 生成的 DRC 报告的输出文件名。不使用该参数时，输出文件名将与输入文件相同，根据所选格式，文件扩展名为 `.rpt` 或 `.json`。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    |`--format <format>`
        | 报告文件格式。选项为 `report` （默认）或 `json` 。
    |`--all-track-errors`
        | 报告每个布线的所有错误。
    |`--schematic-parity`
        | 测试 PCB 和原理图之间的奇偶校验。
    |`--units <unit>`
        | 要在报表中使用的单位。选项为 `mm`（默认）、`in` 或 `mils`。
    |`--severity-all`
        | 报告所有 DRC 违规行为。这相当于使用所有其他 DRC 严重性选项。
    | `--severity-error` 
        | 报告所有错误级别的 DRC 违规行为。该选项可与其他 DRC 严重性选项结合使用。
    |`--severity-warning`
        | 报告所有警告级别的 DRC 违规行为。该选项可与其他 DRC 严重性选项结合使用。
    |`--severity-exclusions`
        | 报告所有排除在外的 DRC 违规行为。该选项可与其他 DRC 严重性选项结合使用。
    |`--exit-code-violations`
        | 根据是否存在 DRC 违规，返回退出代码。如果没有发现违规，则退出代码为 0；如果发现违规，则退出代码为 5。

note: type: Title ===
en: PCB drill file export
zh: PCB 钻孔文件导出

note: type: Plain text
en: The `pcb export drill` command exports a drill file from a board.
zh: `pcb export drill` 命令从电路板导出钻孔文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export drill [--help] [--output OUTPUT_DIR] [--format FORMAT] [--drill-origin DRILL_ORIGIN] [--excellon-zeros-format ZEROS_FORMAT] [--excellon-oval-format OVAL_FORMAT] [--excellon-units UNITS] [--excellon-mirror-y] [--excellon-min-header] [--excellon-separate-th] [--generate-map] [--map-format MAP_FORMAT] [--gerber-precision VAR] INPUT_FILE`
zh: 用法：`kicad-cli pcb export drill [--help] [--output OUTPUT_DIR] [--format FORMAT] [--drill-origin DRILL_ORIGIN] [--excellon-zeros-format ZEROS_FORMAT] [--excellon-oval-format OVAL_FORMAT] [--excellon-units UNITS] [--excellon-mirror-y] [--excellon-min-header] [--excellon-separate-th] [--generate-map] [--map-format MAP_FORMAT] [--gerber-precision VAR] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Board file to export.
zh: | `INPUT_FILE` 
        | 要导出的电路板文件。

note: type: Table
en: | `-h`, `--help`
        | Show help for the drill file export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output directory for the drill file. When this argument is not used,
          the drill file is saved in the current directory.
    | `--format <format>`
        | The drill file format. Options are `excellon` (default) or `gerber`.
    | `--drill-origin <origin>`
        | The coordinate origin for the drill file. Options are `absolute` (default)
          to use the board's absolute origin or `plot` to use the board's
          drill/placement origin.
    | `--excellon-zeros-format <format>`
        | The zeros format for the drill file. Options are `decimal` (default),
          `suppressleading`, `suppresstrailing`, or `keep`. Only applies to Excellon
          format drill files.
    | `--excellon-oval-format <format>`
        | Control the oval holes drill mode. Options are `route` and `alternate`
        (default). Only applies to Excellon format drill files.
    | `-u <units>`, `--excellon-units <units>`
        | The units for the drill file. Options are `mm` (default) or `in`. Only
          applies to Excellon format drill files.
    | `--excellon-mirror-y`
        | Mirror the drill file in the Y direction. Only applies to Excellon format
          drill files.
    | `--excellon-min-header`
        | Use a minimal header in the drill file. Only applies to Excellon format
          drill files.
    | `--excellon-separate-th`
        | Generate separate drill files for plated and non-plated through holes.
          Only applies to Excellon format drill files.
    | `--generate-map`
        | Generate a map file in addition to the drill file.
    | `--map-format <format>`
        | The map file format. Options are `pdf` (default), `gerberx2`, `ps`, `dxf`,
          or `svg`.
    | `--gerber-precision <precision>`
        | The precision (number of digits) for the drill file. Valid options are `5`
          or `6` (default).  Only applies to Gerber format drill files.
zh: |`-h`， `--help`
        | 显示钻孔文件导出命令的帮助。
    |`-o <output dir>`， `--output <output dir>`
        | 钻孔文件的输出目录。不使用此参数时，钻孔文件保存在当前目录下。
    |`--format <format>`
        | 钻取文件格式。选项为 `excellon`（默认）或 `gerber`。
    |`--drill-origin <origin>`
        | 钻孔文件的坐标原点。选项有 `absolute` （默认），用于使用电路板的绝对原点；或 `plot` ，用于使用电路板的钻孔/置位原点。
    |`--excellon-zeros-format <format>`
        | 钻孔文件中零的表示格式。提供四种选项：`decimal`（默认，采用十进制格式）、`suppressleading`（省略前导零）、`suppresstrailing`（省略尾随零）、以及 `keep`（保留所有零）。这些设置仅在 Excellon 格式的钻孔文件中有效。 
    |`--excellon-oval-format <format>`
        | 控制椭圆形通孔的钻孔策略。提供两种模式：`route`（布线模式）和 `alternate`（备用模式，默认选项）。这些设置仅在 Excellon 格式的钻孔文件中生效。 
    |`-U <units>`， `--excellon-units <units>`
        | 钻孔文件的单位。选项为 `mm`（默认）或 `in`。仅适用于 Excellon 格式的钻孔文件。
    |`--excellon-mirror-y`
        | 沿 Y 方向镜像钻孔文件。仅适用于 Excellon 格式的钻孔文件。
    |`--excellon-min-header`
        | 在钻孔文件中使用最小的钻头。仅适用于 Excellon 格式的钻孔文件。
    |`--excellon-separate-th`
        | 为电镀通孔和非电镀通孔生成不同的钻孔文件。 仅适用于 Excellon 格式的钻孔文件。
    |`--generate-map`
        | 除了钻取文件之外，还生成映射文件。
    |`--map-format <format>`
        | 映射文件格式。选项包括 `pdf`（默认）、`gerberx2`、`ps`、`dxf` 或 `svg`。
    |`--gerber-precision <precision>`
        | 钻孔文件的精度（位数）。有效选项为 `5` 或 `6`（默认）。 仅适用于 Gerber 格式的钻孔文件。

note: type: Title ===
en: PCB DXF export
zh: PCB DXF 导出

note: type: Plain text
en: The `pcb export dxf` command exports a board design to a DXF file.
zh: `pcb export dxf` 命令将电路板设计导出为 DXF 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export dxf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--use-contours] [--include-border-title] [--output-units UNITS] INPUT_FILE`
zh: 用法：`kicad-cli pcb export dxf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--use-contours] [--include-border-title] [--output-units UNITS] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the DXF export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.dxf` file extension.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to export from the footprint, such
          as `F.Cu,B.Cu`. At least one layer must be given.
    | `--erd`, `--exclude-refdes`
        | Exclude footprint reference designators from plot.
    | `--ev`, `--exclude-value`
        | Exclude footprint values from plot.
    | `--uc`, `--use-contours`
        | Plot graphic items using their contours.
    | `-ibt`, `--include-border-title`
        | Include sheet border and title block in plot.
    | `--ou <unit>`, `--output-units <unit>`
        | Output units. Options are `mm` or `in` (default).
zh: |`-h`， `--help`
        | 显示 DXF 导出命令的帮助。
    |`-o <output filename>`， `--output <output filename>`
        | 输出文件名。如果不使用此参数，输出文件名将与输入文件相同，文件扩展名为 `.dxf`。
    |`--drawing-sheet <sheet path>`
        | 在绘制中使用的图纸的路径，覆盖电路板文件中指定的图纸。
    |`-D <variable name>=<value>`， `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    |`-l <layer list>`， `--layers <layer list>`
        | 以逗号分隔的要从封装中导出的图层名称列表，如 `F.Cu,B.Cu`。必须至少给出一个图层。
    |`--erd`， `--exclude-refdes`
        | 从绘制中排除封装位号。
    |`--ev`， `--exclude-value`
        | 从绘制中排除封装值。
    |`--uc`， `--use-contours`
        | 使用轮廓线绘制图形项目。
    |`-ibt`， `--include-border-title`
        | 在绘制中包括图纸边框和标题块。
    |`--ou <unit>`， `--output-units <unit>`
        | 输出单位。选项为 `mm` 或 `in` （默认）。

note: type: Title ===
en: PCB Gerber export: one layer per file
zh: PCB Gerber 导出：每个文件一层

note: type: Plain text
en: The `pcb export gerbers` command exports a board design to Gerber files, with one layer per file.
zh: `pcb export gerbers` 命令将电路板设计导出到 Gerber 文件，每个文件一层。

note: type: Plain text
en: Be aware that there are two distinct Gerber export commands, `gerber` and
          `gerbers`. The `gerber` command plots multiple PCB layers to a single
          Gerber file, while the `gerbers` command plots multiple Gerber files, with
          one PCB layer per file. The `gerbers` command is typically the correct
          command to use for having a PCB fabricated.
zh: 请注意有两种不同的 Gerber 导出命令，即 `gerber` 和 `gerbers`。`gerber` 命令将多个 PCB 层绘制到单个 Gerber 文件中，而 `gerbers` 命令将多个 Gerber 文件绘制到单个 Gerber 文件中。在制作 PCB 时，通常应使用 `gerbers` 命令。

note: type: Plain text
en: Usage: `kicad-cli pcb export gerbers [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--precision PRECISION] [--no-protel-ext] [--common-layers COMMON_LAYER_LIST] [--board-plot-params] INPUT_FILE`
zh: 用法：`kicad-cli pcb export gerbers [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--subtract-soldermask precision] [--no-protel-ext] [--common-layers COMMON_LAYER_LIST] [--board-plot-params] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the Gerber export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to plot from the board, such as
          `F.Cu,B.Cu`. If this argument is not used, all layers will be plotted.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `--erd`, `--exclude-refdes`
        | Exclude footprint reference designators from plot.
    | `--ev`, `--exclude-value`
        | Exclude footprint values from plot.
    | `--ibt`, `--include-border-title`
        | Include the sheet border and title block.
    | `--no-x2`
        | Do not use the extended X2 format.
    | `--no-netlist`
        | Do not include netlist attributes.
    | `--subtract-soldermask`
        | Remove silkscreen from areas without soldermask.
    | `--disable-aperture-macros`
        | Disable aperture macros.
    | `--use-drill-file-origin`
        | Use drill/place file origin instead of absolute origin.
    | `--precision <precision>`
        | The precision (number of digits) for the Gerber files. Valid options are
          `5` or `6` (default).
    | `--no-protel-ext`
        | Use `.gbr` file extension instead of Protel file extensions (`.gbl`,
          `.gtl`, etc.).
    | `--cl <layer list>`, `--common-layers <layer list>`
        | A comma-separated list of layer names to plot on all layers, such as
          `F.Cu,B.Cu`.
    | `--board-plot-params`
        | Use the Gerber plot settings already configured in the board file.
zh: |`-h`， `--help`
        | 显示 Gerber 导出命令的帮助。
    |`-o <output dir>`， `--output <output dir>`
        | 导出文件的输出文件夹。不使用该参数时，文件将导出到当前目录。
    |`-l <layer list>`， `--layers <layer list>`
        | 以逗号分隔的图层名称列表，如 `F.Cu,B.Cu`。如果未使用此参数，则将绘制所有图层。
    |`--drawing-sheet <sheet path>`
        | 在绘制中使用的图纸的路径，覆盖电路板文件中指定的图纸。
    |`-D <variable name>=<value>`， `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    |`--erd`， `--exclude-refdes`
        | 从绘制中排除封装位号。
    |`--ev`， `--exclude-value`
        | 从绘制中排除封装值。
    |`--ibt`， `--include-border-title`
        | 包括页面边框和标题块。
    |`--no-x2`
        | 请勿使用扩展的 X2 格式。
    |`--no-netlist`
        | 不要包含网表属性。
    |`--subtract-soldermask`
        | 去除没有阻焊层区域的丝印。
    |`--disable-aperture-macros`
        | 禁用光圈宏。
    |`--use-drill-file-origin`
        | 使用钻孔/放置文件原点，而不是绝对原点。
    |`--precision <precision>`
        | Gerber 文件的精度（位数）。有效选项为 `5` 或 `6`（默认）。
    |`--no-protel-ext`
        | 使用 `.gbr` 文件扩展名而不是 Protel 文件扩展名（ `.gbl` 、 `.gtl` 等）。
    |`--cl <layer list>`， `--common-layers <layer list>`
        | 以逗号分隔的图层名称列表，用于在所有图层上绘制，如 `F.Cu,B.Cu`。
    |`--board-plot-params`
        | 使用已在电路板文件中配置的 Gerber 绘制设置。

note: type: Title ===
en: PCB Gerber export: multiple layers per file
zh: 导出 PCB Gerber：每个文件可导出多个层

note: type: Plain text
en: The `pcb export gerber` command exports one or more board layers to a single Gerber file.
zh: `pcb export gerber` 命令将一个或多个板层导出到单个 Gerber 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export gerber [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--precision PRECISION] [--no-protel-ext] INPUT_FILE`
zh: 用法：`kicad-cli pcb export gerber [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-refdes] [--exclude-value] [--include-border-title] [--no-x2] [--no-netlist] [--subtract-soldermask] [--disable-aperture-macros] [--use-drill-file-origin] [--subtract-soldermask precision] [--no-protel-ext] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the Gerber export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.gbr` file extension.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to plot from the board, such as
          `F.Cu,B.Cu`. All layers will be plotted in the output file. At least one
          layer must be given.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `--erd`, `--exclude-refdes`
        | Exclude footprint reference designators from plot.
    | `--ev`, `--exclude-value`
        | Exclude footprint values from plot.
    | `--ibt`, `--include-border-title`
        | Include the sheet border and title block.
    | `--no-x2`
        | Do not use the extended X2 format.
    | `--no-netlist`
        | Do not include netlist attributes.
    | `--subtract-soldermask`
        | Remove silkscreen from areas without soldermask.
    | `--disable-aperture-macros`
        | Disable aperture macros.
    | `--use-drill-file-origin`
        | Use drill/place file origin instead of absolute origin.
    | `--precision <precision>`
        | The precision (number of digits) for the Gerber files. Valid options are
          `5` or `6` (default).
    | `--no-protel-ext`
        | Use `.gbr` file extension instead of Protel file extensions (`.gbl`,
          `.gtl`, etc.).
zh: | `-h`, `--help`
        | 显示 Gerber 导出命令的帮助。
    | `-o <output filename>`, `--output <output filename>`
        | 输出文件名。不使用此参数时，输出文件名 将与输入文件相同，文件扩展名为 `.gbr`。
    | `-l <layer list>`, `--layers <layer list>`
        | 以逗号分隔的要从电路板上绘制的图层名称列表，如 `F.Cu,B.Cu`。所有层都将绘制到输出文件中。必须至少给出一个 层。
    | `--drawing-sheet <sheet path>` 
        | 绘制时使用的绘制表路径，覆盖电路板文件中指定的绘制表。优先于电路板文件中指定的绘制纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用 以定义多个变量。
    | `--erd`, `--exclude-refdes`
        | 从绘制中排除封装位号。
    | `--ev`, `--exclude-value`
        | 从绘制中排除封装值。
    | `--ibt`, `--include-border-title`
        | 包含工作表边框和标题块。
    | `--no-x2`
        | 不使用扩展 X2 格式。
    |`--no-netlist`
        | 不包含网表属性。
    |`--subtract-soldermask`
        | 去除无阻焊区域的丝印。
    | `--disable-aperture-macros`
        | 禁用光圈宏。
    | `--use-drill-file-origin` 
        | 使用钻孔/放置文件原点，而不是绝对原点。
    | `--precision <precision>`
        | Gerber 文件的精度（位数）。有效选项为 `5` 或 `6`（默认）。
    | `--no-protel-ext`
        | 使用 `.gbr` 文件扩展名代替 Protel 文件扩展名（`.gbl`、`.gtl` 等）。

note: type: Title ===
en: PCB GLB export
zh: PCB GLB 导出

note: type: Plain text
en: The `pcb export glb` command exports a board design to a GLB (binary GLTF) 3D file.
zh: `pcb export glb` 命令将电路板设计导出为 GLB（二进制 GLTF）3D 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export glb [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--grid-origin] [--drill-origin] [--no-unspecified] [--no-dnp] [--subst-models] [--board-only] [--include-tracks] [--include-zones] [--min-distance MIN_DIST] [--user-origin VAR] INPUT_FILE`
zh: 用法： `kicad-cli pcb export glb [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--grid-origin] [--drill-origin] [--no-unspecified] [--no-dnp] [--subst-models] [--board-only] [--include-tracks] [--include-zones] [--min-distance MIN_DIST] [--user-origin VAR] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the GLB export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.glb` file extension.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-f`, `--force`
        | Overwrite output file.
    | `--grid-origin`
        | Use grid origin as origin of output file.
    | `--drill-origin`
        | Use drill origin as origin of output file.
    | `--no-unspecified`
        | Exclude 3D models of components with 'unspecified' footprint type.
    | `--no-dnp`
        | Exclude 3D models of components with 'Do not populate' attribute.
    | `--subst-models`
        | Replace VRML models in footprints with STEP models of the same name, if
          they exist.
    | `--board-only`
        | Only include the board itself in the generated model; exclude all
          component models.
    | `--include-tracks`
        | Include tracks in export (time consuming).
    | `--include-zones`
        | Include zones in export (time consuming).
    | `--min-distance <min distance>`
        | Tolerance for considering two points to be in the same location. Default:
          `0.01mm`.
    | `--user-origin <output origin>`
        | Specify a custom origin for the output file, with X and Y coordinates. For
          example, `1x1in`, `1x1inch`, or `25.4x25.4mm`. The default unit is
          millimeters.
zh: | `-h`, `--help`
        | 显示 GLB 导出命令的帮助。
    | `-o <output filename>`, `--output <output filename>`
        | 输出文件名。不使用该参数时，输出文件名将与输入文件相同，文件扩展名为 `.glb`。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    | `-f`, `--force`
        | 强制覆盖输出文件。
    | `--grid-origin`
        | 使用网格原点作为输出文件的原点。
    | `--drill-origin`
        | 使用钻孔原点作为输出文件的原点。
    | `--no-unspecified`
        | 排除封装类型为 "未指定" 的部件的 3D 模型。
    | `--no-dnp`
        | 排除带有 "不填充" 属性的 3D 模型。
    | `--subst-models`
        | 用同名 STEP 模型替换封装中的 VRML 模型（如果存在）。
    | `--board-only`
        | 在生成的模型中只包含电路板本身；不包含所有元件模型。
    | `--include-tracks`
        | 在导出时包含布线（耗时）。
    | `--include-zones`
        | 导出时包含区域（耗时）。
    | `--min-distance <min distance>`
        | 认为两个点在同一位置的误差。默认值：`0.01mm`。
    | `--user-origin <output origin>`
        | 为输出文件指定自定义的原点，包括 X 和 Y 坐标。例如，`1x1in`、`1x1inch` 或 `25.4x25.4mm`。默认单位是毫米。.

note: type: Title ===
en: PCB IPC-2581 export
zh: PCB IPC-2581 导出

note: type: Plain text
en: The `pcb export ipc2581` command exports a board design in IPC-2581 format.
zh: `pcb export ipc2581` 命令以 IPC-2581 格式导出电路板设计。

note: type: Plain text
en: Usage: `kicad-cli pcb export ipc2581 [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--precision PRECISION] [--compress] [--version VAR] [--units VAR] [--bom-col-int-id FIELD_NAME] [--bom-col-mfg-pn FIELD_NAME] [--bom-col-mfg FIELD_NAME] [--bom-col-dist-pn FIELD_NAME] [--bom-col-dist FIELD_NAME] INPUT_FILE`
zh: 用法： `kicad-cli pcb export ipc2581 [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--precision PRECISION] [--compress] [--version VAR] [--units VAR] [--bom-col-int-id FIELD_NAME] [--bom-col-mfg-pn FIELD_NAME] [--bom-col-mfg FIELD_NAME] [--bom-col-dist-pn FIELD_NAME] [--bom-col-dist FIELD_NAME] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the IPC-2581 export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.xml` file extension.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `--precision <precision>`
        | The precision (number of digits after the decimal separator) for the
          exported file. The default is `3`.
    | `--compress`
        | Compress output file as a ZIP file.
    | `--version <IPC-2581 standard version>`
        | IPC-2581 standard version to use. Options are `B` or `C` (default).
    | `--units`
        | Units to use in export. Options are `mm` (default) or `in`.
    | `--bom-col-int-id`
        | Name of the part field to use for the Bill of Materials Internal ID
          column. This can be any footprint field, or blank to omit this column.
    | `--bom-col-mfg-pn`
        | Name of the part field to use for the Bill of Materials Manufacturer Part
          Number column. This can be any footprint field, or blank to omit this
          column.
    | `--bom-col-mfg`
        | Name of the part field to use for the Bill of Materials Manufacturer
          column. This can be any footprint field, or blank to omit this column.
    | `--bom-col-dist-pn`
        | Name of the part field to use for the Bill of Materials Distributor Part
          Number column. This can be any footprint field, or blank to omit this
          column.
    | `--bom-col-dist`
        | Name of the part field to use for the Bill of Materials Distributor
          column. This can be any footprint field, or blank to omit this column.
zh: | `-h`, `--help`
        | 显示 IPC-2581 输出命令的帮助。
    | `-o <output filename>`, `--output <output filename>`
        | 输出文件名。不使用此参数时，输出文件名将与输入文件相同，文件扩展名为 `.xml`。
    | `--drawing-sheet <sheet path>`
        | 在绘图中使用的图纸路径，优先于电路板文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    | `--precision <precision>`
        | 导出文件的精度（小数点后的位数）。默认为 `3`。
    | `--compress`
        | 将输出文件压缩为 ZIP 文件。
    | `--version <IPC-2581 standard version>`
        | 要使用的 IPC-2581 标准版本。选项为 `B` 或 `C`（默认）。
    | `--units`
        | 导出时要使用的单位。选项为 `mm`（默认）或 `in`。
    | `--bom-col-int-id`
        | 定义 BOM 中零件内部 ID 的列标题。可以是任何封装字段，或留空以省略该列。
    | `--bom-col-mfg-pn`
        | 定义 BOM 中制造商零件编号名称的列标题。可以是任何封装字段，或留空以省略该列。
    | `--bom-col-mfg`
        | 定义 BOM 中制造商零件的列标题。可以是任何封装字段，或留空以省略该列。
    | `--bom-col-dist-pn`
        | 定义 BOM 中分销商零件编号名称的列标题。可以是任何封装字段，或留空以省略该列。
    | `--bom-col-dist`
        | 定义 BOM 中分销商零件的列标题。可以是任何封装字段，或留空以省略该列。

note: type: Title ===
en: PCB PDF export
zh: PCB PDF 导出

note: type: Plain text
en: The `pcb export pdf` command exports a board design to a PDF file.
zh: 将 `pcb export pdf` 命令导出电路板设计为 PDF 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export pdf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--mirror] [--exclude-refdes] [--exclude-value] [--include-border-title] [--negative] [--black-and-white] [--theme THEME_NAME] [--drill-shape-opt VAR] INPUT_FILE`
zh: 用法： `kicad-cli pcb export pdf [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--mirror] [--exclude-refdes] [--exclude-value] [--include-border-title] [--negative] [--black-and-white] [--theme THEME_NAME] [--drill-shape-opt VAR] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the PDF export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.pdf` file extension.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to export from the board, such as
          `F.Cu,B.Cu`. At least one layer must be given.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-m`, `--mirror`
        | Mirror the board. This can be useful for showing bottom layers.
    | `--erd`, `--exclude-refdes`
        | Exclude footprint reference designators from plot.
    | `--ev`, `--exclude-value`
        | Exclude footprint values from plot.
    | `--ibt`, `--include-border-title`
        | Include the sheet border and title block.
    | `-n`, `--negative`
        | Plot in negative.
    | `--black-and-white`
        | Plot in black and white.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          board editor's currently selected theme is used.
    | `--drill-shape-opt`
        | The shape of drill marks in the plot. Options are `0` for no drill marks,
          `1` for small marks, or `2` for actual size marks (default).
zh: | `-h`, `--help`
        | 显示 PDF 导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 指定输出文件名。如果不使用此参数，输出文件名将与输入文件相同，但后缀为 `.pdf`。
    | `-l <layer list>`, `--layers <layer list>`
        | 从电路板导出的图层名称列表，以逗号分隔，如 `F.Cu,B.Cu`。至少需要指定一个图层。
    | `--drawing-sheet <sheet path>`
        | 指定在绘制过程中使用的图纸路径，覆盖电路板文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    | `-m`, `--mirror`
        | 镜像电路板。这对于显示底层可能很有用。
    | `--erd`, `--exclude-refdes`
        | 在绘制时排除元件封装的位号。
    | `--ev`, `--exclude-value`
        | 在绘制时排除元件封装的值。
    | `--ibt`, `--include-border-title`
        | 包含图纸边框和标题栏。
    | `-n`, `--negative`
        | 以负片形式绘制。
    | `--black-and-white`
        | 以黑白模式绘制。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定导出时使用主题的名称。如果没有给出主题，将使用电路板编辑器当前选定的主题。
    | `--drill-shape-opt`
        | 绘制中钻孔标记的形状选项。可选值为 `0`（无钻孔标记）、`1`（小标记）或 `2`（实际尺寸标记，默认）。

note: type: Title ===
en: PCB position file export
zh: PCB 位置文件导出

note: type: Plain text
en: The `pcb export pos` command exports a position file from a board design.
zh: `pcb export pos` 命令从电路板设计中导出位置文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export pos [--help] [--output OUTPUT_FILE] [--side VAR] [--format FORMAT] [--units UNITS] [--bottom-negate-x] [--use-drill-file-origin] [--smd-only] [--exclude-fp-th] [--exclude-dnp] [--gerber-board-edge] INPUT_FILE`
zh: 用法： `kicad-cli pcb export pos [--help] [--output OUTPUT_FILE] [--side VAR] [--format FORMAT] [--units UNITS] [--bottom-negate-x] [--use-drill-file-origin] [--smd-only] [--exclude-fp-th] [--exclude-dnp] [--gerber-board-edge] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the position file export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.pos` file extension.
    | `--side <side>`
        | The side of the board to export. Options are `front`, `back`, or `both`
          (default). Gerber format does not support `both`.
    | `--format <format>`
        | The position file format. Options are `ascii` (default), `csv`, or
          `gerber`.
    | `--units <unit>`
        | Units for position file. Options are `in` (default) or `mm`. This option
          has no effect for Gerber format.
    | `--bottom-negate-x`
        | Use negative X coordinates for footprints on the bottom layer. This
          option has no effect for Gerber format.
    | `--use-drill-file-origin`
        | Use drill/place file origin instead of absolute origin. This option has no
          effect for Gerber format.
    | `--smd-only`
        | Include only surface-mount components. This option has no effect for
          Gerber format.
    | `--exclude-fp-th`
        | Exclude all footprints with through-hole pads. This option has no effect
          for Gerber format.
    | `--exclude-dnp`
        | Exclude all footprints with "Do not populate" attribute.
    | `--gerber-board-edge`
        | Include board edge layer in export (Gerber format only).
zh: | `-h`, `--help`
        | 显示位置文件导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 设置输出文件名。如果不使用此参数，输出文件名将与输入文件相同，但后缀为 `.pos`。
    | `--side <side>`
        | 指定要导出的电路板面。选项有 `front`（正面）、`back`（背面）或 `both`（双面，默认）。Gerber 格式不支持 `both` 选项。
    | `--format <format>`
        | 位置文件的格式。选项有 `ascii`（默认）、`csv` 或 `gerber`。
    | `--units <unit>`
        | 位置文件中的单位。选项有 `in`（英寸，默认）或 `mm`（毫米）。此选项对 Gerber 格式无效。
    | `--bottom-negate-x`
        | 对底层的元件封装使用负 X 坐标。此选项对 Gerber 格式无效。
    | `--use-drill-file-origin`
        | 使用钻孔/放置文件的原点而非绝对原点。此选项对 Gerber 格式无效。
    | `--smd-only`
        | 只包含表面贴装技术 (SMT) 元件。此选项对 Gerber 格式无效。
    | `--exclude-fp-th`
        | 排除所有带有通孔焊盘的封装。此选项对 Gerber 格式无效。
    | `--exclude-dnp`
        | 排除所有具有 “不安装” (DNP) 属性的封装。
    | `--gerber-board-edge`
        | 导出时包含电路板边缘层（仅限 Gerber 格式）。

note: type: Title ===
en: PCB STEP export
zh: PCB STEP 导出

note: type: Plain text
en: The `pcb export step` command exports a board design to a STEP file.
zh: `pcb export step` 命令将电路板设计导出为 STEP 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export step [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--grid-origin] [--drill-origin] [--no-unspecified] [--no-dnp] [--subst-models] [--board-only] [--include-tracks] [--include-zones] [--min-distance MIN_DIST] [--no-optimize-step] [--user-origin VAR] INPUT_FILE`
zh: 用法： `kicad-cli pcb export step [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--grid-origin] [--drill-origin] [--no-unspecified] [--no-dnp] [--subst-models] [--board-only] [--include-tracks] [--include-zones] [--min-distance MIN_DIST] [--no-optimize-step] [--user-origin VAR] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the STEP file export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.step` file extension.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-f`, `--force`
        | Overwrite output file.
    | `--grid-origin`
        | Use grid origin as origin of output file.
    | `--drill-origin`
        | Use drill origin as origin of output file.
    | `--no-unspecified`
        | Exclude 3D models of components with 'unspecified' footprint type.
    | `--no-dnp`
        | Exclude 3D models of components with 'Do not populate' attribute.
    | `--subst-models`
        | Replace VRML models in footprints with STEP models of the same name, if
          they exist.
    | `--board-only`
        | Only include the board itself in the generated model; exclude all
          component models.
    | `--include-tracks`
        | Include tracks in export (time consuming).
    | `--include-zones`
        | Include zones in export (time consuming).
    | `--min-distance <min distance>`
        | Tolerance for considering two points to be in the same location. Default:
          `0.01mm`.
    | `--no-optimize-step`
        | Do not optimize STEP file. This enables writing parametric curves, which
          reduces file sizes and write/read times, but may reduce compatibility with
          other software.
    | `--user-origin <output origin>`
        | Specify a custom origin for the output file, with X and Y coordinates. For
          example, `1x1in`, `1x1inch`, or `25.4x25.4mm`. The default unit is
          millimeters.
zh: | `-h`, `--help`
        | 显示 STEP 文件导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 设置输出文件名。若省略此参数，输出文件名会与输入文件相同，仅更改后缀为 `.step`。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或重置工程的变量定义。可以多次使用以定义多个变量。
    | `-f`, `--force`
        | 强制覆盖输出文件。
    | `--grid-origin`
        | 使用网格原点作为输出文件的坐标原点。
    | `--drill-origin`
        | 使用钻孔原点作为输出文件的坐标原点。
    | `--no-unspecified`
        | 排除封装类型为“未指定”的元件 3D 模型。
    | `--no-dnp`
        | 排除具有“不安装” (DNP) 属性的元件 3D 模型。
    | `--subst-models`
        | 若有同名的 STEP 模型，则替换封装中的 VRML 模型。
    | `--board-only`
        | 仅包含电路板自身在生成的模型中；排除所有元件模型。
    | `--include-tracks`
        | 导出时包括线路（操作耗时）。
    | `--include-zones`
        | 导出时包括区域（操作耗时）。
    | `--min-distance <min distance>`
        | 定义判断两点位于同一位置的误差。默认值：`0.01 mm`。
    | `--no-optimize-step`
        | 不对 STEP 文件进行优化。这样可以写入参数化曲线，减小文件大小和读写时间，但可能会影响与其他软件的兼容性。
    | `--user-origin <output origin>`
        | 自定义输出文件的坐标原点，包括 X 和 Y 坐标。例如，`1x1in`、`1x1inch` 或 `25.4x25.4mm`。默认单位是毫米。

note: type: Title ===
en: PCB SVG export
zh: PCB SVG 导出

note: type: Plain text
en: The `pcb export svg` command exports a board design to an SVG file.
zh: `pcb export svg` 命令将电路板设计导出为 SVG 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export svg [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--mirror] [--theme THEME_NAME] [--negative] [--black-and-white] [--page-size-mode MODE] [--exclude-drawing-sheet] [--drill-shape-opt SHAPE_OPTION] INPUT_FILE`
zh: 用法： `kicad-cli pcb export svg [--help] [--output OUTPUT_FILE] [--layers LAYER_LIST] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--mirror] [--theme THEME_NAME] [--negative] [--black-and-white] [--page-size-mode MODE] [--exclude-drawing-sheet] [--drill-shape-opt SHAPE_OPTION] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the SVG file export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.svg` file extension.
    | `-l <layer list>`, `--layers <layer list>`
        | A comma-separated list of layer names to export from the board, such as
          `F.Cu,B.Cu`. At least one layer must be given.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the board file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-m`, `--mirror`
        | Mirror the board. This can be useful for showing bottom layers.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          board editor's currently selected theme is used.
    | `-n`, `--negative`
        | Plot in negative.
    | `--black-and-white`
        | Plot in black and white.
    | `--page-size-mode <mode>`
        | Set page sizing mode. Options are `0` (default), `1`, or `2`. `0` sets the
          output page size to fit the entire sheet, including drawing sheet frame
          and title block. `1` sets the output page size to match the current page
          size. `2` sets the output page size to the size of the board itself.
    | `--exclude-drawing-sheet`
        | Plot SVG without a drawing sheet.
    | `--drill-shape-opt`
        | The shape of drill marks in the plot. Options are `0` for no drill marks,
          `1` for small marks, or `2` for actual size marks (default).
zh: | `-h`, `--help`
        | 显示 SVG 文件导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 设定输出文件名。如果不使用此选项，输出文件名将与输入文件相同，仅修改扩展名为 `.svg`。
    | `-l <layer list>`, `--layers <layer list>`
        | 一个由逗号分隔的图层名称列表，用于从电路板导出，例如 `F.Cu,B.Cu`。至少需要给出一个图层。
    | `--drawing-sheet <sheet path>`
        | 指定用于绘图的图纸路径，覆盖电路板文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或重设工程变量定义。可多次使用以定义多个变量。
    | `-m`, `--mirror`
        | 镜像电路板。这对于显示底层很有帮助。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定用于导出的主题名称。如果未给出主题，将使用电路板编辑器当前选定的主题。
    | `-n`, `--negative`
        | 以负片模式绘制。
    | `--black-and-white`
        | 以黑白模式绘制。
    | `--page-size-mode <mode>`
        | 设置页面尺寸模式。选项为 `0`（默认），`1`，或 `2`。`0` 使输出页面尺寸适应整个图纸，包括图纸框架和标题栏。`1` 使输出页面尺寸匹配当前页面尺寸。`2` 使输出页面尺寸与电路板本身尺寸一致。
    | `--exclude-drawing-sheet`
        | 绘制 SVG 时不包含图纸。
    | `--drill-shape-opt`
        | 设定绘图中钻孔标记的形状。选项为 `0` 无钻孔标记，`1` 小标记，或 `2` 实际尺寸标记（默认）。

note: type: Title ===
en: PCB VRML export
zh: PCB VRML 导出

note: type: Plain text
en: The `pcb export vrml` command exports a board design to a VRML 3D file.
zh: `pcb export vrml` 命令将电路板设计导出为 VRML 3D 文件。

note: type: Plain text
en: Usage: `kicad-cli pcb export vrml [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--user-origin VAR] [--units VAR] [--models-dir VAR] [--models-relative] INPUT_FILE`
zh: 用法：`kicad-cli pcb export vrml [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--force] [--user-origin VAR] [--units VAR] [--models-dir VAR] [--models-relative] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the VRML export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with the `.wrl` file extension.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-f`, `--force`
        | Overwrite output file.
    | `--user-origin <output origin>`
        | Specify a custom origin for the output file, with X and Y coordinates. For
          example, `1x1in`, `1x1inch`, or `25.4x25.4mm`. The default unit is
          millimeters. If this option is not given, the board center is used.
    | `--units <units>`
        | Units to use in the output file. Options are `mm`, `m`, `in` (default), or
          `tenths` (tenths of an inch).
    | `--models-dir <output model directory>`
        | Name of output directory to copy component models into. If not used,
          component models are embedded into the output file.
    | `--models-relative`
        | With `--models-dir`, use relative paths in the output file.
zh: | `-h`, `--help`
        | 显示 VRML 导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 输出文件名。当没有使用这个参数时，输出文件名将与输入文件相同，只是扩展名改为 `.wrl`。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可以多次使用来定义多个变量。
    | `-f`, `--force`
        | 强制覆盖输出文件。
    | `--user-origin <output origin>`
        | 指定输出文件的自定义原点，带有 X 和 Y 坐标。例如，`1x1in`，`1x1inch`，或 `25.4x25.4mm`。默认单位是毫米。如果没有给出这个选项，将使用板中心作为原点。
    | `--units <units>`
        | 输出文件中使用的单位。选项有 `mm`，`m`，`in`（默认），或 `tenths`（英寸的十分之一）。
    | `--models-dir <output model directory>`
        | 将元件模型复制到的输出目录名称。如果不使用，元件模型将嵌入到输出文件中。
    | `--models-relative`
        | 在使用 `--models-dir` 时，在输出文件中使用相对路径。

note: type: Title ==
en: Schematic commands
zh: 原理图命令

note: type: Plain text
en: The `sch` command runs an electrical rule check, exports a schematic to various other file formats, or exports a bill of materials or netlist. Each subcommand has its own options.
zh: `sch` 命令用于运行电气规则检查，将原理图导出为其他各种文件格式，或导出物料清单或网表。每个子命令都有自己的选项。

note: type: Title ===
en: Schematic ERC
zh: 原理图 ERC

note: type: Plain text
en: The `sch erc` command runs an electrical rule check on a schematic and generates a report.
zh: `sch erc` 命令对原理图运行电气规则检查并生成报告。

note: type: Plain text
en: Usage: `kicad-cli sch erc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format VAR] [--units VAR] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE`
zh: 用法： `kicad-cli sch erc [--help] [--output OUTPUT_FILE] [--define-var KEY=VALUE] [--format VAR] [--units VAR] [--severity-all] [--severity-error] [--severity-warning] [--severity-exclusions] [--exit-code-violations] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Schematic file to run ERC on.
zh: | `INPUT_FILE`
        | 运行 ERC 的原理图文件。

note: type: Table
en: | `-h`, `--help`
        | Show help for the ERC command.
    | `-o <output filename>, `--output <output filename>`
        | Output filename for the generated ERC report. When this argument is not
          used, the output filename will be the same as the input file, with the
          `.rpt` or `.json` file extension, depending on the selected format.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `--format <format>`
        | Report file format. Options are `report` (default) or `json`.
    | `--units <unit>`
        | Units to use in the report. Options are `mm` (default), `in`, or `mils`.
    | `--severity-all`
        | Report all ERC violations. This is equivalent to using all of the other
          ERC severity options.
    | `--severity-error`
        | Report all error-level ERC violations. This can be combined with the other
          ERC severity options.
    | `--severity-warning`
        | Report all warning-level ERC violations. This can be combined with the
          other ERC severity options.
    | `--severity-exclusions`
        | Report all excluded ERC violations. This can be combined with the other
          ERC severity options.
    | `--exit-code-violations`
        | Return an exit code depending on whether or not ERC violations exist. The
          exit code is 0 if no violations are found, and 5 if any violations are
          found.
zh: | `-h`, `--help`
        | 显示 ERC 命令的帮助信息。
    | `-o <output filename>, `--output <output filename>`
        | 生成的 ERC 报告的输出文件名。如果不使用此参数，输出文件名将与输入文件相同，后缀为 `.rpt` 或 `.json`，具体取决于所选的格式。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可以多次使用以定义多个变量。
    | `--format <format>`
        | 报告文件格式。选项有 `report`（默认）或 `json`。
    | `--units <unit>`
        | 报告中使用的单位。选项有 `mm`（默认）、`in` 或 `mils`。
    | `--severity-all`
        | 报告所有 ERC 违规。这相当于使用所有其他 ERC 严重性选项。
    | `--severity-error`
        | 报告所有错误级别的 ERC 违规。可以与其他 ERC 严重性选项组合使用。
    | `--severity-warning`
        | 报告所有警告级别的 ERC 违规。可以与其他 ERC 严重性选项组合使用。
    | `--severity-exclusions`
        | 报告所有被排除的 ERC 违规。可以与其他 ERC 严重性选项组合使用。
    | `--exit-code-violations`
        | 根据是否存在 ERC 违规返回退出代码。如果未发现违规，则退出代码为 `0`；如果找到任何违规，则退出代码为 `5`。

note: type: Title ===
en: Schematic bill of materials export
zh: 原理图物料清单导出

note: type: Plain text
en: The `sch export bom` command exports a BOM from a schematic.  The BOM export has a number of options for controlling the format and included fields. This export method is equivalent to xref:../eeschema/eeschema.adoc#bom-export[exporting a BOM] from the symbol fields table.
zh: `sch export bom` 命令从原理图中导出 BOM。 BOM 导出具有许多用于控制格式和包含字段的选项。此导出方法等同于 xref:../eeschema/eeschema.adoc#bom-export[导出 BOM] 从符号字段表。

note: type: Plain text
en: To export a BOM using the legacy XML and Python BOM script workflow, use
          the `sch export python-bom` command.
zh: 要使用旧版 XML 和 Python BOM 脚本工作流导出 BOM，请使用 `sch export python-bom` 命令。

note: type: Plain text
en: Usage: `kicad-cli sch export bom [--help] [--output OUTPUT_FILE] [--preset PRESET] [--format-preset FMT_PRESET] [--fields FIELDS] [--labels LABELS] [--group-by GROUP_BY] [--sort-field SORT_BY] [--sort-asc] [--filter FILTER] [--exclude-dnp] [--field-delimiter FIELD_DELIM] [--string-delimiter STR_DELIM] [--ref-delimiter REF_DELIM] [--ref-range-delimiter REF_RANGE_DELIM] [--keep-tabs] [--keep-line-breaks] INPUT_FILE`
zh: 用法： `kicad-cli sch export bom [--help] [--output OUTPUT_FILE] [--preset PRESET] [--format-preset FMT_PRESET] [--fields FIELDS] [--labels LABELS] [--group-by GROUP_BY] [--sort-field SORT_BY] [--sort-asc] [--filter FILTER] [--exclude-dnp] [--field-delimiter FIELD_DELIM] [--string-delimiter STR_DELIM] [--ref-delimiter REF_DELIM] [--ref-range-delimiter REF_RANGE_DELIM] [--keep-tabs] [--keep-line-breaks] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Schematic file to export.
zh: | `INPUT_FILE`
        | 要导出的原理图文件。

note: type: Table
en: | `-h`, `--help`
        | Shows help message and exits
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with a `.csv` file extension.
    | `--preset <preset>`
        | Use a named BOM preset setting from the schematic, e.g. `"Grouped By Value"`.
    | `--format-preset <format preset>`
        | Use a named BOM format preset setting from the schematic, e.g. `CSV`.
    | `--fields <fields>`
        | An ordered list of fields to export. `*` includes all fields. Special
          symbol fields such as DNP or Exclude from board can be accessed with
          `${DNP}` or `${EXCLUDE_FROM_BOARD}`, respectively (see the
          xref:../eeschema/eeschema.adoc#text-variables[text variable documentation]
          for a list of fields). Default: "Reference,Value,Footprint,${QUANTITY},${DNP}".
    | `--labels <labels>`
        | An ordered list of labels to apply the exported fields (default:
          "Refs,Value,Footprint,Qty,DNP").
    | `--group-by <fields>`
        | Fields to group references by when field values match.
    | `--sort-field <fields>`
        | Field name to sort by (default: "Reference").
    | `--sort-asc`
        | If given, sort in ascending order. If not given, sort in descending order.
    | `--filter <filter>`
        | Filter string to remove output lines.
    | `--exclude-dnp`
        | Exclude symbols with the "Do not populate" attribute.
    | `--field-delimiter <delimiter>`
        | Separator between output fields/columns (default: ",").
    | `--string-delimiter <delimiter>`
        | Character to surround fields with (none by default).
    | `--ref-delimiter <delimiter>`
        | Character to place between individual references (default: ",").
    | `--ref-range-delimiter <delimiter>`
        | Character to place in ranges of references (default: "-"). Leave blank for
          no ranges.
    | `--keep-tabs`
        | Keep tab characters from input fields. Stripped by default.
    | `--keep-line-breaks`
        | Keep line break characters from input fields. Stripped by default.
zh: | `-h`, `--help`
        | 显示帮助信息并退出。
    | `-o <output filename>`, `--output <output filename>`
        | 输出文件的名称。如果不使用此参数，输出文件名将与输入文件相同，但具有 `.csv` 的文件扩展名。
    | `--preset <preset>`
        | 使用原理图中的命名 BOM 预设设置，例如 `"按值分组"`。
    | `--format-preset <format preset>`
        | 使用原理图中的命名 BOM 格式预设设置，例如 `CSV`。
    | `--fields <fields>`
        | 要导出的有序字段列表。`*` 表示包含所有字段。特殊符号字段如不安装 (DNP) 或排除在电路板上 (Exclude from board) 可以通过 `${DNP}` 或 `${EXCLUDE_FROM_BOARD}` 访问（参见文本变量文档以获取字段列表）。默认："Reference（位号）,Value（值）,Footprint（封装）,${QUANTITY}（数量）,${DNP}（不安装）"。 
    | `--labels <labels>`
        | 应用于导出字段的有序标签列表（默认："Refs（位号）,Value（值）,Footprint（封装）,Qty（数量）,DNP（不安装）"）。
    | `--group-by <fields>`
        | 当字段值匹配时，用于对位号进行分组的字段。
    | `--sort-field <fields>`
        | 排序依据的字段名称（默认："Reference（位号）"）。
    | `--sort-asc`
        | 如果给出，则按升序排序。如果没有给出，则按降序排序。
    | `--filter <filter>`
        | 移除输出行的过滤字符串。
    | `--exclude-dnp`
        | 排除具有“不安装” (DNP) 属性的符号。
    | `--field-delimiter <delimiter>`
        | 输出字段/列之间的分隔符（默认：","）。
    | `--string-delimiter <delimiter>`
        | 包裹字段的字符（默认不使用）。
    | `--ref-delimiter <delimiter>`
        | 单个位号之间的分隔符（默认：","）。
    | `--ref-range-delimiter <delimiter>`
        | 位号范围内的分隔符（默认："-"）。留空则无范围。
    | `--keep-tabs`
        | 保留输入字段中的制表符。默认会去除。
    | `--keep-line-breaks`
        | 保留输入字段中的换行符。默认会去除。

note: type: Title ===
en: Schematic DXF export
zh: 原理图 DXF 导出

note: type: Plain text
en: The `sch export dxf` command exports a schematic to a DXF file. Each sheet in the design is exported to its own file.
zh: `sch export dxf` 命令将原理图导出到 DXF 文件。设计中的每个图纸都导出到其自己的文件中。

note: type: Plain text
en: Usage: `kicad-cli sch export dxf [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--pages PAGE_LIST] INPUT_FILE`
zh: 用法： `kicad-cli sch export dxf [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--pages PAGE_LIST] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the DXF file export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the schematic file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          schematic editor's currently selected theme is used.
    | `-b`, `--black-and-white`
        | Export schematic in black and white.
    | `-e`, `--exclude-drawing-sheet`
        | Plot DXF without a drawing sheet.
    | `--pages <page list>`
        | Comma-separated list of pages to export. Blank or unspecified means all
          pages. To plot specific pages, give the root sheet as `INPUT_FILE` and
          specify the desired output pages with the `--pages` argument.
zh: | `-h`, `--help`
        | 显示 DXF 文件导出命令的帮助信息。
    | `-o <output dir>`, `--output <output dir>`
        | 导出文件的目标文件夹。如果不使用此参数，文件将被导出到当前目录。
    | `--drawing-sheet <sheet path>`
        | 在绘制中使用的图纸路径，这将覆盖原理图文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可以多次使用来定义多个变量。
    | `-t <theme name>`, `--theme <theme name>`
        | 用于导出的主题名称。如果未给出主题，将使用原理图编辑器当前选择的主题。
    | `-b`, `--black-and-white`
        | 将原理图以黑白模式导出。
    | `-e`, `--exclude-drawing-sheet`
        | 不使用图纸直接绘制 DXF。
    | `--pages <page list>`
        | 要导出的页面的逗号分隔列表。空白或未指定则意味着导出所有页面。为了绘制特定页面，将根图纸作为 `INPUT_FILE` 给出，并使用 `--pages` 参数指定所需的输出页面。

note: type: Title ===
en: Schematic HPGL export
zh: 原理图 HPGL 导出

note: type: Plain text
en: The `sch export hpgl` command exports a schematic to an HPGL file for a pen plotter. Each sheet in the design is exported to its own file.
zh: `sch export hpgl` 命令将原理图导出到笔式绘图仪的 HPGL 文件中。设计中的每个图纸都导出到其自己的文件中。

note: type: Plain text
en: Usage: `kicad-cli sch export hpgl [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-drawing-sheet] [--pages PAGE_LIST] [--pen-size PEN_SIZE] [--origin ORIGIN] INPUT_FILE`
zh: 用法： `kicad-cli sch export hpgl [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--exclude-drawing-sheet] [--pages PAGE_LIST] [--pen-size PEN_SIZE] [--origin ORIGIN] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the HPGL file export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the schematic file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-e`, `--exclude-drawing-sheet`
        | Plot HPGL without a drawing sheet.
    | `--pages <page list>`
        | Comma-separated list of pages to export. Blank or unspecified means all
          pages. To plot specific pages, give the root sheet as `INPUT_FILE` and
          specify the desired output pages with the `--pages` argument.
    | `-p <pen size>`, `--pen-size <pen size>`
        | Set the pen width. The default pen size is 0.5 mm.
    | `-r <origin>`, `--origin <origin>`
        | Set plotter origin and scale. Options are `0`, `1` (default), `2`, or `3`.
          `0` sets the origin to the bottom left and uses plotter units. `1` sets
          the origin to the center and uses plotter units. `2` scales to the page,
          and `3` scales to the content within the page.
zh: | `-h`, `--help`
        | 显示 HPGL 文件导出命令的帮助信息。
    | `-o <output dir>`, `--output <output dir>`
        | 导出文件的目标文件夹。如果不使用此参数，文件将被导出到当前工作目录。
    | `--drawing-sheet <sheet path>`
        | 用于绘制图纸路径，这将覆盖原理图文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>` 
        | 添加或覆盖工程中的变量定义。可多次使用以定义多个变量。
    | `-e`, `--exclude-drawing-sheet`
        | 不使用图纸背景，仅绘制 HPGL 数据。
    | `--pages <page list>`
        | 要导出的页面列表，由逗号分隔。留空或不指定则默认导出所有页面。若要绘制特定页面，请将根图纸作为 `INPUT_FILE` 并使用 `--pages` 参数指定所需输出的页面。
    | `-p <pen size>`, `--pen-size <pen size>`
        | 设置笔触宽度。默认笔宽为 0.5 mm。
    | `-r <origin>`, `--origin <origin>`
        | 设置绘图仪原点和比例。可选值为 `0`、`1`（默认）、`2` 或 `3`。`0` 将原点设置在左下角并使用绘图仪单位；`1` 将原点设置在中心并使用绘图仪单位；`2` 按页面比例缩放；`3` 按页面内内容进行缩放。

note: type: Title ===
en: Schematic netlist export
zh: 原理图网表导出

note: type: Plain text
en: The `sch export netlist` command exports a netlist in xref:../eeschema/eeschema.adoc#netlist-formats[various formats] from a schematic.
zh: `sch export netlist` 命令以 xref:../eeschema/eeschema.adoc#netlist-formats[各种格式] 格式导出网表。

note: type: Plain text
en: Usage: `kicad-cli sch export netlist [--help] [--output OUTPUT_FILE] [--format FORMAT] INPUT_FILE`
zh: 用法： `kicad-cli sch export netlist [--help] [--output OUTPUT_FILE] [--format FORMAT] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the netlist export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with a `.net` file extension.
    | `-f <format>`, `--format <format>`
        | The netlist output format. Options are `kicadsexpr` (default), `kicadxml`,
          `cadstar`, `orcadpcb2`, `spice`, or `spicemodel`.
zh: | `-h`, `--help`
        | 显示网络表导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 指定输出文件的名称。如果不使用此参数，输出文件名将与输入文件相同，但文件扩展名会更改为 `.net`。
    | `-f <format>`, `--format <format>`
        | 网络表输出的格式。可选项包括 `kicadsexpr`（默认）、`kicadxml`、`cadstar`、`orcadpcb2`、`spice` 或 `spicemodel`。

note: type: Title ===
en: Schematic PDF export
zh: 原理图 PDF 导出

note: type: Plain text
en: The `sch export pdf` command exports a schematic to a PDF file. Each sheet in the design is exported to its own page in the PDF file.
zh: `sch export pdf` 命令将原理图导出为 PDF 文件。设计中的每张图纸都会导出到 PDF 文件中的单独页面。

note: type: Plain text
en: Usage: `kicad-cli sch export pdf [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--exclude-pdf-property-popups] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`
zh: 用法： `kicad-cli sch export pdf [--help] [--output OUTPUT_FILE] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--exclude-pdf-property-popups] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the PDF file export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with a `.pdf` file extension.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the schematic file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          schematic editor's currently selected theme is used.
    | `-b`, `--black-and-white`
        | Export schematic in black and white.
    | `-e`, `--exclude-drawing-sheet`
        | Plot PDF without a drawing sheet.
    | `--exclude-pdf-property-popups`
        | Do not generate property popups in PDF.
    | `-n`, `--no-background-color`
        | Export schematic without a background color, regardless of theme.
    | `--pages <page list>`
        | Comma-separated list of pages to export. Blank or unspecified means all
          pages. To plot specific pages, give the root sheet as `INPUT_FILE` and
          specify the desired output pages with the `--pages` argument.
zh: | `-h`, `--help`
        | 显示 PDF 文件导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 指定输出文件的名称。如果不使用此参数，输出文件名将与输入文件相同，但文件扩展名会更改为 `.pdf`。
    | `--drawing-sheet <sheet path>`
        | 指定在绘制中使用的图纸路径，覆盖原理图文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可以多次使用来定义多个变量。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定用于导出的主题名称。如果未给定主题，则使用原理图编辑器当前选择的主题。
    | `-b`, `--black-and-white`
        | 以黑白模式导出原理图。
    | `-e`, `--exclude-drawing-sheet`
        | 导出 PDF 时不包含图纸。
    | `--exclude-pdf-property-popups`
        | 不在 PDF 中生成属性弹窗。
    | `-n`, `--no-background-color`
        | 不使用背景色导出原理图，无论所选主题如何。
    | `--pages <page list>`
        | 要导出的页面列表，以逗号分隔。空白或未指定则意味着所有页面。为了导出特定页面，将根图纸作为 `INPUT_FILE`，并使用 `--pages` 参数指定所需的输出页面。

note: type: Title ===
en: Schematic PostScript export
zh: 原理图 PostScript 导出

note: type: Plain text
en: The `sch export ps` command exports a schematic to a PostScript file. Each sheet in the design is exported to its own file.
zh: `sch export ps` 命令将原理图导出到 PostScript 文件。设计中的每个图纸都导出到其自己的文件中。

note: type: Plain text
en: Usage: `kicad-cli sch export ps [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`
zh: 用法： `kicad-cli sch export ps [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`

note: type: Table
en: | `INPUT_DIR`
        | Schematic file to export.
zh: | `INPUT_DIR`
        | 要导出的原理图文件。

note: type: Table
en: | `-h`, `--help`
        | Show help for the PS file export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the schematic file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          schematic editor's currently selected theme is used.
    | `-b`, `--black-and-white`
        | Export schematic in black and white.
    | `-e`, `--exclude-drawing-sheet`
        | Plot PS without a drawing sheet.
    | `-n`, `--no-background-color`
        | Export schematic without a background color, regardless of theme.
    | `--pages <page list>`
        | Comma-separated list of pages to export. Blank or unspecified means all
          pages. To plot specific pages, give the root sheet as `INPUT_FILE` and
          specify the desired output pages with the `--pages` argument.
zh: | `-h`, `--help`
        | 显示 PS 文件导出命令的帮助信息。
    | `-o <output dir>`, `--output <output dir>`
        | 指定导出文件的目标文件夹。如果不使用此参数，文件将被导出到当前目录。
    | `--drawing-sheet <sheet path>`
        | 指定绘制中要使用的图纸路径，覆盖原理图文件中指定的图纸。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用来定义多个变量。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定用于导出的主题名称。若不给出主题，则使用原理图编辑器当前选定的主题。
    | `-b`, `--black-and-white`
        | 以黑白模式导出原理图。
    | `-e`, `--exclude-drawing-sheet`
        | 绘制 PS 文件时排除图纸。
    | `-n`, `--no-background-color`
        | 导出原理图时不使用背景色，不论主题设置。
    | `--pages <page list>`
        | 要导出的页面列表，以逗号分隔。留空或未指定则表示所有页面。为了导出特定页面，将根图纸作为 `INPUT_FILE`，并利用 `--pages` 参数指定所需导出的页面。

note: type: Title ===
en: Schematic bill of materials export (legacy BOM scripts)
zh: 原理图物料清单导出（旧版 BOM 脚本）

note: type: Plain text
en: The `sch export python-bom` command exports an XML BOM file from a schematic.  The XML BOM file can then be processed into your desired BOM format using a custom script or one of the scripts described in the xref:../eeschema/eeschema.adoc#bom-export[schematic BOM export documentation].
zh: `sch export python-bom` 命令从原理图中导出XML BOM文件。 然后，可以使用自定义脚本或外部参照中描述的脚本之一将 XML BOM 文件处理为所需的 BOM 格式： xref:../eeschema/eeschema.adoc#bom-export[原理图 BOM 导出文档]。

note: type: Plain text
en: Usage: `kicad-cli sch export python-bom [--help] [--output OUTPUT_FILE] INPUT_FILE`
zh: 用法： `kicad-cli sch export python-bom [--help] [--output OUTPUT_FILE] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the BOM export command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename. When this argument is not used, the output filename
          will be the same as the input file, with a `-bom.xml` suffix and file
          extension.
zh: | `-h`, `--help`
        | 显示 BOM 导出命令的帮助信息。
    | `-o <output filename>`, `--output <output filename>`
        | 指定输出文件的文件名。如果不使用此参数，输出文件名将默认与输入文件相同，仅在原文件名后添加 `-bom.xml` 后缀及文件扩展名。

note: type: Title ===
en: Schematic SVG export
zh: 原理图 SVG 导出

note: type: Plain text
en: The `sch export svg` command export a schematic to an SVG file. Each sheet in the design is exported to its own file.
zh: `sch export svg` 命令将原理图导出为 SVG 文件。设计中的每个图纸都导出到其自己的文件中。

note: type: Plain text
en: Usage: `kicad-cli sch export svg [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`
zh: 用法： `kicad-cli sch export svg [--help] [--output OUTPUT_DIR] [--drawing-sheet SHEET_PATH] [--define-var KEY=VALUE] [--theme THEME_NAME] [--black-and-white] [--exclude-drawing-sheet] [--no-background-color] [--pages PAGE_LIST] INPUT_FILE`

note: type: Table
en: | `-h`, `--help`
        | Show help for the SVG file export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `--drawing-sheet <sheet path>`
        | Path to drawing sheet to use in plot, overriding the drawing sheet
          specified in the schematic file.
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | Add or override project variable definitions. Can be used multiple times
          to define multiple variables.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the
          schematic editor's currently selected theme is used.
    | `-b`, `--black-and-white`
        | Export schematic in black and white.
    | `-e`, `--exclude-drawing-sheet`
        | Plot SVG without a drawing sheet.
    | `-n`, `--no-background-color`
        | Export schematic without a background color, regardless of theme.
    | `--pages <page list>`
        | Comma-separated list of pages to export. Blank or unspecified means all
          pages. To plot specific pages, give the root sheet as `INPUT_FILE` and
          specify the desired output pages with the `--pages` argument.
zh: | `-h`, `--help`
        | 显示 SVG 文件导出命令的帮助信息。
    | `-o <output dir>`, `--output <output dir>`
        | 指定导出文件的目标文件夹。如果不使用此参数，文件将被导出到当前工作目录。
    | `--drawing-sheet <sheet path>`
        | 指定用于绘制的图纸路径，覆盖原理图文件中指定的图纸设置。
    | `-D <variable name>=<value>`, `--define-var <variable_name>=<value>`
        | 添加或覆盖工程变量定义。可多次使用以定义多个变量。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定用于导出的主题名称。若未指定主题，则使用原理图编辑器中当前选定的主题。
    | `-b`, `--black-and-white`
        | 以黑白模式导出原理图。
    | `-e`, `--exclude-drawing-sheet`
        | 在不使用图纸的情况下绘制 SVG。
    | `-n`, `--no-background-color`
        | 导出原理图时不包含背景颜色，不受主题影响。
    | `--pages <page list>`
        | 要导出的页面列表，由逗号分隔。留空或未指定则表示所有页面。要导出特定页面，请将根图纸作为 `INPUT_FILE`，并使用 `--pages` 参数指定所需的输出页面。

note: type: Title ==
en: Symbol commands
zh: 符号命令

note: type: Plain text
en: The `sym` subcommand exports symbols to another format or upgrades symbol libraries to the current version of the KiCad symbol file format.
zh: `sym` 子命令将符号导出为另一种格式，或将符号库升级到 KiCad 符号文件格式的当前版本。

note: type: Title ===
en: Symbol export
zh: 符号导出

note: type: Plain text
en: The `sym export svg` command exports one or more symbols from the specified library into SVG files.
zh: `sym export svg` 命令将指定库中的一个或多个符号导出到 SVG 文件中。

note: type: Plain text
en: Usage: `kicad-cli sym export svg [--help] [--output OUTPUT_DIR] [--theme THEME_NAME] [--symbol SYMBOL] [--black-and-white] [--include-hidden-pins] [--include-hidden-fields] INPUT_FILE`
zh: 用法： `kicad-cli sym export svg [--help] [--output OUTPUT_DIR] [--theme THEME_NAME] [--symbol SYMBOL] [--black-and-white] [--include-hidden-pins] [--include-hidden-fields] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Symbol library file to use for export.
zh: | `INPUT_FILE`
        | 用于导出的符号库文件。

note: type: Table
en: | `-h`, `--help`
        | Show help for the symbol SVG export command.
    | `-o <output dir>`, `--output <output dir>`
        | The output folder for the exported files. When this argument is not used,
          the files are exported to the current directory.
    | `-t <theme name>`, `--theme <theme name>`
        | The name of the theme to use for export. If no theme is given, the symbol
          editor's currently selected theme is used.
    | `-s <symbol name>`, `--symbol <symbol name>`
        | The specific symbol to export from the library. When this argument is
          not used, all symbols in the library are exported.
    | `--black-and-white`
        | Export symbols in black and white.
    | `--include-hidden-pins`
        | Export hidden pins in the exported SVG.
    | `--include-hidden-fields`
        | Export hidden symbol fields in the exported SVG.
zh: | `-h`, `--help`
        | 显示符号 SVG 导出命令的帮助信息。
    | `-o <output dir>`, `--output <output dir>`
        | 设置导出文件的输出文件夹。如果未使用此参数，文件将被导出到当前目录。
    | `-t <theme name>`, `--theme <theme name>`
        | 指定用于导出的主题名称。如果没有给出主题，则使用符号编辑器中当前选择的主题。
    | `-s <symbol name>`, `--symbol <symbol name>`
        | 指定从库中导出的特定符号。如果未使用此参数，则会导出库中的所有符号。
    | `--black-and-white`
        | 以黑白模式导出符号。
    | `--include-hidden-pins`
        | 在导出的 SVG 中包含隐藏引脚。
    | `--include-hidden-fields`
        | 在导出的 SVG 中包含隐藏的符号字段。

note: type: Title ===
en: Symbol upgrade
zh: 符号升级

note: type: Plain text
en: The `sym upgrade` command upgrades the the specified symbol library from a legacy symbol format to the native format for the current version of KiCad. If the input library is already in the current file format, no action is taken.
zh: `sym upgrade` 命令将指定的符号库从传统符号格式升级到当前版本的 KiCad 的原生格式。如果输入库已采用当前文件格式，则不执行任何操作。

note: type: Plain text
en: Usage: `kicad-cli sym upgrade [--help] [--output OUTPUT_FILE] [--force] INPUT_FILE`
zh: 用法： `kicad-cli sym upgrade [--help] [--output OUTPUT_FILE] [--force] INPUT_FILE`

note: type: Table
en: | `INPUT_FILE`
        | Symbol library to upgrade.
zh: | `INPUT_FILE`
        | 要升级的符号库。

note: type: Table
en: | `-h`, `--help`
        | Show help for the symbol upgrade command.
    | `-o <output filename>`, `--output <output filename>`
        | The output filename for the upgraded symbol library. When this argument is
          not used, the upgraded symbol library is saved over the original library.
    | `--force`
        | Re-save the input library even if it is already in the current file format.
zh: | `-h`, `--help`
        | 显示符号升级命令的帮助信息。.
    | `-o <output filename>`, `--output <output filename>`
        | 指定升级后符号库的输出文件名。如果不使用此参数，升级后的符号库将覆盖原来的库文件。
    | `--force`
        | 即使输入的库已经是当前文件格式，也强制重新保存库文件。

note: type: Title ==
en: Version commands
zh: 版本命令

note: type: Plain text
en: The `version` subcommand prints the KiCad version. Without any arguments, it simply prints the version number, for example `7.0.7`. You can print the version in several other formats using the `--format` argument.
zh: `version` 子命令打印 KiCad 版本。没有任何参数，它只打印版本号，例如 `7.0.7`。您可以使用 `--format` 参数以其他几种格式打印版本。

note: type: Plain text
en: Use `kicad-cli version --format about` for version information to include
          when submitting bug reports or feature requests on Gitlab.
zh: 在 Gitlab 上提交错误报告或功能请求时，请使用 `kicad-cli version --format about` 获取要包含的版本信息。

note: type: Plain text
en: Usage: `kicad-cli version [--help] [--format VAR]`
zh: 用法： `kicad-cli version [--help] [--format VAR]`

note: type: Table
en: | `--format <format>`
        | Format of the version number. Options are `plain` (default), `commit`, or
          `about`. `plain` prints the version number (e.g. `7.0.7`), which is the
          default if the `--format` argument is not used. `commit` prints the hash
          of the git commit for the build of KiCad you are using. `about` prints the
          full version information, including library versions and basic system
          information. You can use the `about` version information in bug reports.
zh: | `--format <format>`
        | 版本号的格式。选项为 `plain`（默认）、`commit` 或 `about`。`plain` 打印版本号（例如 `7.0.7`），如果不使用 `--format` 参数，则为默认值。`commit` 打印您正在使用的 KiCad 构建的 git commit 的哈希值。`about` 打印完整版本信息，包括库版本和基本系统信息。您可以在 Bug 报告中使用 `关于` 版本信息。
