Battlestar Wiki:Tutorial (Formatting): Difference between revisions

From Battlestar Wiki, the free, open content Battlestar Galactica encyclopedia and episode guide
(→‎Wikipedia formatting style: del broken link--anyone know of a new one?)
mNo edit summary
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Project|Tutorial|image=BSG WIKI Tutorial.png|shortcut=BW:T<br/>BW:TUT}}
{{tutorial}}
{{tutorial}}
Most text '''formatting''' is usually done with Wiki markup, so people don't have to learn [[Wikipedia:HTML|HTML]].


==Wiki markup==
__NOTOC__
Writing for wikipedia articles is a bit different from writing on a standard word processor.  Instead of a strict "what you see is what you get" approach, wiki uses simple text codes for formatting.  The approach is similar to that used in writing HTML for web pages, but the codes are simpler.
 
Most text '''formatting''' is usually done with Wiki markup, so people don't have to learn [[Wikipedia:Wikipedia:HTML|HTML]]. Wiki markup ([[BW:MARK]]) also allows the site to stay uniformed.
 
== Wiki markup ==
Writing ''Battlerstar Wiki'' articles is a bit different from writing on a standard word processor.  Instead of a strict "what you see is what you get" approach, wiki uses simple text codes for formatting.  The approach is similar to that used in writing HTML for web pages, but the codes are simpler.


The wiki can accept some [[Wikipedia:HTML|html]] tags directly, but most people use the built-in [[Wikipedia:wiki|wiki]] markup language, which is designed for ease of editing.  
The wiki can accept some [[Wikipedia:Wikipedia:HTML|html]] tags directly, but most people use the built-in [[BW:MARK|wiki]] markup language, which is designed for ease of editing. The Wiki markup is unique to the wiki software.  


