Skip to content

Documentation Setup Guide

Welcome to the docs-setup folder! This folder contains all the necessary guides to set up and configure your project documentation using MkDocs.


Guides

1. Python Virtual Environment Setup

Learn how to set up a Python virtual environment for dependency management.


2. MkDocs Setup

Step-by-step instructions to install and configure MkDocs.


3. MkDocs Configuration

Customize your MkDocs project with themes, plugins, and versioning.


4. Publishing Guide

Publish your documentation to GitHub Pages and automate the process with GitHub Actions.


Quick Start

  1. Set up a Python virtual environment:
   python -m venv venv
  1. Activate the virtual environment:
  2. On Windows:

bash

   venv\Scripts\activate
  • On macOS/Linux:

bash

   source venv/bin/activate
  1. Install MkDocs:

bash

   pip install mkdocs
  1. Create a new MkDocs project:

bash

   mkdocs new meu-projeto-docs
  1. Preview your documentation locally:

bash

   mkdocs serve
  1. Publish your documentation to GitHub Pages:

bash

   mkdocs gh-deploy

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0) . For more details, see the LICENSE file.


Contributing

If you would like to contribute to this project, please read the contribution guide for more details.


Support

For questions or issues, please open an issue in the GitHub repository.