Skip to content

Commit

Permalink
added readme
Browse files Browse the repository at this point in the history
  • Loading branch information
wpsimon09 committed Sep 27, 2024
1 parent a15d491 commit 3d4a983
Showing 1 changed file with 48 additions and 2 deletions.
50 changes: 48 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,48 @@
# 3D-Anatomy-Documentation
Documentation created with the help of MkDocs
# 3D-Anatomy Documentation
Documentation created using MkDocs.

## Branches
- **`main`**: Contains the main content of the documentation.
- **`gh-pages`**: Auto-generated by a bot, contains the published documentation.

## Installation

Ensure that you have `pip` and `python` installed.

Then, run the following command to install MkDocs:

```bash
pip install mkdocs
```

Afterward, serve the documentation locally by running:

```bash
mkdocs serve
```

Make sure to execute this command in the root of the repository.

## Adding Pages

You should **always** add new `.md` files to the `docs` folder. You can create new folders if necessary.

## Deploying Your Site

1. Open the `mkdocs.yml` file.
2. Edit the `nav` section.

For example, if you've created documentation in a new folder called `NewDocs` and your `.md` file is named `NewFancyDocs.md`, you should add the following to the `nav` field:

```yml
site_name: 3D-Anatomy-Docs
include_sidebar: false
site_description: 'Documentation for VirtualAnatomy'
##...
nav:
- Home: index.md
- About Project: about-project.md
- NewDocs: NewDocs/NewFancyDocs.md
```
3. Once you're done, add your changes, commit, and push. The GitHub action will trigger, and the `gh-pages` branch will be updated with your changes.

0 comments on commit 3d4a983

Please sign in to comment.