kicad/README.md

62 lines
4.5 KiB
Markdown
Raw Normal View History

2020-05-15 13:45:29 +00:00
# KiCad README
For specific documentation about [building KiCad](https://dev-docs.kicad.org/en/build/), policies
and guidelines, and source code documentation see the
[Developer Documentation](https://dev-docs.kicad.org) website.
2020-05-15 13:45:29 +00:00
2020-05-22 00:03:01 +00:00
You may also take a look into the [Wiki](https://gitlab.com/kicad/code/kicad/-/wikis/home),
the [contribution guide](https://dev-docs.kicad.org/en/contribute/).
For general information about KiCad and information about contributing to the documentation and
libraries, see our [Website](https://kicad.org/) and our [Forum](https://forum.kicad.info/).
2020-05-15 13:45:29 +00:00
## Build state
[<img alt="Jenkins" src="https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.simonrichter.eu%2Fview%2FKiCad%2520Status%2Fjob%2Flinux-kicad-head%2F&label=Linux%2C%20amd64&style=plastic">](https://jenkins.simonrichter.eu/view/KiCad%20Status/job/linux-kicad-head/)
[<img alt="Jenkins" src="https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.simonrichter.eu%2Fview%2FKiCad%2520Status%2Fjob%2Fwindows-kicad-msvc-head%2F&label=Windows%2C%20MSVC&style=plastic">](https://jenkins.simonrichter.eu/view/KiCad%20Status/job/windows-kicad-msvc-head/)
[<img alt="Jenkins" src="https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.simonrichter.eu%2Fview%2FKiCad%2520Status%2Fjob%2Fwindows-kicad-msys2-pipeline%2F&label=%28Windows%2C%20MSYS2%29%20Nightly%20Build&style=plastic">](https://jenkins.simonrichter.eu/view/KiCad%20Status/job/windows-kicad-msys2-pipeline/)
## Release status
[![latest released version(s)](https://repology.org/badge/latest-versions/kicad.svg)](https://repology.org/project/kicad/versions)
[![Release status](https://repology.org/badge/tiny-repos/kicad.svg)](https://repology.org/metapackage/kicad/versions)
## Files
* [AUTHORS.txt](AUTHORS.txt) - The authors, contributors, document writers and translators list
* [CMakeLists.txt](CMakeLists.txt) - Main CMAKE build tool script
* [copyright.h](copyright.h) - A very short copy of the GNU General Public License to be included in new source files
* [CTestConfig.cmake](CTestConfig.cmake) - Support for CTest and CDash testing tools
* [Doxyfile](Doxyfile) - Doxygen config file for KiCad
* [INSTALL.txt](INSTALL.txt) - The release (binary) installation instructions
* [uncrustify.cfg](uncrustify.cfg) - Uncrustify config file for uncrustify sources formatting tool
* [_clang-format](_clang-format) - clang config file for clang-format sources formatting tool
## Subdirectories
* [3d-viewer](3d-viewer) - Sourcecode of the 3D viewer
2021-04-04 06:53:04 +00:00
* [bitmap2component](bitmap2component) - Sourcecode of the bitmap to PCB artwork converter
2020-05-15 13:45:29 +00:00
* [bitmaps_png](bitmaps_png) - Menu and program icons
* [CMakeModules](CMakeModules) - Modules for the CMAKE build tool
* [common](common) - Sourcecode of the common library
* [cvpcb](cvpcb) - Sourcecode of the CvPCB tool
* [demos](demos) - Some demo examples
* [Documentation](Documentation) - Developer documentation (deprecated; moved to [https://dev-docs.kicad.org](https://dev-docs.kicad.org))
2020-05-15 13:45:29 +00:00
* [eeschema](eeschema) - Sourcecode of the schematic editor
* [gerbview](gerbview) - Sourcecode of the gerber viewer
* [helpers](helpers) - Helper tools and utilities for development
* [include](include) - Interfaces to the common library
* [kicad](kicad) - Sourcecode of the project manager
2021-04-04 06:53:04 +00:00
* [libs](libs) - Sourcecode of KiCad utilities (geometry and others)
2020-05-15 13:45:29 +00:00
* [pagelayout_editor](pagelayout_editor) - Sourcecode of the pagelayout editor
* [patches](patches) - Collection of patches for external dependencies
* [pcbnew](pcbnew) - Sourcecode of the printed circuit board editor
2021-04-04 06:53:04 +00:00
* [plugins](plugins) - Sourcecode for the 3D viewer plugins
2020-06-19 11:34:15 +00:00
* [qa](qa) - Unit testing framework for KiCad
* [resources](resources) - Packaging resources for various operating systems
2020-05-15 13:45:29 +00:00
* [scripting](scripting) - SWIG Python scripting definitions and build scripts
* [scripts](scripts) - Example scripts for distribution with KiCad
2020-06-19 11:34:15 +00:00
* [template](template) - Project template
2021-04-04 06:53:04 +00:00
* [thirdparty](thirdparty) - Sourcecode of external libraries used in KiCad but not written by the KiCad team
2020-05-15 13:45:29 +00:00
* [tools](tools) - Other miscellaneous helpers for testing
* [translation](translation) - Translation data files (managed through [Weblate](https://hosted.weblate.org/projects/kicad/master-source/) for most languages)
2021-04-04 06:53:04 +00:00
* [utils](utils) - Small utils for KiCad, e.g. IDF, STEP, and OGL tools and converters