Skip to content

Commit

Permalink
DOCS
Browse files Browse the repository at this point in the history
  • Loading branch information
petrasvestartas committed Apr 22, 2024
1 parent d1ff2c6 commit 75004f7
Show file tree
Hide file tree
Showing 3 changed files with 73 additions and 64 deletions.
69 changes: 5 additions & 64 deletions docs/installation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,68 +2,9 @@
Installation
********************************************************************************

Conda
=====
.. toctree::
:maxdepth: 1
:titlesonly:
:glob:

Create environment
------------------

.. code-block:: bash
conda create -n compas_wood_3_9_10 python=3.9.10 compas
conda activate compas_wood_3_9_10
Clone and install compas_wood
-----------------------------

.. code-block:: bash
git clone https://github.com/petrasvestartas/compas_wood.git
cd compas_wood
pip install -r requirements.txt
pip install -e .
Display via compas_viewer
-------------------------


.. code-block:: bash
git clone https://github.com/compas-dev/compas_viewer.git
cd compas_viewer
conda activate compas_wood_3_9_10
pip install -e .
Visual Studio Code
------------------

- Launch ``VSCode`` and select the ``compas_wood_3_9_10`` Python environment using ``CTRL+SHIFT+P``.
- Open a new terminal via ``Terminal -> New Terminal``.
- Navigate to the ``docs/examples`` folder and execute any ``.py`` example file by right-clicking and selecting ``Run Python File in Terminal``.

.. figure:: /_images/vscode_environment.gif
:figclass: figure
:class: figure-img img-fluid

Notes
=====

If you are new to Anaconda World, install these tools first:

- `Anaconda <https://www.anaconda.com/download>`_

- `Visual Studio Code <https://code.visualstudio.com/download>`_

- `Git <https://git-scm.com/downloads>`_




.. Pip
.. ===
.. .. code-block:: bash
.. pip install compas_wood
installation/*
57 changes: 57 additions & 0 deletions docs/installation/conda.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
********************************************************************************
Conda
********************************************************************************

Create environment
------------------

.. code-block:: bash
conda create -n compas_wood_3_9_10 python=3.9.10 compas
conda activate compas_wood_3_9_10
Clone and install compas_wood
-----------------------------

.. code-block:: bash
git clone https://github.com/petrasvestartas/compas_wood.git
cd compas_wood
pip install -r requirements.txt
pip install -e .
Display via compas_viewer
-------------------------


.. code-block:: bash
git clone https://github.com/compas-dev/compas_viewer.git
cd compas_viewer
conda activate compas_wood_3_9_10
pip install -e .
Visual Studio Code
------------------

- Launch ``VSCode`` and select the ``compas_wood_3_9_10`` Python environment using ``CTRL+SHIFT+P``.
- Open a new terminal via ``Terminal -> New Terminal``.
- Navigate to the ``docs/examples`` folder and execute any ``.py`` example file by right-clicking and selecting ``Run Python File in Terminal``.

.. figure:: /_images/vscode_environment.gif
:figclass: figure
:class: figure-img img-fluid

Notes
=====

If you are new to Anaconda World, install these tools first:

- `Anaconda <https://www.anaconda.com/download>`_

- `Visual Studio Code <https://code.visualstudio.com/download>`_

- `Git <https://git-scm.com/downloads>`_
11 changes: 11 additions & 0 deletions docs/installation/pip.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
********************************************************************************
Pip
********************************************************************************

If you already have a working Python environment:

.. code-block:: bash
pip install compas_wood
Note: compatible with Python version 3.9.10 and above.

0 comments on commit 75004f7

Please sign in to comment.