How to Edit the site

Step 1: Create a fork of the git repository

• Go to https://gitlab.cern.ch/pahermes/ndc_website

• Click on "fork" in upper left corner and fill in the form

Step 2: Edit the files

• Clone your fork to a local folder and do the necessary edits locally
• Or use the WebIDE directly in GitLab to edit the files

Step 3: Verify the changes

Changes can be easily visualized locally on your computer. A few python packages are required, as well as python version 3.5 or more.

• pip install mkdocs mkdocs-material mkdocs-i18n

• cd to the folder where your git project is saved

• In terminal, run: mkdocs serve

You now have a live feed of the website accessible at http://127.0.0.1:8000 which is updated as you change any of the files. For more details, check here: https://abpcomputing.web.cern.ch/guides/mkdocs_site/

Step 4: Merge the changes with the master fork

• git add < new files >
• git commit

• git push

• Go to https://gitlab.cern.ch/pahermes/ndc_website and click "Merge requests" in the left menu, then "New merge request", and then fill in the form.