added conda instructions for mkdocs. updated installation instructions for OptiX headers from github

Author: amock

README.md

@@ -4,13 +4,29 @@ These docs are built with [MkDocs](https://mkdocs.org) and published to [uos.git
 
 ## Build locally
 
-```
+```console
 sudo apt install python3-pip
 pip3 install "mkdocs>=1.6" mkdocs-material
 ```
 
 *Note: you may need to adapt your path `export PATH=$PATH:/home/<USER>/.local/bin` to access mkdocs binary*
 
+## Using Anaconda
+
+After downloading go into the folder of this repository.
+
+```console
+conda env create -f environment.yml
+```
+
+Will create an conda environment named "rmagine_docs". Enable it by calling
+
+```console
+conda activate rmagine_docs
+```
+
+
+
 ### Build Static Files
 
 ```
@@ -40,4 +56,4 @@ How to contribute to this documentation via pull requests:
 3. Check locally on your machine if mkdocs is able to compile your changes ([instructions](https://github.com/uos/rmagine_docs)).
 3. Go to Github and click "Pull Request", select this repository's "main" branch as target.
 4. If you added new content, please provide a brief explanation of why you believe it is beneficial for the documentation.
-5. Send PR.
+5. Send PR.

docs/extra/news.md

@@ -1,5 +1,9 @@
 # News
 
+## 12.09.2024
+
+Alongside the new version 2.2.6 we released a minimal viewer that demonstrates the sensor models of rmagine. Check it out here: https://github.com/amock/rmagine_viewer.
+
 ## 05.12.2023
 
 New version 2.2.2 is available now and brings convenience updates for ROS-users. Just place Rmagine into your ROS-workspace and it will compile. Via `find_package(rmagine COMPONENTS [...])` you can still find Rmagine's components as if you would install it globally on your system. We tested it with 
@@ -19,20 +23,20 @@ Especially if you place Rmagine into your ROS-workspace this option becomes very
 From version >= 2.2.0 we enabled component-wise compilation and packaging for easier installation of Rmagine. In "Releases" section you can find the first pre-compiled binaries. Install the core library via
 
 ```console
-$ sudo dpkg -i rmagine-core_2.2.1_amd64.deb
+sudo dpkg -i rmagine-core_2.2.1_amd64.deb
 ```
 
 Then additionally for the Embree backend:
 
 ```console
-$ sudo dpkg -i rmagine-embree_2.2.1_amd64.deb
+sudo dpkg -i rmagine-embree_2.2.1_amd64.deb
 ```
 
 And if you have a NVIDIA GPU:
 
-```
-$ sudo dpkg -i rmagine-cuda_2.2.1_amd64.deb
-$ sudo dpkg -i rmagine-optix_2.2.1_amd64.deb
+```console
+sudo dpkg -i rmagine-cuda_2.2.1_amd64.deb
+sudo dpkg -i rmagine-optix_2.2.1_amd64.deb
 ```
 
 Using the pre-compiled binaries, you are not required to download the OptiX-headers anymore. However, CUDA and Embree are still required to be installed on your system.

docs/installation.md

@@ -34,9 +34,9 @@ For older Embree versions we refer to [this](/extra/embree3.md).
 
 ### OptiX Backbone (optional)
 
-Rmagine supports NVIDIA OptiX versions of 7.2 or newer (experimental support for OptiX 8).
+Rmagine supports NVIDIA OptiX versions of 7.2 or newer (experimental support for OptiX 8+).
 The OptiX-Library is installed via the GPU driver.
-The OptiX-Headers can be downloaded [here](https://developer.nvidia.com/designworks/optix/download).
+The OptiX-Headers can be downloaded from [GitHub](https://github.com/NVIDIA/optix-dev).
 The Headers require a specific GPU driver and CUDA version to be installed on your system:
 
 | OptiX Version | Minimum Driver Version |
@@ -48,6 +48,10 @@ The Headers require a specific GPU driver and CUDA version to be installed on yo
 |     7.6       |  520.00 (untested)     |
 |     7.7       |  530.41                |
 
+!!! note 
+
+    Check NVIDIA docs for newer versions.
+
 ## Compilation
 
 Download the Rmagine repository. 
@@ -59,7 +63,7 @@ user@pc:~/rmagine/build$ cmake ..
 user@pc:~/rmagine/build$ make
 ```
 
-The path to OptiX-Headers should be specified with the CMake-Variable `OptiX_INCLUDE_DIR`. This can be done using ccmake, for example.
+The path to OptiX-Headers should be specified with the CMake-Variable `OptiX_INCLUDE_DIR`. This can be done using `ccmake`, for example.
 
 ### Bash Variable (Alternative)
 
@@ -132,31 +136,31 @@ We are working on creating debian packages for easier installations.
 ## Dependencies
 
 ```console
-$ sudo apt install libassimp-dev libeigen3-dev
+sudo apt install libassimp-dev libeigen3-dev
 ```
 
 ## Install
-Download latest Rmagine debian packages from Github releases page (v2.2.2). Install the core by calling
+Download latest Rmagine debian packages from Github releases page (v2.3.0). Install the core by calling
 
 ```console
-sudo apt install ./rmagine-core_2.2.2_amd64.deb
+sudo apt install ./rmagine-core_2.3.0_amd64.deb
 ```
 
 ### Embree Backbone  
 
 We support Embree in its latest version (tested: v4.0.1 - v4.3.0). Make sure you have Embree installed on your system.
 
 ```console
-sudo apt install ./rmagine-embree_2.2.2_amd64.deb
+sudo apt install ./rmagine-embree_2.3.0_amd64.deb
 ```
 
 ### OptiX Backbone
 
 Make sure you have a current NVIDIA driver installed, then install rmagine-cuda and rmagine-optix by:
 
 ```console
-sudo apt install ./rmagine-cuda_2.2.2_amd64.deb
-sudo apt install ./rmagine-optix_2.2.2_amd64.deb
+sudo apt install ./rmagine-cuda_2.3.0_amd64.deb
+sudo apt install ./rmagine-optix_2.3.0_amd64.deb
 ```
 
 ## Uninstall

environment.yml

@@ -0,0 +1,5 @@
+name: rmagine_docs
+dependencies:
+  - python=3.12
+  - mkdocs>=1.6
+  - mkdocs-material