Skip to content

Latest commit

 

History

History
146 lines (93 loc) · 3.3 KB

README.md

File metadata and controls

146 lines (93 loc) · 3.3 KB
Raw

GeoNetwork Manual and Help

Documentation for GeoNetwork opensource is available via https://docs.geonetwork-opensource.org.

This documentation is written under the Creative Commons license Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0).

Reference:

Communication

The project issue tracker is used for communication, with ongoing topics tagged documentation.

Material for MkDocs

Documentation is MkDocs-material which is a Markdown documentation framework written on top of MkDocs.

If you are using Python3:

  1. Install using pip3 and build:

    pip3 install -r requirements.txt

  2. Use *mkdocs to preview locally:

    mkdocs serve

  3. Preview: http://localhost:8000

    Preview uses a single version, so expect some warnings from version chooser:

    "GET /versions.json HTTP/1.1" code 404

  4. Optional: Preview online help:

    mkdocs serve --config-file help.yml

VirtualEnv

If you use a Python virtual environment:

  1. Activate virtual environment:

    virtualenv venv
source venv/bin/activate
pip install -r requirements.txt

  2. Use mkdocs to preview from virtual environment:

    mkdocs serve

  3. Preview: http://localhost:8000

Docker

If you are not familiar with Python the MkDocs-material website has instructions for Docker:

  1. Run MkDocs in Docker environment:

    docker pull squidfunk/mkdocs-material
docker run --rm -it -p 8000:8000 -v ${PWD}:/docs squidfunk/mkdocs-material

  2. Preview: http://localhost:8000

Maven Integration

  1. Build documentation with compile phase:

    mvn compile

  2. Assemble zip with package phase:

    mvn package

  3. Both install and deploy are skipped (so mvn clean install is fine).

  4. Use default profile to only build the default English docs:

    mvn install -Pdefault

Deploy

We use mike for publishing to https://geonetwork.github.io using <major>.<minor> version:

  1. To deploy docs from the main branch to website gh-pages branch:

    mike deploy --push --no-redirect --update-aliases 4.4 latest

  2. To deploy documentation for a new release:

    mike deploy --push --no-redirect --update-aliases 4.2 stable

  3. When starting a new branch you can make it the default:

    mike set-default --push 4.2

    Hint: When starting a new branch update overview/changelog/ navigation tree also.

  4. To publish documentation for a maintenance release:

    mike deploy --push --no-redirect --update-aliases 3.12 maintenance

  5. To show published versions:

    mike list

  6. To preview things locally (uses your local gh-pages branch):

    mike serve

Reference: