# 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.](https://gitbuilding.io/install)
## 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.](https://gitbuilding.io/usage/run)
### 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](https://forum.openhardware.science/c/projects/gitbuilding/55) or on [Gitter](https://gitter.im/gitbuilding/community) (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](https://gitlab.com/gitbuilding/gitbuilding/-/blob/master/CONTRIBUTING.md) and the [developer installation instructions](https://gitlab.com/gitbuilding/gitbuilding/-/blob/master/DeveloperInstallation.md).
# Syntax for documentation
The syntax for documentation is in a format we call BuildUp. [More details are available on the website](https://gitbuilding.io/usage/buildup/).
Raw data
{
"_id": null,
"home_page": "https://gitbuilding.io/",
"name": "gitbuilding",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Documentation, Hardware",
"author": "Julian Stirling",
"author_email": "julian@julianstirling.co.uk",
"download_url": "https://files.pythonhosted.org/packages/56/88/bc3cce3e7fdec6559b618e3dcd8811e8274229f5b2503987680956a939ad/gitbuilding-0.14.2.tar.gz",
"platform": null,
"description": "# What is GitBuilding\n\nGitBuilding 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.\n\nIn GitBuilding you are able to:\n\n* Write the instructions as you go along in markdown\n* Tag links in the code with meta-data to show if they are steps in the build or parts that are needed\n* Automatically generate bills of materials\n* Create templates for instructions that render differently for different configurations of a design\n* 3D preview of manufacturing files\n* Define reusable libraries of components\n* Export to HTML, Markdown, or PDF (experimental)\n\n\n# How to install GitBuilding\n\nTo install (for Python 3.7+)\n\n pip install gitbuilding[gui]\n \nIf you don't want to use the stand-alone GUI, you can avoid installing PyQT with\n\n pip install gitbuilding[gui]\n \n[More details are available on the website.](https://gitbuilding.io/install)\n\n## Running Gitbuilding\n\nTo run the stand-alone GitBuilding GUI run:\n\n gitbuilding-gui\n\nor to view the same interface in a browser run\n\n gitbuilding webapp\n\nthen navigate to `localhost:6178` in your browser.\n\nFrom 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.\n\n\n[More details are available on the website.](https://gitbuilding.io/usage/run)\n\n### Asking for help\n\nYou are welcome to ask for help in the issue tracker. You can also talk to us on [our area of the GOSH forum](https://forum.openhardware.science/c/projects/gitbuilding/55) or on [Gitter](https://gitter.im/gitbuilding/community) (though we may not be too responsive due to Matrix notification issues!)\n\n### Installing from source\n\nIf 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.\n\nTo do so please see the [contribution page](https://gitlab.com/gitbuilding/gitbuilding/-/blob/master/CONTRIBUTING.md) and the [developer installation instructions](https://gitlab.com/gitbuilding/gitbuilding/-/blob/master/DeveloperInstallation.md).\n\n# Syntax for documentation\n\nThe syntax for documentation is in a format we call BuildUp. [More details are available on the website](https://gitbuilding.io/usage/buildup/).\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "For documenting hardware projects with minimal effort,so you can stop writing and GitBuilding.",
"version": "0.14.2",
"project_urls": {
"Bug Tracker": "https://gitlab.com/gitbuilding/gitbuilding/issues",
"Homepage": "https://gitbuilding.io/",
"Source Code": "https://gitlab.com/gitbuilding/gitbuilding"
},
"split_keywords": [
"documentation",
" hardware"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e2ea0878e081063293aad60a618df3390718b7b48a4cc25ba272c11c1ff5ff15",
"md5": "aeb3ad8390d9baca091fc636878dd5c6",
"sha256": "48ca271a72e94d7a4d5267dee9608564bcc9127d16459ea9d7125e51edcecd06"
},
"downloads": -1,
"filename": "gitbuilding-0.14.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "aeb3ad8390d9baca091fc636878dd5c6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 2926282,
"upload_time": "2024-03-25T12:18:16",
"upload_time_iso_8601": "2024-03-25T12:18:16.283901Z",
"url": "https://files.pythonhosted.org/packages/e2/ea/0878e081063293aad60a618df3390718b7b48a4cc25ba272c11c1ff5ff15/gitbuilding-0.14.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5688bc3cce3e7fdec6559b618e3dcd8811e8274229f5b2503987680956a939ad",
"md5": "89dfd5e5e08ddf9ba5aa9ce3bdbb0cc0",
"sha256": "7c47f97438ee46f3d3d2cc0d771ca874da9608547922b1bdc76dfa413980a562"
},
"downloads": -1,
"filename": "gitbuilding-0.14.2.tar.gz",
"has_sig": false,
"md5_digest": "89dfd5e5e08ddf9ba5aa9ce3bdbb0cc0",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2834942,
"upload_time": "2024-03-25T12:18:21",
"upload_time_iso_8601": "2024-03-25T12:18:21.591230Z",
"url": "https://files.pythonhosted.org/packages/56/88/bc3cce3e7fdec6559b618e3dcd8811e8274229f5b2503987680956a939ad/gitbuilding-0.14.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-25 12:18:21",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "gitbuilding",
"gitlab_project": "gitbuilding",
"lcname": "gitbuilding"
}
JSON