Wiki source for GrWikiStyleGuide
[[GrHomePage Αρχική σελίδα]] > [[WikiIndex Ευρετήριο του Wiki]] > [[GrWikiStyleGuide Πρότυπο διαμόρφωσης του Wiki]]
====Πρότυπο διαμόρφωσης του Wiki====
==Στόχοι==
~- Μείωση των διαφορών μεταξύ των άρθρων ανά γλώσσα με συνεχή ενημέρωση.
~- Μείωση των παραλείψεων και των λαθών του Wiki, προσοχή στην κατηγοριοποίηση.
~- Αφαίρεση μη ενεργών συνδέσμων και πεπαλαιωμένων πληροφοριών.
~- Βελτιστοποίηση ευχρηστίας και προσβασιμότητας των χρηστών στο Wiki.
~- Ενιαία μορφοποίηση βάση προτύπου για ομοιομορφία και ευχρηστία.
~- Ο οδηγός αυτός είναι ένα έργο υπό εξέλιξη, βοηθήστε να ολοκληρωθεί με σχόλια και ιδέες!
==Titles==
~H3 title may only be used once at top of article.
~==== Title ====
~%%==== Title ====%%
~H5 size titles to designate article sections
~== Section==
~%%== Section ==%%
~Use bold to designate article sub-section
~**Sub-Section**
~%%**Sub-Section**%%
~Headers can be directly link to for example: [[http://puppylinux.org/wikka/WikiStyleGuide#hn_Titles]]
==Breadcrumbs==
~Breadcrumbs are used at the top of the articles. They point to index pages and help give the wiki structure. If a page has no other pages linking to it and no category, then a user might not find it. Think about which index the page belongs to. For example, media player software would go on the Multimedia software index, code:
~[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareMultimedia Multimedia]]
~%%[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareMultimedia Multimedia]]%%
==Footers==
~Articles should include a Category footer, for example
~%%
(line return here)
(line return here)
----
==Categories==
CategoryExample%%
==Paragraph Indents==
~Paragraphs should come immediately under the title and be indented using a tab, use tab key or ##~## character. An exception is categories (and tables while the Wikka bug persists).
==Links==
~Try to link internal to the Wiki where possible. This reduces jumping back and forth between websites. At the end of a pages relevant internal links are often listed under **Also on the Wiki** and relevant external links **Related Websites**.
==Forum Links==
~If it isn't obvious from the url where a link goes please provide this information. An example is forum links, as they only show a number and not the thread's or post's title. Example:
~[[http://www.murga-linux.com/puppy/viewtopic.php?t=80232 Help needed writing the Wiki thread]]
~%%[[http://www.murga-linux.com/puppy/viewtopic.php?t=80232 Help needed writing the Wiki thread]]%%
==Puppy related software offered for download (pet files etc)==
~Provide a direct link or link to where it can be downloaded. It is help to provide the version in the link, and comment who the packager is. Software icons go above the title and may point to an external link, for example:
~{{image url="http://qtractor.sourceforge.net/image/qtractor.png" link="http://qtractor.sourceforge.net/qtractor-index.html" title="qtractor icon" alt="qtractor icon"}}
~====Qtractor====
~%%{{image url="http://qtractor.sourceforge.net/image/qtractor.png" link="http://qtractor.sourceforge.net/qtractor-index.html" title="qtractor icon" alt="qtractor icon"}}
====Qtractor====%%
==Tables==
~Used for data or to create columns. There is currently an error in Wikka that breaks the formatting if a table in indented. Here an example of table code:
~|=|Header 1|=|Header 2||
||Cell 1||Cell 2||
~%%|=|Header 1|=|Header 2||
||Cell 1||Cell 2||%%
==Red text==
~Should be used for warnings and alerts and not in titles either.
~{{color text="Warning:" c="red"}}
~%%{{color text="Warning:" c="red"}}%%
==Underline==
~Use underline to call attention to text within the article (not in titles).
~__significant__
~%%__significant__%%
==Bullet Points==
~Use a list to place bullets on special points within articles.
~%% - This is a bulleted point%%
==""CamelCase"" and internal links==
~[[Docs:CamelCase CamelCase]] is used by Wikka to denote an internal link. Pages that don't have ""CamelCase"" style names need the double square bracket, for example:
~[[alsa]]
~%%[[alsa]]%%
~Sometimes you don't want to link to a page, use the double quotes
~""LinkNotWanted""
~%%""LinkNotWanted""%%
~If a page doesn't exist but would be useful in the future - leave the link in place, this will remind people that the page is desired.
==HTML==
~Avoid HTML in articles, not all editors are proficient with it. Most things can be done in wiki code and the Wikka software is under active development. The double quotes is used to denote html, double quotes are also used to prevent unwanted linking, see above.
==Pictures and graphics==
~Use a title text and alt text. This enables people who use screen readers to better understand articles.
~{{image url="http://www.murga-linux.com/puppy/viewtopic.php?mode=attach&id=57682" title="filetype icon" alt="filetype icon"}}
~%%{{image url="http://www.murga-linux.com/puppy/viewtopic.php?mode=attach&id=57682" title="filetype icon" alt="filetype icon"}}%%
==Text and graphics are preferred for articles==
~Many people either do not have access to broadband or can’t afford it. Video is of no use to people using [[http://www.thefreecountry.com/utilities/free-screen-readers.shtml Screen Readers]].
==Vertically tall graphics should be placed on the right==
~So text may flow up and left of them. Vertically short graphics may simply be placed normally and thus appear on the left. The code below is taken from the [[Dpup article article]]
~%%{{image class="right" url="http://dpup.org/images/beta4-3.jpg" title="Dpup screenshot" alt="Dpup screenshot"}}{{image url="http://www.dpup.org/images/logo.gif" title="Dpup.org logo" alt="Dpup.org logo"}}%%
~Alternatively, the graphic can be sized using height and width attributes.
==Colors==
~Example, {{color text="coming:" c="teal"}} {{color text="soon" c="fuchsia"}}
~%%{{color text="color" c="teal"}} {{color text="color text" c="fuchsia"}}%%
==Page development and Discussion==
~If you are making a major/controversial change to a page please comment below the page first. This allows other users to give feedback. The comment button is equivalent to wikipedia's talk area on pages. The RecentlyCommented pages show the most recent discussion.
==Redirecting==
~If there are two or more different pages names that could apply then 'redirect' may be useful. For example there is a page for Orange, Oranges can redirect to that page using this code,
~%%{{redirect target="Oranges"}}%%
==Also on the Wiki==
~FormattingRules
----
==Categories==
CategoryWiki
[[CategoryGreek Ελληνικές σελίδες]]
====Πρότυπο διαμόρφωσης του Wiki====
==Στόχοι==
~- Μείωση των διαφορών μεταξύ των άρθρων ανά γλώσσα με συνεχή ενημέρωση.
~- Μείωση των παραλείψεων και των λαθών του Wiki, προσοχή στην κατηγοριοποίηση.
~- Αφαίρεση μη ενεργών συνδέσμων και πεπαλαιωμένων πληροφοριών.
~- Βελτιστοποίηση ευχρηστίας και προσβασιμότητας των χρηστών στο Wiki.
~- Ενιαία μορφοποίηση βάση προτύπου για ομοιομορφία και ευχρηστία.
~- Ο οδηγός αυτός είναι ένα έργο υπό εξέλιξη, βοηθήστε να ολοκληρωθεί με σχόλια και ιδέες!
==Titles==
~H3 title may only be used once at top of article.
~==== Title ====
~%%==== Title ====%%
~H5 size titles to designate article sections
~== Section==
~%%== Section ==%%
~Use bold to designate article sub-section
~**Sub-Section**
~%%**Sub-Section**%%
~Headers can be directly link to for example: [[http://puppylinux.org/wikka/WikiStyleGuide#hn_Titles]]
==Breadcrumbs==
~Breadcrumbs are used at the top of the articles. They point to index pages and help give the wiki structure. If a page has no other pages linking to it and no category, then a user might not find it. Think about which index the page belongs to. For example, media player software would go on the Multimedia software index, code:
~[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareMultimedia Multimedia]]
~%%[[HomePage]] > [[SoftwareIndex Software Index]] > [[SoftwareMultimedia Multimedia]]%%
==Footers==
~Articles should include a Category footer, for example
~%%
(line return here)
(line return here)
----
==Categories==
CategoryExample%%
==Paragraph Indents==
~Paragraphs should come immediately under the title and be indented using a tab, use tab key or ##~## character. An exception is categories (and tables while the Wikka bug persists).
==Links==
~Try to link internal to the Wiki where possible. This reduces jumping back and forth between websites. At the end of a pages relevant internal links are often listed under **Also on the Wiki** and relevant external links **Related Websites**.
==Forum Links==
~If it isn't obvious from the url where a link goes please provide this information. An example is forum links, as they only show a number and not the thread's or post's title. Example:
~[[http://www.murga-linux.com/puppy/viewtopic.php?t=80232 Help needed writing the Wiki thread]]
~%%[[http://www.murga-linux.com/puppy/viewtopic.php?t=80232 Help needed writing the Wiki thread]]%%
==Puppy related software offered for download (pet files etc)==
~Provide a direct link or link to where it can be downloaded. It is help to provide the version in the link, and comment who the packager is. Software icons go above the title and may point to an external link, for example:
~{{image url="http://qtractor.sourceforge.net/image/qtractor.png" link="http://qtractor.sourceforge.net/qtractor-index.html" title="qtractor icon" alt="qtractor icon"}}
~====Qtractor====
~%%{{image url="http://qtractor.sourceforge.net/image/qtractor.png" link="http://qtractor.sourceforge.net/qtractor-index.html" title="qtractor icon" alt="qtractor icon"}}
====Qtractor====%%
==Tables==
~Used for data or to create columns. There is currently an error in Wikka that breaks the formatting if a table in indented. Here an example of table code:
~|=|Header 1|=|Header 2||
||Cell 1||Cell 2||
~%%|=|Header 1|=|Header 2||
||Cell 1||Cell 2||%%
==Red text==
~Should be used for warnings and alerts and not in titles either.
~{{color text="Warning:" c="red"}}
~%%{{color text="Warning:" c="red"}}%%
==Underline==
~Use underline to call attention to text within the article (not in titles).
~__significant__
~%%__significant__%%
==Bullet Points==
~Use a list to place bullets on special points within articles.
~%% - This is a bulleted point%%
==""CamelCase"" and internal links==
~[[Docs:CamelCase CamelCase]] is used by Wikka to denote an internal link. Pages that don't have ""CamelCase"" style names need the double square bracket, for example:
~[[alsa]]
~%%[[alsa]]%%
~Sometimes you don't want to link to a page, use the double quotes
~""LinkNotWanted""
~%%""LinkNotWanted""%%
~If a page doesn't exist but would be useful in the future - leave the link in place, this will remind people that the page is desired.
==HTML==
~Avoid HTML in articles, not all editors are proficient with it. Most things can be done in wiki code and the Wikka software is under active development. The double quotes is used to denote html, double quotes are also used to prevent unwanted linking, see above.
==Pictures and graphics==
~Use a title text and alt text. This enables people who use screen readers to better understand articles.
~{{image url="http://www.murga-linux.com/puppy/viewtopic.php?mode=attach&id=57682" title="filetype icon" alt="filetype icon"}}
~%%{{image url="http://www.murga-linux.com/puppy/viewtopic.php?mode=attach&id=57682" title="filetype icon" alt="filetype icon"}}%%
==Text and graphics are preferred for articles==
~Many people either do not have access to broadband or can’t afford it. Video is of no use to people using [[http://www.thefreecountry.com/utilities/free-screen-readers.shtml Screen Readers]].
==Vertically tall graphics should be placed on the right==
~So text may flow up and left of them. Vertically short graphics may simply be placed normally and thus appear on the left. The code below is taken from the [[Dpup article article]]
~%%{{image class="right" url="http://dpup.org/images/beta4-3.jpg" title="Dpup screenshot" alt="Dpup screenshot"}}{{image url="http://www.dpup.org/images/logo.gif" title="Dpup.org logo" alt="Dpup.org logo"}}%%
~Alternatively, the graphic can be sized using height and width attributes.
==Colors==
~Example, {{color text="coming:" c="teal"}} {{color text="soon" c="fuchsia"}}
~%%{{color text="color" c="teal"}} {{color text="color text" c="fuchsia"}}%%
==Page development and Discussion==
~If you are making a major/controversial change to a page please comment below the page first. This allows other users to give feedback. The comment button is equivalent to wikipedia's talk area on pages. The RecentlyCommented pages show the most recent discussion.
==Redirecting==
~If there are two or more different pages names that could apply then 'redirect' may be useful. For example there is a page for Orange, Oranges can redirect to that page using this code,
~%%{{redirect target="Oranges"}}%%
==Also on the Wiki==
~FormattingRules
----
==Categories==
CategoryWiki
[[CategoryGreek Ελληνικές σελίδες]]
