Project

General

Profile

Actions

Task #388

open

Sphinx documentation setup

Added by Amul Munusamy about 2 months ago. Updated about 2 months ago.

Status:
Resolved
Priority:
Normal
Start date:
06/18/2026
Due date:
% Done:

0%

Estimated time:
1:00 h
Spent time:

Description

To set up Sphinx documentation

Reference: #305 or #306

Sphinx documentation learning resources:

https://sphinx-rtd-theme.readthedocs.io/en/stable/configuring.html


Files

folders.png (92.5 KB) folders.png Devaraj Anandhan, 06/20/2026 01:00 PM
sphinx.png (138 KB) sphinx.png Devaraj Anandhan, 06/20/2026 01:02 PM
ent_commands.png (171 KB) ent_commands.png Devaraj Anandhan, 06/20/2026 01:06 PM
install_sphinx.png (170 KB) install_sphinx.png Devaraj Anandhan, 06/20/2026 01:13 PM
run_sphinx.png (47.6 KB) run_sphinx.png Devaraj Anandhan, 06/20/2026 01:15 PM
pip_install.png (146 KB) pip_install.png Devaraj Anandhan, 06/20/2026 01:18 PM
install_venv.png (180 KB) install_venv.png Devaraj Anandhan, 06/20/2026 01:21 PM
sphinx_theme.png (179 KB) sphinx_theme.png Devaraj Anandhan, 06/20/2026 01:24 PM
build_sphinx.png (138 KB) build_sphinx.png Devaraj Anandhan, 06/20/2026 01:27 PM
browser_view.png (89.4 KB) browser_view.png Devaraj Anandhan, 06/20/2026 01:33 PM
document.png (85.3 KB) document.png Devaraj Anandhan, 06/20/2026 01:36 PM
Actions #1

Updated by Amul Munusamy about 2 months ago

  • Description updated (diff)
Actions #2

Updated by Devaraj Anandhan about 2 months ago

  • Status changed from New to In Progress

Updated by Devaraj Anandhan about 2 months ago ยท Edited

Casttech Sphinx documentation setup:

step 1 : Folder setup:-

  • create Projects folder
  • create Casttech folder
  • open terminal
  • Change directory to Projects and again change directory to casttech folder
  • Clone --> git clone :/home/pms/repos/casttech-docs

step 2 : install python 3 --> sudo apt-get install python3-sphinx

step 3 : Enter the following commands:-

  • Enter list command --> ls
  • Change directory to --> casttech-docs
  • Create a build directory using --> ** mkdir build**
  • Change directory to --> source

step 4 : Install pwd sphinx Using this command --> sudo apt install pwdsphinx

step 5 : Run sphnix for confirmation of installation

step 6 : Install python-pip3 Using this command --> sudo apt install python3-pip

step 7 :

  1. Install and activate vitual machine
  2. Run pip install sphinxcontrib-video

step 8 : Install the sphinx theme using this command --> pip install sphinx-rtd-theme

step 9 : Build a sphinx and source using this command --> sphinx-build -M html source build

step 10 : Enter the following commands for finish the sphinx setup :-

  1. Change directory to build --> cd build
  2. list --> ls
  3. change directory to html --> cd html
  4. list --> ls
    1.To view the document in browser using this command --> google-chrome index.html

Finally complete the sphinx documentation visible in the google chrome with your local path and book mark it.

Actions #5

Updated by Devaraj Anandhan about 2 months ago

  • Status changed from In Progress to Resolved
  • Estimated time set to 1:00 h
Actions

Also available in: Atom PDF