Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

Guide for How to contribute to site?


  1. This site runs on Python based mkdocs framework, to use that install Python, pip. Refer for details

  2. Check python and pip installed correctly by command -

user@pc:~$ python --version Python versions 3.5, 3.6, 3.7, 3.8 are supported


user@pc:~$ pip --version.

  1. Create folder for Python virtual environments in lets say home folder.

user@pc:~$ cd ~/

user@pc:~$ mkdir Python_environments

  1. Create a virtual environment in above folder.

user@pc:~$ python3 -m venv ~/Python_environments/

  1. Activate this virtual environment by running command

user@pc:~$ source ~/Python_environments/

  1. Install wheel, mkdocs on this virtual env.

( user@pc:~$ python3 -m pip install wheel

( user@pc:~$ python3 -m pip install mkdocs.

  1. Check mkdocs installed correctly by command

( user@pc:~$ mkdocs --version

  1. Install mkdocs-material Theme by command

( user@pc:~$ python3 -m pip install mkdocs-material

  1. Install other plugins needed

( user@pc:~$ python3 -m pip install mkdocs-minify-plugin

( user@pc:~$ python3 -m pip install mkdocs-git-revision-date-localized-plugin

Steps to contribute documentation to the Techjoomla Site.

Understanding repos

  1. This repo containts the source code of the docs
  2. This repo has the static files generated for the docs

Repo 1. is where you will work on

Fork and clone on local machine

  1. Fork repo
  2. Git clone your fork to your machine. Command Syntax - git clone fork-link
  3. Add remote upstream by command git remote add upstream
  4. Make filemode to false git config core.filemode false

Basic Usage

Start local development server

  1. Open the terminal Go to the folder where the cloned project is stored.

  2. Activate this virtual environment by running command

user@pc:~$ source ~/Python_environments/

  1. Start the development server with command

( user@pc:~$ mkdocs serve

  1. It will give you the link where you can see the changes. In most of the cases it is

Understanding folder structure of

Folder Name Description
docs Contains documentation source files
site Contains generated static files to render site
mkdocs.yml Contains folders/Subfolders from docs dir

To add a new post

  1. Inside docs folder create a new folder and in that folder create md file format

lets say you added as ~/repo/docs/tj-reports/

  1. Open the .md file you created and add front matter
title:       TJReports Introduction
description: Introduction to TJReports (com_tjreports), a reports manager for Joomla
path:        blob/master/docs/tj-reports
hero:        TJReports - Introduction
date:        2020-04-22
  - TJReports
  - Joomla
  - TJReports
  - com_tjreports

# Add your doc changes here

To add a navaigation link

  1. Open mkdocs.yml file.

  2. Add Menu item -

For example

  - TJReports:
    - Introduction: tj-reports/

Sending Pull request

For maintainers

  1. Clone these repos locally lets say under ~/git/techjoomla folder

  2. Merge new PRs at

  3. Switch to repo cd Update local repo code by pulling lastest code

  4. Activate this virtual environment by running command

user@pc:~$ source ~/Python_environments/

  1. Switch to repo cd ../

  2. Run command to add static files to this repo from docs reports, and push those to master branch

mkdocs gh-deploy --config-file ../ --remote-branch master

  1. Since, we are using a custom domain, we might need to this do Goto GitHub Pages -> Custom domain -> add and hit save