docs: update doc/omawiki-style-guide

This commit is contained in:
ru ru 2020-03-13 11:56:41 +00:00 committed by omakuta
parent 2f9e24a5b8
commit 51ebd249b1
1 changed files with 28 additions and 1 deletions

View File

@ -2,7 +2,7 @@
title: OpenMandriva wiki specific style guide
description:
published: true
date: 2020-03-13T11:27:43.318Z
date: 2020-03-13T11:56:40.455Z
tags: howto
---
@ -16,3 +16,30 @@ tags: howto
{.is-info}
### Images
Screenshots and common images which are inserted in wiki pages must be uploaded **only** to `/images` folder.
It is what the folder has been created for.
Images file name should not contain:
- Space (use dashes instead)
- Underscore (use dashes instead)
- Period (reserved for file extensions)
- Unsafe URL characters (such as punctuation marks, quotes, math symbols, etc.)
When at all possible, rename your image filename to something meaningful related to the page or to what you are showing.
### Paths
Paths must be lowercase. Use dashed to separate the words.
No punctuation allowed except dashes/hyphens and/or underscores.
No need for full title of the page in the path: it can, and should when possible, be shortened.
Paths cannot contain the following characters:
- Space (use dashes instead)
- Period (reserved for file extensions)
- Unsafe URL characters (such as punctuation marks, quotes, math symbols, etc.)
As we often have to write release version number (4.0, 4.1, 4.2, etc.), while creating new pages just convert it into `40`, `41`, `42`, etc. by omitting the dot in the path.