mirror of
https://github.com/IfcOpenShell/IfcOpenShell.git
synced 2026-09-21 12:34:00 +00:00
Minor updates
Added a debug and run script to the documentation section. Added a tip and clarifies how to roll back to a previous version, when running unstable release.
This commit is contained in:
committed by
Dion Moult
parent
c45b4372a8
commit
2eecda17e4
@@ -102,11 +102,17 @@ that they are typically updated every day. To install the **Unstable** version:
|
|||||||
.. image:: images/unstable-restart.png
|
.. image:: images/unstable-restart.png
|
||||||
|
|
||||||
If you wish to install an **Unstable** version offline, you can download a
|
If you wish to install an **Unstable** version offline, you can download a
|
||||||
daily build from the `GitHub releases page
|
daily or previous build from the `GitHub releases page
|
||||||
<https://github.com/IfcOpenShell/IfcOpenShell/releases?q=bonsai&expanded=true>`__,
|
<https://github.com/IfcOpenShell/IfcOpenShell/releases?q=bonsai&expanded=true>`__,
|
||||||
then go to :menuselection:`Topbar --> Edit --> Preferences --> Get Extensions
|
then go to :menuselection:`Topbar --> Edit --> Preferences --> Get Extensions
|
||||||
--> "V" Icon (top right) --> Install from Disk`.
|
--> "V" Icon (top right) --> Install from Disk`.
|
||||||
|
|
||||||
|
.. tip::
|
||||||
|
|
||||||
|
Installing a previous build is a great way to roll back to previous versions. Uninstall the current version,
|
||||||
|
then install the previous version from your disk. Make the install directory into the repo folder, and you can still
|
||||||
|
update by the click of a button, when you are ready for the latest build.
|
||||||
|
|
||||||
Bundling for Blender
|
Bundling for Blender
|
||||||
--------------------
|
--------------------
|
||||||
|
|
||||||
|
|||||||
@@ -186,20 +186,86 @@ Now you can generate the documentation:
|
|||||||
cd _build/html
|
cd _build/html
|
||||||
python -m http.server
|
python -m http.server
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
|
||||||
|
.. warning::
|
||||||
|
|
||||||
|
Depending on your machine and environment, you might need to use ``.\make`` instead of ``make``.
|
||||||
|
|
||||||
You will now have a local webserver running hosting the documentation. Your terminal
|
You will now have a local webserver running hosting the documentation. Your terminal
|
||||||
will return something like seen underneath, replace [::] with localhost.
|
will return something like seen underneath, replace [::] with localhost.
|
||||||
|
|
||||||
.. code::
|
.. code:: console
|
||||||
|
|
||||||
Serving HTTP on :: port 8000 (http://[::]:8000/) ...
|
Serving HTTP on :: port 8000 (http://[::]:8000/) ...
|
||||||
|
|
||||||
When you want to see changes you have made in your IDE:
|
Streamlining your workflow
|
||||||
|
^^^^^^
|
||||||
|
Now that you have added or changed some content in the documentation, you may want to see it on the webserver.
|
||||||
|
Initially you can:
|
||||||
|
|
||||||
- Kill the terminal, eg. the server.
|
- Kill the terminal, eg. the server.
|
||||||
- Run the make and build sequence above again.
|
- Run the make and build sequence as above again.
|
||||||
|
|
||||||
.. tip::
|
.. tip::
|
||||||
|
|
||||||
If you make small incremental changes, you can avoid the cd navigation in many IDE's
|
If you make small incremental changes, you can avoid the cd navigation in many IDE's
|
||||||
by right clicking on the docs folder and open a fresh terminal from there.
|
by right clicking on the docs folder and open a fresh terminal from there.
|
||||||
|
|
||||||
|
This will work, but it is not very efficient. You can streamline your workflow by setting
|
||||||
|
up a run and debug configuration in your IDE. Below is an example for VScode placed in your
|
||||||
|
.vscode folder in the root.
|
||||||
|
|
||||||
|
*task.json*
|
||||||
|
|
||||||
|
.. code:: json
|
||||||
|
|
||||||
|
{
|
||||||
|
"version": "2.0.0",
|
||||||
|
"tasks": [
|
||||||
|
{
|
||||||
|
"label": "Build and Serve Docs",
|
||||||
|
"type": "shell",
|
||||||
|
"command": "powershell",
|
||||||
|
"args": [
|
||||||
|
"-NoProfile",
|
||||||
|
"-ExecutionPolicy",
|
||||||
|
"Bypass",
|
||||||
|
"-Command",
|
||||||
|
"cd D:/ifcopenshell/src/bonsai/docs/; .\\make html; cd _build/html; python -m http.server"
|
||||||
|
],
|
||||||
|
"group": {
|
||||||
|
"kind": "build",
|
||||||
|
"isDefault": true
|
||||||
|
},
|
||||||
|
"problemMatcher": []
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
*launch.json*
|
||||||
|
|
||||||
|
.. code:: json
|
||||||
|
|
||||||
|
{
|
||||||
|
"version": "0.2.0",
|
||||||
|
"configurations": [
|
||||||
|
{
|
||||||
|
"name": "BonsaiDocsServer",
|
||||||
|
"type": "python",
|
||||||
|
"request": "launch",
|
||||||
|
"program": "D:/ifcopenshell/src/bonsai/docs/_build/html",
|
||||||
|
"args": ["-m", "http.server"],
|
||||||
|
"preLaunchTask": "Build and Serve Docs",
|
||||||
|
"console": "integratedTerminal"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
Now you can run the debugger, it will build the documentation and start the server.
|
||||||
|
Simply stop debugging to stop the server and rerun the debugger to see your changes.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user