UbuntuHelp:WikiGuide/Formatting/PageDraft

文章出处:

https://help.ubuntu.com/community/WikiGuide/Formatting/PageDraft

点击翻译:

English

请不要直接编辑翻译本页，本页将定期与来源同步。

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

Introduction

The wiki can often seem like a scary thing to start editing, but this is, in fact, not the case! It's easy to start editing. The wiki is in plain text with markup that's easy to learn.

Getting Started

• The best way to start is to look at how various pages were designed.
• Log in by using the link in the upper right corner of any of the wiki pages (you'll need a Launchpad account, which you can create by clicking that link).
• You can see the code of a page by selecting "Show raw text" from the More Actions drop-down menu.
• To work on a page, click the Edit link in the upper left corner of the page.
• The contents of the page will be in an edit box, with a short guide on some of the more popular types of markup beneath it.

Creating Basic Content

Table of Contents

• To include a Table of Contents, add the code in this example to the top of the page:<
  >

Example

Section Headings

• Section headings can be created by surrounding text with equal symbols. The size of the heading is determined by the number of symbols used:

Heading Type	Example
Level one heading	= Title =
Level two heading	== Title ==
Level three heading	=== Title ===

Paragraphs

• Paragraphs can be typed normally. Use a blank line to separate them from each other.

Text Formatting

• Text can be formatted by placing special characters around words or phrases:

Effect	Example	Result
Bold	'''This is bold text.'''	This is bold text.
Italic	''This is italic text.''	This is italic text.
Mono-spaced	`This is mono-spaced text.`	This is mono-spaced text.
Plain	This is plain text.	This is plain text.
Underlined	__This is underlined text.__	This is underlined text.
Superscript	This is ^super^script.	This is superscript.
Subscript	This is ,,sub,,script.	This is subscript.
Small	~-This is small text.-~	~-This is small text.-~
Large	~+This is large text.+~	~+This is large text.+~

Links

• There are various ways to create links. A few basic examples are shown here:

Link Type	Source	Example	Result
External plain link.	Any page.	[[http://www.google.com]]	http://www.google.com
External labeled link.	Any page.	[[http://www.google.com|Google]]	Google
Internal plain link.	Any page in this wiki with a CamelCase name.	WikiGuide	WikiGuide
	Any page in this wiki with or without a CamelCase name.	[[WikiGuide]]	WikiGuide
	Any sub-page in this wiki.	[[WikiGuide/Formatting]]	WikiGuide/Formatting
Internal labeled link.	Any page in this wiki.	[[WikiGuide|Wiki Guide]]	Wiki Guide

Lists

• There are three types of lists: bulleted, numbered and lettered. The wiki will handle the incrementing for you automatically. The Example|Page below shows how this works.

List Type	Method	Example
Bulleted list.	Insert a space, an asterisk, and another space at the beginning of each line.	* List item one> * List item two> * List item three
Numbered list.	Insert a space, a 1, a period, and another space at the beginning of each line.	1. List item one> 1. List item two> 1. List item three
Lettered list.	Insert a space, an a, a period, and another space at the beginning of each line.	a. List item one> a. List item two> a. List item three

Code Blocks

• To create a code block in a colored box, place `` on a line by itself, then type or paste a block of code beneath that line, and then place `` on a line by itself beneath the block of code, as shown here:

Method	Example
Wrap paragraphs in `` and `` to create a code block.	``<<BR>>code goes here<<BR>>``

Example Page

This is an example of the markup used in this [[UbuntuWiki:]] <
>

== This is a level one Section Header ==>This is a paragraph.>>=== This is a level two Section Header ===>This is a paragraph with an ``italic`` word.>This is a paragraph with a ``bold`` word.>>==== This is a level three Section Header ====>This is a bulleted list:> * this is the first item> * this is the second item> * this is the third item>>This is a numbered list:> 1. this is the first item> 1. this is the second item> 1. this is the third item>>This is a lettered list:> a. this is the first item> a. this is the second item> a. this is the third item>>``<<BR>>this is a block of code<<BR>>``>>This is the end of the example page.

This is how the page created with the above markup would look:

This is a level one Section Header

This is a paragraph.

This is a level two Section Header

This is a paragraph with an italic word. This is a paragraph with a bold word.

This is a level three Section Header

This is a bulleted list:

• this is the first item
• this is the second item
• this is the third item

This is a numbered list:

1. this is the first item
2. this is the second item
3. this is the third item

This is a lettered list:

1. this is the first item
2. this is the second item
3. this is the third item

this is a block of code

This is the end of the example page.

See Also

• HelpContents - The main help pages of this wiki.
• HelpForUsers - A list of pages that are useful for new users.
• HelpOnEditing - Detailed help on editing and drafts.
• HelpOnPageCreation - A page on how (and when) to create pages.
• IconsPage - A page on the use of icons in the wiki.
• MoinMoin - A list of pages with information on Moin'Moin wikis.
• SyntaxReference - A cheat sheet of Moin'Moin syntax with examples.

---

Go back to WikiGuide