What is GitBuilding
GitBuilding is a program for documenting hardware designs. It's primary focus is on high-quality, up-to-date assembly instructions. GitBuilding gives you the freedom to write instructions in the form and structure that you want using markdown. It uses extra metadata to track component usage, and generate bills of materials. Independent, clear, and consistent documentation can be generated for variations of the same design without specifying the same information multiple times.
In GitBuilding you are able to:
- Write the instructions as you go along in markdown
- Tag links in the code with meta-data to show if they are steps in the build or parts that are needed
- Automatically generate bills of materials
- Create templates for instructions that render differently for different configurations of a design
- 3D preview of manufacturing files
- Define reusable libraries of components
- Export to HTML, Markdown, or PDF (experimental)
How to install GitBuilding
To install (for Python 3.7+)
pip install gitbuilding[gui]
If you don't want to use the stand-alone GUI, you can avoid installing PyQT with
pip install gitbuilding[gui]
More details are available on the website.
Running Gitbuilding
To run the stand-alone GitBuilding GUI run:
gitbuilding-gui
or to view the same interface in a browser run
gitbuilding webapp
then navigate to localhost:6178 in your browser.
From this GUI you can open or create new projects. The GUI will launch a live editor in a browser for previewing and editing your documentation.
More details are available on the website.
Asking for help
You are welcome to ask for help in the issue tracker. You can also talk to us on our area of the GOSH forum or on Gitter (though we may not be too responsive due to Matrix notification issues!)
Installing from source
If you wish to contribute to development of GitBuilding you can clone the project from GitLab. You will need to install the python package in development mode and build the javascript editor from source.
To do so please see the contribution page and the developer installation instructions.
Syntax for documentation
The syntax for documentation is in a format we call BuildUp. More details are available on the website.
3 maintainers
Metadata
3 maintainers
Release files for gitbuilding 0.14.9
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gitbuilding-0.14.9.tar.gz | 2.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gitbuilding-0.14.9-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 5.8 MB
Release files / gitbuilding-0.14.9.tar.gz
| Download URL | gitbuilding-0.14.9.tar.gz |
|---|---|
| Size | 2.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5cc3ae272da91b1d87fc414710c7d38915cb43175aaacc494cbfcbb88bf0f523
|
|
BLAKE2b-256 checksum How to use checksums |
4f7539bcbca32f62d57c6b303c549d3fe7bf3822b66501f896a558799b63aa17
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
Release files / gitbuilding-0.14.9-py3-none-any.whl
| Download URL | gitbuilding-0.14.9-py3-none-any.whl |
|---|---|
| Size | 2.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3d56b7ab7028cb6312840430d30c00b0782071e13e64cec9f3ef1f84f748fe0a
|
|
BLAKE2b-256 checksum How to use checksums |
6c4168be55332761ee2d7bc8d46b534a4689e5e600a7a73aaa93548a67e9c039
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.10.17
|
