-
Notifications
You must be signed in to change notification settings - Fork 12.9k
Contributing to Wiki
The GitHub Wiki will use the name of the markdown file as the title of the page. Ensure that you have capitalized the filename in the correct places to reflect how you would want the title presented. e.g.
Filename This-is-a-Guide.md
will result in the title This is a Guide
.
No duplicate filenames for pages: Ensure that you do NOT create a duplicate filename of an existing file when naming your markdown file. A GitHub MediaWiki entry will resolve from the /wiki
root irrespective of the file being in a nested directory therefore the name of a file should only exist once.
Invalid characters: Do NOT use the following characters in your filenames: \ / : * ? " < > |
You can link to another Wiki entry by either using the MediaWiki syntax or markdown:
All of the pages on the GitHub Wiki will be accessed using the filename after the /wiki/
root regardless of whether the files are nested or not e.g.
The file at /Guides/contributing-to-wiki/Contributing-to-Wiki.md
will be available from the URL /wiki/Contributing-to-Wiki
.
MediaWiki
As pages are resolved to the /wiki/
directory, you simply use the page title of the Wiki page you are linking to. Do not include the markdown extension (.md) as you are not trying to link to a file directly. e.g.
The page you are currently on, /wiki/Guides/contributing-to-wiki/Contributing-to-Wiki.md
, would be linked as follows:
Code | Result |
---|---|
[[Contributing to Wiki|Contributing-to-Wiki]] |
Contributing to Wiki |
Markdown
Link to the Wiki page without including the paths e.g.
The file at /Guides/contributing-to-wiki/Contributing-to-Wiki.md
would be linked as follows:
Code | Result |
---|---|
[Contributing to Wiki](./Contributing-to-Wiki) |
Contributing to Wiki |
[Contributing to Wiki](Contributing-to-Wiki) |
Contributing to Wiki |
You can anchor link to any titles, but the title must be in lowercase when being linked. Characters such as a colon must be omitted and spaces must be substituted with hyphens -
.
Anchor to a normal title:
The link to the anchor:
[Link to Anchor](#this-is-a-title-anchor)
The anchor that is being linked to:
## This is a Title Anchor:
Anchor to a numbered title:
If you title is a numbered item, then you would:
- Include the number from the title;
- Omit the period
.
; - Add a hyphen where the space character would be.
The link to the anchor:
[Link to Numbered Anchor](#1-this-is-a-numbered-anchor)
The anchor that is being linked to:
## 1. This is a Numbered Anchor:
Linking to an anchor link on another page:
If you are anchoring to a title on another page, then you would:
- Add the page being linked to;
- Add the hash sign
#
; - Add the title you are linking to, using hyphens
-
to substitute spaces.
[Anchor link to another page](Contributing-to-Wiki#Anchor-linking)
Include the number if the title is a numbered item:
[Anchor link to another page](Contributing-to-Wiki#1-Anchor-linking)
MediaWiki format:
Add your image to the Wiki folder, then you can link it within double square brackets. You will not need to include the path to the file if it is in the same directory as the Wiki page:
[[new-image.png]]
The alt
code is added by appending |alt=
to the end of the filename e.g.
[[new-image.png|alt=New Image]]
Markdown format:
Add your image to the Wiki folder, then you can link to it using the typical markdown format. You will need to link to the path of the file when using the Markdown format:
![New Image](new-image.png)
![New image](./new-image.png)
![Xubuntu Menu Button](./images/Xubuntu-Logo-s.png)
Github has already prepared a thorough guide on tables that can be found here: Organizing information with tables
Reusable images are images intended to be reused across multiple pages and are located in the /images/
directory. Examples of these types of images would be application icons, such as the Home button for Xubuntu. The images follow a small (16px), medium (32px) and large (64px) format:
Image | Filename |
---|---|
![]() |
![Dialog Error s](./images/Dialog-Error-s.png) |
![]() |
![Dialog Error m](./images/Dialog-Error-m.png) |
![]() |
![Dialog Error l](./images/Dialog-Error-l.png) |
![]() |
![Dialog Info s](./images/Dialog-Info-s.png) |
![]() |
![Dialog Info m](./images/Dialog-Info-m.png) |
![]() |
![Dialog Info l](./images/Dialog-Info-l.png) |
![]() |
![Dialog Warning s](./images/Dialog-Warning-s.png) |
![]() |
![Dialog Warning m](./images/Dialog-Warning-m.png) |
![]() |
![Dialog Warning l](./images/Dialog-Warning-l.png) |
![]() |
![TOP Logo s](./images/TOP-Logo-s.png) |
![]() |
![TOP Logo m](./images/TOP-Logo-m.png) |
![]() |
![TOP Logo l](./images/TOP-Logo-l.png) |
![]() |
![Utilities File Manager s](./images/Utilities-FileManager-s.png) |
![]() |
![Utilities File Manager m](./images/Utilities-FileManager-m.png) |
![]() |
![Utilities File Manager l](./images/Utilities-FileManager-l.png) |
![]() |
![Utilities Terminal s](./images/Utilities-Terminal-s.png) |
![]() |
![Utilities Terminal m](./images/Utilities-Terminal-m.png) |
![]() |
![Utilities Terminal l](./images/Utilities-Terminal-l.png) |
![]() |
![Xubuntu Logo s](./images/Xubuntu-Logo-s.png) |
![]() |
![Xubuntu Logo m](./images/Xubuntu-Logo-m.png) |
![]() |
![Xubuntu Logo l](./images/Xubuntu-Logo-l.png) |