Editing the Wiki - ISISComputingGroup/ibex_developers_manual GitHub Wiki

Wiki >Editing the Wiki

Markdown is the preferred format for Wiki pages as it supports useful features like code highlighting. Other similar document types are available, for example ReST or MediaWiki may be useful if moving documentation from other sources.

For a 3-minute introduction to Markdown see 'Mastering Markdown'.

Pages for the Wiki can be created and edited through GitHub or by checking out the Wiki in git and editing locally.

git clone https://github.com/ISISComputingGroup/ibex_developers_manual.wiki.git

Pages can be organised into folders, but only by checking the Wiki out, arranging as desired, and checking everything back in.

Create new diagram

1. Visit DrawIO choose device
2. Create New Diagram, select type etc.
3. Edit diagram until you are happy
4. choose File -> Export -> Png...
5. Then make sure Include a copy of my diagram is ticked
6. Select github, then the repo (you may have to show more sources)
7. Type commit comment

In wiki add to markdown using:

![alternative text](https://raw.githubusercontent.com/ISISComputingGroup/ibex_developers_manual/master/images/<image name>.png)

To edit this just open that png in draw.io.

To add images you need to check out the Wiki and add them manually. The images should go in their own folder, for example, an image for this page would need to go in /images/using_the_wiki/.

git add images/using_the_wiki/test.png
git commit -m "Added an image to Using the Wiki page"
git push

You can then add the image in markdown using the URL images/using_the_wiki/test.png:

![alternative text](https://raw.githubusercontent.com/ISISComputingGroup/ibex_developers_manual/master/images/using_the_wiki/test.png)

To add or edit a file you again need to check out the Wiki and add manually, or edit and push existing documents. Documents should be stored with their associated pages.

The Wiki is largely unstructured. To help provide navigation breadcrumb trails can be used. Insert the following at the top of the page:

> [Wiki](Home) ▸ [[Level 1]] ▸ [[Level 2]] ▸ **Document Title**