Automatically Generate Doxygen Documentation for all Repositories

Automatically Generate Doxygen Documentation for all Repositories

If you code, you often need to understand code written by others.
Understanding Code can be more easy if you have some Documentation.
But you really don't want to write some txt Files for Documenting your code.
If you code in Java you may now Javadocs.

But what is with other Programming Languages?
Often there is no official Documentation Tool. But there is a solution to generate Documentations for almost every Programming Language. It is called Doxygen.
If you don't know it yet, check it out: http://www.doxygen.nl

But if you work with Doxygen you will fast recognize Doxygen generates every time a new Documentation for every single Project.
A solution is to take all your Projects in one main Project. But that´s not really clean. There are options to load custom Headers and other fancy stuff.
But it was not the option I have searched for.


So I wrote a Generator call GenDoxy that connects to your VCS and generates Documentations for all Repositories. A Python Script is neat, but a self-updating Docker Container is neater. To customize the Documentation just edit the Dockerfile and build the image your-self.

So ok, now I have 500 different Documentation Folders with their own Website. Thats not really a Documentation System Right?  
So why don't have some small PHP Pages that lead you to the Documentation Pages you want?
Guess what, i wrote them.

The Installation of this Documentation Pipeline is super easy and can be done in round about 30 Minutes.


For the complete Setup you have 2 Steps to take:

  • Docker Container Setup
  • PHP Page Setup

Feel free to fork, modify and create Pull-Requests.


Docker Container Setup

Y0ngg4n/GenDoxyDockerImage
The Files to Build the Docker Image for GenDoxy. Contribute to Y0ngg4n/GenDoxyDockerImage development by creating an account on GitHub.
  • Using prebuild Docker Image: Follow Instructions on GitHub

or

  • Build the Image your own:
git clone https://github.com/Y0ngg4n/GenDoxyDockerImage.git
cd GenDoxyDockerImage
docker build . -t gendoxy

PHP Page Setup

Y0ngg4n/GenDoxyWebsite
A lightweight Php Website to organize all Documentations - Y0ngg4n/GenDoxyWebsite
git clone https://github.com/Y0ngg4n/GenDoxyWebsite.git /var/www/gendoxy
chown www-data:www-data /var/www/gendoxy -R

Modification

Y0ngg4n/GenDoxyPython
The Python scripts for GenDoxy. Contribute to Y0ngg4n/GenDoxyPython development by creating an account on GitHub.
  • To modify the Generator you can checkout the Repository and edit the Python Scripts to your wishes.
    Then just edit the Docker Image and build your customized Image.
    Don´t forget to publish your Python code to Github and edit start.sh in Docker Image to your Repository URL.
  • To Modify the style of the generated Documentation edit the style.css file in the Docker Image.
  • To Modify the style of the Gendoxy PHP Website just edit the css/main.css file.
  • To Modify how Doxygen generates the Documentation just edit the Doxyfile file in the Docker Image.
Impressum/Legal Disclosure Datenschutzerklärung/Privacy Policy