[DOC] Fixing issues in docs for DL Streamer for main (open-edge-platform#987)

Author: sgolebiewski-intel

libraries/dl-streamer/README.md

@@ -26,7 +26,7 @@ Please refer to [Install Guide](./docs/source/get_started/install/install_guide_
 3. [Compile from source code](./docs/source/dev_guide/advanced_install/advanced_install_guide_compilation.md)
 4. [Build Docker image from source code](./docs/source/dev_guide/advanced_install/advanced_build_docker_image.md)
 
-To see the full list of installed components check the [dockerfile content for Ubuntu24](https://raw.githubusercontent.com/open-edge-platform/edge-ai-libraries/refs/heads/main/libraries/dl-streamer/docker/dlstreamer_dev_ubuntu24.Dockerfile)
+To see the full list of installed components check the [dockerfile content for Ubuntu24](https://github.com/open-edge-platform/edge-ai-libraries/blob/main/libraries/dl-streamer/docker/ubuntu/ubuntu24.Dockerfile)
 
 ## Samples
 [Samples](https://github.com/open-edge-platform/edge-ai-libraries/tree/main/libraries/dl-streamer/samples) available for C/C++ and Python programming, and as gst-launch command lines and scripts.

libraries/dl-streamer/docs/source/architecture_2.0/architecture_2.0.md

@@ -16,7 +16,7 @@ architecture 2.0, aiming for the following goals:
    [Source](./api_ref/class_dlstreamer_Source),
    [Transform](./api_ref/class_dlstreamer_Transform) and
    [Sink](./api_ref/class_dlstreamer_Sink) for C++ elements implemented in next sub-component. See
-   [Memory Interop and C++ abstract interfaces](./cpp_interfaces) for details.
+   [Memory Interop and C++ abstract interfaces](./cpp_interfaces.md) for details.
 2. **\"non-GStreamer\" backend support via C++/Python programming.**
    Expose Deep Learning Streamer functional blocks (elements) as both
    GStreamer elements and C++/Python interfaces accessible by any
@@ -27,8 +27,8 @@ architecture 2.0, aiming for the following goals:
    use mix of out-of-box elements, custom/additional elements, memory
    interop library and pipeline management logic on top to build
    complete performance-optimized media analytics pipeline. See
-   [C++ elements](cpp_elements) and [Elements list](elements_list) and
-   [Samples 2.0](samples_2.0) for details.
+   [C++ elements](./cpp_elements.md) and [Elements list](./elements_list.md) and
+   [Samples 2.0](./samples_2.0.md) for details.
 3. **GStreamer bin elements.** Reimplement most gva\* elements as
    GStreamer bin elements which internally build sub-pipeline of other
    (low-level) GStreamer elements. Most low-level elements are C++
@@ -37,7 +37,7 @@ architecture 2.0, aiming for the following goals:
    operation (no multi-stage processing inside element and no
    intermediate memory allocation) with all pipelining done on either
    bin-elements or application level. See pages
-   [GStreamer Elements](gstreamer_elements) and [GStreamer Bin Elements](gstreamer_bins) for details.
+   [GStreamer Elements](./gstreamer_elements.md) and [GStreamer Bin Elements](./gstreamer_bins.md) for details.
 
 The following diagram visualizes Architecture 2.0 sub-components ①, ②
 and ③ inside block **Deep Learning Streamer Pipeline Framework**

libraries/dl-streamer/docs/source/dev_guide/advanced_install/advanced_install_guide_compilation.md

@@ -19,6 +19,7 @@ Follow the instructions in
 ::::{tab-set}
 :::{tab-item} Ubuntu 24
 :sync: tab1
+
   ```bash
   sudo apt-get update && \
   sudo apt-get install -y wget vainfo xz-utils python3-pip python3-gi gcc-multilib libglib2.0-dev \
@@ -31,9 +32,11 @@ Follow the instructions in
       ffmpeg librdkafka-dev libpaho-mqtt-dev libopencv-dev libpostproc-dev libavfilter-dev libavdevice-dev \
       libswscale-dev libswresample-dev libavutil-dev libavformat-dev libavcodec-dev libtbb12 libxml2-dev libopencv-dev
   ```
+
 :::
 :::{tab-item} Ubuntu 22
 :sync: tab2
+
   ```bash
   sudo apt-get update && \
   sudo apt-get install -y wget vainfo xz-utils python3-pip python3-gi gcc-multilib libglib2.0-dev \
@@ -46,9 +49,11 @@ Follow the instructions in
       ffmpeg libpaho-mqtt-dev libpostproc-dev libavfilter-dev libavdevice-dev \
       libswscale-dev libswresample-dev libavutil-dev libavformat-dev libavcodec-dev libxml2-dev
   ```
+
 :::
 :::{tab-item} Fedora 41
 :sync: tab3
+
   ```bash
   sudo dnf install -y \
       https://download1.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm \
@@ -61,21 +66,18 @@ Follow the instructions in
       libssh2-devel cmake git valgrind numactl libvpx-devel opus-devel libsrtp-devel libXv-devel paho-c-devel \
       kernel-headers pmix pmix-devel hwloc hwloc-libs hwloc-devel libxcb-devel libX11-devel libatomic intel-media-driver
   ```
+
 :::
 :::{tab-item} EMT 3.x
 :sync: tab3
+
   ```bash
   sudo dnf install -y uuid libuuid-devel openssl-devel gcc gcc-c++ make curl ca-certificates librdkafka-devel libva-devel alsa-lib-devel unzip glibc libstdc++ libgcc cmake sudo pkgconf pkgconf-pkg-config ocl-icd-devel libva-intel-media-driver python3-devel libXaw-devel ncurses-devel libva2 intel-compute-runtime intel-opencl intel-level-zero-gpu intel-ocloc-devel nasm
   ```
+
 :::
 ::::
 
-### EMT 3.x
-
-```bash
-sudo dnf install -y uuid libuuid-devel openssl-devel gcc gcc-c++ make curl ca-certificates librdkafka-devel libva-devel alsa-lib-devel unzip glibc libstdc++ libgcc cmake sudo pkgconf pkgconf-pkg-config ocl-icd-devel libva-intel-media-driver python3-devel libXaw-devel ncurses-devel libva2 intel-compute-runtime intel-opencl intel-level-zero-gpu intel-ocloc-devel nasm
-```
-
 ## Step 3: Set up a Python environment
 
 Create a Python virtual environment and install required Python
@@ -103,6 +105,7 @@ git submodule update --init libraries/dl-streamer/thirdparty/spdlog
 ::::{tab-set}
 :::{tab-item} Ubuntu/Fedora
 :sync: tab1
+
   ```bash
   cd ~/edge-ai-libraries/libraries/dl-streamer
   sudo ./scripts/install_dependencies/install_openvino.sh
@@ -126,9 +129,11 @@ git submodule update --init libraries/dl-streamer/thirdparty/spdlog
   sudo -E /opt/intel/openvino_2025/install_dependencies/install_openvino_dependencies.sh
   source /opt/intel/openvino_2025/setupvars.sh
   ```
+
 :::
 :::{tab-item} EMT
 :sync: tab2
+
   ```bash
   wget https://storage.openvinotoolkit.org/repositories/openvino/packages/2025.3/linux/openvino_toolkit_ubuntu24_2025.3.0.19807.44526285f24_x86_64.tgz
   tar -xvzf openvino_toolkit_ubuntu24_2025.3.0.19807.44526285f24_x86_64.tgz
@@ -139,39 +144,51 @@ git submodule update --init libraries/dl-streamer/thirdparty/spdlog
   sudo ln -s openvino_2025.3.0 openvino_2025
   ```
 
+:::
+::::
+
 ### [Optional] Step 6: Install OpenVINO™ GenAI (only for Ubuntu)
 
-To use [gvagenai element](https://docs.openedgeplatform.intel.com/oep/edge-ai-libraries/dl-streamer/elements/gvagenai.html) 
+To use [gvagenai element](https://docs.openedgeplatform.intel.com/oep/edge-ai-libraries/dl-streamer/elements/gvagenai.html)
 there is need to install [OpenVINO GenAI archive](https://docs.openvino.ai/2025/get-started/install-openvino/install-openvino-genai.html) package.
 
+::::{tab-set}
+:::{tab-item} Ubuntu 24
+:sync: tab1
+
+  ```bash
+  curl -L https://storage.openvinotoolkit.org/repositories/openvino_genai/packages/2025.3/linux/openvino_genai_ubuntu24_2025.3.0.0_x86_64.tar.gz | tar -xz &&
+  mv openvino_genai_ubuntu24_2025.3.0.0_x86_64 /opt/intel/openvino_genai
+  source /opt/intel/openvino_genai/setupvars.sh
+  ```
 
-- **Ubuntu 22**
+:::
+:::{tab-item} Ubuntu 22
+:sync: tab2
 
 ```bash
 curl -L https://storage.openvinotoolkit.org/repositories/openvino_genai/packages/2025.3/linux/openvino_genai_ubuntu22_2025.3.0.0_x86_64.tar.gz | tar -xz &&
 mv openvino_genai_ubuntu22_2025.3.0.0_x86_64 /opt/intel/openvino_genai
 source /opt/intel/openvino_genai/setupvars.sh
 ```
 
-- **Ubuntu 24**
-
-```bash
-curl -L https://storage.openvinotoolkit.org/repositories/openvino_genai/packages/2025.3/linux/openvino_genai_ubuntu24_2025.3.0.0_x86_64.tar.gz | tar -xz &&
-mv openvino_genai_ubuntu24_2025.3.0.0_x86_64 /opt/intel/openvino_genai
-source /opt/intel/openvino_genai/setupvars.sh
-```
+:::
+::::
 
 ## Step 7: Build Deep Learning Streamer
 
 To build DL Streamer is it recommended to use the provided makefile for ease of use:
+
 ```bash
 make build
 ```
+
 Running this command will build any major missing dependencies and then compile DL Streamer itself.
 
 ## Step 8: Install Deep Learning Streamer (optional)
 
 After building DL Streamer you can install it on your local system by running:
+
 ```bash
 sudo -E make install
 ```
@@ -183,6 +200,7 @@ Set up the required environment variables:
 ::::{tab-set}
 :::{tab-item} Ubuntu
 :sync: tab1
+
   ```bash
   export LIBVA_DRIVER_NAME=iHD
   export GST_PLUGIN_PATH="/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib:$HOME/edge-ai-libraries/libraries/dl-streamer/build/deps/gstreamer-bin/lib/gstreamer-1.0:$GST_PLUGIN_PATH"
@@ -194,9 +212,11 @@ Set up the required environment variables:
   export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
   export GI_TYPELIB_PATH=/opt/intel/dlstreamer/gstreamer/lib/girepository-1.0:/usr/lib/x86_64-linux-gnu/girepository-1.0gi
   ```
+
 :::
 :::{tab-item} Fedora
 :sync: tab2
+
   ```bash
   export LIBVA_DRIVER_NAME=iHD
   export GST_PLUGIN_PATH="/opt/intel/dlstreamer/lib:/opt/intel/dlstreamer/gstreamer/lib/gstreamer-1.0:$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib:$HOME/edge-ai-libraries/libraries/dl-streamer/build/deps/gstreamer-bin/lib/gstreamer-1.0:$GST_PLUGIN_PATH"
@@ -207,9 +227,11 @@ Set up the required environment variables:
   export PKG_CONFIG_PATH="/opt/intel/dlstreamer/lib/pkgconfig:/opt/intel/dlstreamer/gstreamer/lib/pkgconfig::$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib/pkgconfig:$HOME/edge-ai-libraries/libraries/dl-streamer/build/deps/gstreamer-bin/lib/pkgconfig:$PKG_CONFIG_PATH"
   export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
   ```
+
 :::
 :::{tab-item} EMT
-:sync: tab2
+:sync: tab3
+
   Enable `i915` graphics driver in the system:
 
   ```bash
@@ -232,6 +254,7 @@ Set up the required environment variables:
   export PKG_CONFIG_PATH="/opt/intel/dlstreamer/lib/pkgconfig:/opt/intel/dlstreamer/gstreamer/lib/pkgconfig::$HOME/edge-ai-libraries/libraries/dl-streamer/build/intel64/Release/lib/pkgconfig:$HOME/edge-ai-libraries/libraries/dl-streamer/build/deps/gstreamer-bin/lib/pkgconfig:$PKG_CONFIG_PATH"
   export GST_PLUGIN_FEATURE_RANK=${GST_PLUGIN_FEATURE_RANK},ximagesink:MAX
   ```
+
 :::
 ::::
 

libraries/dl-streamer/docs/source/dev_guide/advanced_install/advanced_install_guide_index.md

@@ -1,7 +1,41 @@
 # Advanced Installation Guide
 
+- [Ubuntu advanced installation - prerequisites](./advanced_install_guide_prerequisites.md)
+  - [Prerequisite 1 - Intel® GPU drivers for computing and media runtimes](./advanced_install_guide_prerequisites.md#prerequisite-1---intel-gpu-drivers-for-computing-and-media-runtimes)
+  - [Prerequisite 2 - Install Intel® NPU drivers](./advanced_install_guide_prerequisites.md#optional-prerequisite-2---install-intel-npu-drivers)
+- [Ubuntu advanced installation - pre-built packages](./advanced_install_guide_prebuilt.md)
+  - [Step 1: Install prerequisites](./advanced_install_guide_prebuilt.md#step-1-setup-prerequisites)
+  - [Step 2: Prepare the installation environment](./advanced_install_guide_prebuilt.md#step-2-prepare-the-installation-environment)
+  - [Step 3: Install Intel® DL Streamer](./advanced_install_guide_prebuilt.md#step-3-install-deep-learning-streamer)
+  - [Step 4: Install OpenVINO™ toolkit](./advanced_install_guide_prebuilt.md#step-4-install-openvino-toolkit)
+  - [Step 5: Install MQTT and Kafka clients for element gvametapublish](./advanced_install_guide_prebuilt.md#step-5-optional-install-mqtt-and-kafka-clients-for-element-gvametapublish)
+  - [Step 6: Add user to groups](./advanced_install_guide_prebuilt.md#step-6-add-user-to-groups)
+  - [Step 7: Set up the environment for Intel® DL Streamer](./advanced_install_guide_prebuilt.md#step-7-set-up-the-environment-for-deep-learning-streamer)
+  - [Step 8: Verify Intel® DL Streamer installation](./advanced_install_guide_prebuilt.md#step-8-verify-deep-learning-streamer-installation)
+  - [Step 9: Next steps - running sample Intel® DL Streamer pipelines](./advanced_install_guide_prebuilt.md#step-9-next-steps---running-sample-deep-learning-streamer-pipelines)
+- [Advanced installation - compilation from source files](./advanced_install_guide_compilation.md)
+  - [Step 1: Install prerequisites (only for Ubuntu)](./advanced_install_guide_compilation.md#step-1-install-prerequisites-only-for-ubuntu)
+  - [Step 2: Install build dependencies](./advanced_install_guide_compilation.md#step-2-install-build-dependencies)
+  - [Step 3: Set up a Python environment](./advanced_install_guide_compilation.md#step-3-set-up-a-python-environment)
+  - [Step 4: Build/Install FFmpeg](./advanced_install_guide_compilation.md#step-4-clone-deep-learning-streamer-repository)
+  - [Step 5: Build GStreamer](./advanced_install_guide_compilation.md#step-5-install-openvino-toolkit)
+  - [Step 6: Build OpenCV](./advanced_install_guide_compilation.md#optional-step-6-install-openvino-genai-only-for-ubuntu)
+  - [Step 7: Clone Intel® DL Streamer repository](./advanced_install_guide_compilation.md#step-7-build-deep-learning-streamer)
+  - [Step 8: Install OpenVINO™ Toolkit](./advanced_install_guide_compilation.md#step-8-install-deep-learning-streamer-optional)
+  - [Step 9: Build Intel DLStreamer](./advanced_install_guide_compilation.md#step-9-set-up-environment)
+  - [Step 10: Set up environment](./advanced_install_guide_compilation.md#step-10-install-python-dependencies-optional)
+- [Ubuntu advanced installation - build Docker image](./advanced_build_docker_image.md)
+  - [Step 1: Install prerequisites](./advanced_build_docker_image.md#step-1-install-prerequisites)
+  - [Step 2: Download Dockerfiles](./advanced_build_docker_image.md#step-2-download-dockerfiles)
+  - [Step 3: Build Docker image](./advanced_build_docker_image.md#step-3-build-docker-image)
+- [Ubuntu advanced uninstall guide](./advanced_uninstall_guide.md)
+  - [Option #1: Uninstall Intel® Deep Learning Streamer (Intel® DL Streamer) Pipeline Framework from APT repository](./advanced_uninstall_guide.md#option-1-apt-repository)
+  - [Option #2: Intel® DL Streamer Pipeline Framework Docker image](./advanced_uninstall_guide.md#option-2-docker)
+  - [Option #3: Compiled version](./advanced_uninstall_guide.md#option-3-compiled-version)
+
 :::{toctree}
 :maxdepth: 2
+:hidden:
 
 advanced_install_guide_prerequisites
 advanced_install_guide_prebuilt