个人工具

“UbuntuHelp:WikiGuide/WritingGuide”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
 
第6行: 第6行:
 
The pages in this wiki should be as easy to understand and follow as possible. With this in mind, please take into account the following suggested writing style guidelines:
 
The pages in this wiki should be as easy to understand and follow as possible. With this in mind, please take into account the following suggested writing style guidelines:
 
== Terminology ==
 
== Terminology ==
* ''Ubuntu releases'' - Always try to specify which versions of Ubuntu a page is valid for. When referring to Ubuntu releases, use "Ubuntu X.XX (Nickname)" or "Ubuntu X.XX" - eg. "Ubuntu 5.10 (Breezy Badger)" or "Ubuntu 5.10", rather than just "Breezy" or "Ubuntu Breezy".
+
* ''Ubuntu releases'' - Always try to specify which versions of Ubuntu a page is valid for. When referring to Ubuntu releases, use "Ubuntu X.XX (Nickname)" or "Ubuntu X.XX" - eg:"Ubuntu 5.10 (Breezy Badger)" or "Ubuntu 5.10", rather than just "Breezy" or "Ubuntu Breezy".
 
* ''Operating Systems'' -  Capitalize the names of operating systems like Linux, Ubuntu, Windows, etc.
 
* ''Operating Systems'' -  Capitalize the names of operating systems like Linux, Ubuntu, Windows, etc.
 
* ''Repositories'' - Capitalize the names of the Universe & Multiverse repositories when you use them.
 
* ''Repositories'' - Capitalize the names of the Universe & Multiverse repositories when you use them.
 
* ''Installing software'' - When documenting how to install software, try to avoid recommending a particular package manager (such as ''apt-get'') - instead, simply use an apt link to allow the user to click on the link to install the relevant package. So, for example:
 
* ''Installing software'' - When documenting how to install software, try to avoid recommending a particular package manager (such as ''apt-get'') - instead, simply use an apt link to allow the user to click on the link to install the relevant package. So, for example:
* To enable support for mp3s in Ubuntu, [[UbuntuHelp:apt:ubuntu-restricted-extras|install the ''ubuntu-restricted-extras'' package]].
+
* To enable support for mp3s in Ubuntu, [[UbuntuHelp:apt:Ubuntu-restricted-extras|install the ''Ubuntu-restricted-extras'' package]].
 
* The wiki markup used to make the link in that example is: <pre><nowiki>
 
* The wiki markup used to make the link in that example is: <pre><nowiki>
[[apt:ubuntu-restricted-extras|install the ''ubuntu-restricted-extras'' package]]</nowiki></pre>.
+
[[apt:Ubuntu-restricted-extras|install the ''Ubuntu-restricted-extras'' package]]</nowiki></pre>.
 
== Page Titles ==
 
== Page Titles ==
 
* Be descriptive.
 
* Be descriptive.
* Avoid using the word "Howto" in the page title (everything here is a howto!).
+
* Avoid using the word "How to" in the page title (everything here is a how to).
 
* Use capital letters and avoid spaces or dashes (WikiName, for example). The wiki software permits us to use page titles like this but to display the page title with spaces. In order to achieve this effect, when creating the page, give the page title a name without spaces, and then begin the content of the page with the following:<pre><nowiki>
 
* Use capital letters and avoid spaces or dashes (WikiName, for example). The wiki software permits us to use page titles like this but to display the page title with spaces. In order to achieve this effect, when creating the page, give the page title a name without spaces, and then begin the content of the page with the following:<pre><nowiki>
 
#title Page Name</nowiki></pre> This will ensure that the page title will appear with spaces when people view the page.
 
#title Page Name</nowiki></pre> This will ensure that the page title will appear with spaces when people view the page.
第29行: 第29行:
 
. (Taken from the [http://library.gnome.org/devel/gdp-style-guide/stable/grammar.html.en GNOME Style Guide])
 
. (Taken from the [http://library.gnome.org/devel/gdp-style-guide/stable/grammar.html.en GNOME Style Guide])
 
== Links ==
 
== Links ==
* Use friendly text when creating links. For example, to link to the page [[UbuntuHelp:DrivesAndPartitions|DrivesAndPartitions]], use `[[UbuntuHelp:DrivesAndPartitions|Drives and Partitions]]` so that the link will appear like this: [[UbuntuHelp:DrivesAndPartitions|Drives and Partitions]].
+
* Use friendly text when creating links. For example, to link to the page Drives And Partitions, use `[[UbuntuHelp:Drives And Partitions|Drives and Partitions]]` so that the link will appear like this: [[UbuntuHelp:Drives And Partitions|Drives and Partitions]].
 
== Lists ==
 
== Lists ==
 
* Bullet lists of links should take the following form: <Bullet> <Link> <Hyphen> <Sentence>.
 
* Bullet lists of links should take the following form: <Bullet> <Link> <Hyphen> <Sentence>.

2010年5月20日 (四) 00:59的最新版本

  1. title Wiki Guide - Writing Guide

<<Include(WikiGuide/Toolkit/MenuBar)>>

Introduction

The pages in this wiki should be as easy to understand and follow as possible. With this in mind, please take into account the following suggested writing style guidelines:

Terminology

  • Ubuntu releases - Always try to specify which versions of Ubuntu a page is valid for. When referring to Ubuntu releases, use "Ubuntu X.XX (Nickname)" or "Ubuntu X.XX" - eg:"Ubuntu 5.10 (Breezy Badger)" or "Ubuntu 5.10", rather than just "Breezy" or "Ubuntu Breezy".
  • Operating Systems - Capitalize the names of operating systems like Linux, Ubuntu, Windows, etc.
  • Repositories - Capitalize the names of the Universe & Multiverse repositories when you use them.
  • Installing software - When documenting how to install software, try to avoid recommending a particular package manager (such as apt-get) - instead, simply use an apt link to allow the user to click on the link to install the relevant package. So, for example:
  • To enable support for mp3s in Ubuntu, install the Ubuntu-restricted-extras package.
  • The wiki markup used to make the link in that example is:
[[apt:Ubuntu-restricted-extras|install the ''Ubuntu-restricted-extras'' package]].

Page Titles

  • Be descriptive.
  • Avoid using the word "How to" in the page title (everything here is a how to).
  • Use capital letters and avoid spaces or dashes (WikiName, for example). The wiki software permits us to use page titles like this but to display the page title with spaces. In order to achieve this effect, when creating the page, give the page title a name without spaces, and then begin the content of the page with the following:
#title Page Name This will ensure that the page title will appear with spaces when people view the page.

Section Headings

  • Heading text should be short, clear, and descriptive.
  • Capitalize in the following manner:
  • Initial uppercase letter for the first word and the last word, regardless of part of speech
  • Initial uppercase letter for all nouns, adjectives, and verbs
  • Initial uppercase letter for conjunctions of four letters or longer
  • Initial uppercase letter for prepositions of four letters or longer
  • Initial uppercase letter for prepositions that are part of a phrasal verb
  • All lowercase letters for conjunctions, articles, and prepositions of less than four letters

. (Taken from the GNOME Style Guide)

Links

Lists

  • Bullet lists of links should take the following form: <Bullet> <Link> <Hyphen> <Sentence>.

. For example:

  • Skype - Internet telephony software (closed source).

Further Information


Go back to WikiGuide