Skip to content

Commit

Permalink
Update docs and Readme.md with public doc uri
Browse files Browse the repository at this point in the history
  • Loading branch information
Miguel Gao committed Dec 1, 2023
1 parent 5749c62 commit ec50809
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 20 deletions.
13 changes: 10 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,14 @@
[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)


AL_OMX is a opensource library, that provides a thin wrapper around Maya OM2 which makes OM2 more user-friendly but still retain the API's performance.
AL_OMX is a open-source library, that provides a thin wrapper around Maya OM2 which makes OM2 more user-friendly but still retain the API's performance.

[OMX Documentation](coming soon)
More contents here are coming soon once the public documentation url is available.

## Documentation

The full online documentation can be found at https://animallogic.github.io/AL_omx/

- [Install In Maya](https://animallogic.github.io/AL_omx/getting_started/installation.html)
- [Cookbook](https://animallogic.github.io/AL_omx/getting_started/cookbook.html)
- [Public API](https://animallogic.github.io/AL_omx/api/public.html)
- [Changes Log](https://animallogic.github.io/AL_omx/changes.html)
29 changes: 12 additions & 17 deletions docs/source/getting_started/gen_docs.rst
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
Generate |project| Documentation Locally
============================================

The online version of |project| documentation is always available on here (ToBeAdded).
The |project| `online documentation <https://animallogic.github.io/AL_omx/>`_ is always available.

The documentation source files are also included with each distribution, which means you can generate HTML documentation from them yourself locally.

**To generate the document:**
Expand All @@ -22,23 +23,22 @@ Install using pip is suggested, but keep in mind that you can not use mayapy for
pip install sphinx_rtd_theme
pip install sphinx-copybutton
4. Add the root directory of |project| in your `PYTHONPATH` so that the document generator can import `AL.omx` for API documentation auto-generation.
You can do so by simply installing |project| using pip install:

.. code:: shell
pip install AL_omx
4. Add the root directory of |project| in your ``PYTHONPATH`` so that the document generator can import ``AL.omx`` for API documentation auto-generation.
You can simply append the root directory of |project| to the environment variable ``PYTHONPATH``:

Alternatively, you can simply set the environment variable instead:
For Linux and MacOSX:

.. code:: shell
# for Linux and MacOSX:
export PYTHONPATH="$PYTHONPATH:path/to/omxRootDir"
# for Windows:
For Windows:

.. code:: batch
set PYTHONPATH=%PYTHONPATH%;path/to/omxRootDir
5. Run make in the doc folder:

.. code:: shell
Expand All @@ -51,10 +51,5 @@ Alternatively, you can simply set the environment variable instead:
# for Windows:
make.bat html
6. The generated documentation will be in `path/to/omxRootDir/docs/build` folder. Load the `index.html` in your web browser
to use the documentation. Uninstall |project| if you installed it with `pip install` as it will do nothing in vanilla Python
beyond the Maya environment. Skip this step if you did it by setting the `PYTHONPATH` environment variable.

.. code:: shell
pip uninstall AL_omx
6. The generated documentation will be in ``path/to/omxRootDir/docs/build`` folder. Load the ``index.html`` in your web browser
to use the documentation.

0 comments on commit ec50809

Please sign in to comment.