===Bold and italics===
=== Bold and italics ===
The most commonly used wiki tags are '''bold''' and ''italics''. '''Bolding''' and ''italicizing'' is done by surrounding a word or phrase with multiple apostrophes ('):
The most commonly used wiki tags are '''bold''' and ''italics''. '''Bolding''' and ''italicizing'' is done by surrounding a word or phrase with multiple apostrophes ('); '''not''' quotes ("):


*<tt><nowiki>''italics''</nowiki></tt> is rendered as ''italics''. (2 apostrophes on either side)
*<tt><nowiki>''italics''</nowiki></tt> is rendered as ''italics''. (2 apostrophes on either side)
Line 14: Line 19:
*<tt><nowiki>'''''bolded italics'''''</nowiki></tt> is rendered as '''''bolded italics'''''.  (2&nbsp;+&nbsp;3&nbsp;=&nbsp;5 apostrophes on either side)  
*<tt><nowiki>'''''bolded italics'''''</nowiki></tt> is rendered as '''''bolded italics'''''.  (2&nbsp;+&nbsp;3&nbsp;=&nbsp;5 apostrophes on either side)  


A Wikipedia convention is to ''italicize'' book, movie and computer/video game titles. If the first mention of the subject of an article is also a book or movie title then ''italics'' are used. For example, the article ''[[Battlestar Galactica]]'' starts:
Using italics, '''bold''', or '''''both''''', depends largely on the user, but some things are set in stone by the [[BW:SAC|conventions]] set forth by this wiki. One of the ''Battlestar Wiki'' [[BW:SAC|conventions]] is to ''italicize'' ship names also. For example, the article about ''[[Colonial One]]'' starts off with the text:
 
<blockquote>'''''Colonial One''''' is the passenger liner starship on which President [[Laura Roslin]] resides and where she sets up her new seat of government in the [[The Fleet (RDM)|refugee fleet]] led by the battlestar ''[[Galactica (RDM)|Galactica]]''.</blockquote>


<blockquote>Please select a more precise entry:
The code looks like so:


*''[[Battlestar Galactica (RDM)|Battlestar Galactica]]'' series by [[Ronald D. Moore]] that began airing in late 2003.
<blockquote><tt><nowiki>'''''Colonial One''''' is the passenger liner starship on which President [[Laura Roslin]] resides and where she sets up her new seat of government in the [[The Fleet (RDM)|refugee fleet]] led by the battlestar ''[[Galactica (RDM)|Galactica]]''.</nowiki></tt></blockquote>
*''[[Battlestar Galactica (mini-series)|Battlestar Galactica Mini-Series]]'' by [[Ronald D. Moore]] that was the backdoor pilot for the [[Battlestar Galactica (RDM)|series]].
 
*''[[Battlestar Galactica (TOS)|Battlestar Galactica]]'' created by [[Glen A. Larson]] that aired in 1978.</blockquote>
''Colonial One'' has '''''both''''' because it is a ship name and it's the first use of the article name. ''[[Galactica (RDM)|Galactica]]'' is only ''italicized'' because it's a ship name (but not the name of the article). There are many other examples on when and where this wiki code is used. Just click on [[Special:Random|here]] for a random page to see other pages.


===Headings and subheadings===
===Headings and subheadings===
Line 31: Line 38:
*<tt><nowiki>=====Another level down=====</nowiki></tt> (5 equals signs)
*<tt><nowiki>=====Another level down=====</nowiki></tt> (5 equals signs)


If an article has at least three headings, a table of contents will be automatically generated. Try creating a heading in this page's [[/sandbox/]]. It will be automatically added to the table of contents for the page. When you're done, click below to continue.
If an article has at least three headings, a table of contents will be automatically generated. Try creating a heading in this page's [[BW:SAND|sandbox]]. It will be automatically added to the table of contents for the page. There are certain items that will disable and manipulate the TOC. They can be read on the [[BW:MARK]] page.
 
===Indenting===
For instructions on how to indent, see [[Battlestar Wiki:Tutorial (Talk pages)|Chapter 6 of this tutorial]]


==Wikipedia formatting style==
== Indenting ==
:''For instructions on how to indent, see [[Battlestar Wiki:Tutorial (Talk pages)|chapter 7]] of this tutorial.''


[[Battlestar Wiki:Tutorial (Wikipedia links)|Continue]] with the tutorial.
{{start box}}
{{next box|before=[[Battlestar Wiki:Tutorial (Editing)|Editing]]|title=Formatting|after=[[Battlestar Wiki:Tutorial (internal links)|Internal links]]}}
{{end box}}


[[Category:Wikipedia tutorial|*2]]
[[fr:Battlestar Wiki:Tutoriel (Formatage)]]

Latest revision as of 00:53, 12 June 2020

This page is one of Battlestar Wiki's many projects.
This page serves to coordinate discussion on a particular aspect of this Wiki. The formal recommendations of a project may be treated as policies.
Shortcut:
BW:T
BW:TUT


Battlestar Wiki Tutorial
Tutorial chapters...
  1. Front page
  2. Editing
  3. Formatting
  4. Internal links
  5. Related site links
  6. External links
  7. Talk pages
  8. Citing
  9. Images
  10. Keep in mind
  11. Registration
  12. Namespaces
  13. Wrap-up
See also...
Help page
Goto Sandbox



Most text formatting is usually done with Wiki markup, so people don't have to learn HTML. Wiki markup (BW:MARK) also allows the site to stay uniformed.

Wiki markup

Writing Battlerstar Wiki articles is a bit different from writing on a standard word processor. Instead of a strict "what you see is what you get" approach, wiki uses simple text codes for formatting. The approach is similar to that used in writing HTML for web pages, but the codes are simpler.

The wiki can accept some html tags directly, but most people use the built-in wiki markup language, which is designed for ease of editing. The Wiki markup is unique to the wiki software.

Bold and italics

The most commonly used wiki tags are bold and italics. Bolding and italicizing is done by surrounding a word or phrase with multiple apostrophes ('); not quotes ("):

  • ''italics'' is rendered as italics. (2 apostrophes on either side)
  • '''bold''' is rendered as bold. (3 apostrophes on either side)
  • '''''bolded italics''''' is rendered as bolded italics. (2 + 3 = 5 apostrophes on either side)

Using italics, bold, or both, depends largely on the user, but some things are set in stone by the conventions set forth by this wiki. One of the Battlestar Wiki conventions is to italicize ship names also. For example, the article about Colonial One starts off with the text:

Colonial One is the passenger liner starship on which President Laura Roslin resides and where she sets up her new seat of government in the refugee fleet led by the battlestar Galactica.

The code looks like so:

'''''Colonial One''''' is the passenger liner starship on which President [[Laura Roslin]] resides and where she sets up her new seat of government in the [[The Fleet (RDM)|refugee fleet]] led by the battlestar ''[[Galactica (RDM)|Galactica]]''.

Colonial One has both because it is a ship name and it's the first use of the article name. Galactica is only italicized because it's a ship name (but not the name of the article). There are many other examples on when and where this wiki code is used. Just click on here for a random page to see other pages.

Headings and subheadings

Headings and subheadings are an easy way to improve the organization of an article. If you can see two or more distinct topics being discussed, you can break up your article by inserting a heading for each section.

Headings can be created like this:

  • ==Top level heading== (2 equals signs)
  • ===Subheading=== (3 equals signs)
  • ====Another level down==== (4 equals signs)
  • =====Another level down===== (5 equals signs)

If an article has at least three headings, a table of contents will be automatically generated. Try creating a heading in this page's sandbox. It will be automatically added to the table of contents for the page. There are certain items that will disable and manipulate the TOC. They can be read on the BW:MARK page.

Indenting

For instructions on how to indent, see chapter 7 of this tutorial.


Previous:
Editing
Formatting Next:
Internal links