Jump to content

FamilySearch Wiki:Manual of Style: Difference between revisions

edited bold, italics, and underline sections
No edit summary
(edited bold, italics, and underline sections)
Line 1: Line 1:
A '''style guide''' or '''style manual''' is a set of standards for design and writing of documents, either for general use or for a specific publication or organization. Web site style guides focus on a publication's visual and technical aspects, prose style, best usage, grammar, punctuation, spelling, and fairness. The consistent use of style guidelines provides uniformity in style and formatting of wiki articles, which makes the articles easier for readers to understand and use.
A '''style guide''' or '''style manual''' is a set of standards for design and writing of documents, either for general use or for a specific publication or organization. Web site style guides focus on a publication's visual and technical aspects, prose style, best usage, grammar, punctuation, spelling, and fairness. The consistent use of style guidelines provides uniformity in style and formatting of wiki articles, which makes the articles easier for readers to understand and use.  


== General Principles  ==
== General Principles  ==
Line 17: Line 17:
Abbreviations, including US postal codes, should not be used in article titles or text because abbreviations can mean different things in different parts of the world. For example, the abbreviation CA could mean either California or Canada, depending on the reader's nationality.  
Abbreviations, including US postal codes, should not be used in article titles or text because abbreviations can mean different things in different parts of the world. For example, the abbreviation CA could mean either California or Canada, depending on the reader's nationality.  


For more information about naming conventions, see also [[Help:Naming conventions]].
For more information about naming conventions, see also [[Help:Naming conventions]].  


=== Rename an existing article  ===
=== Rename an existing article  ===
Line 29: Line 29:
=== Character Formatting  ===
=== Character Formatting  ===


==== Font ====
==== Font ====


Regardless of the font you paste into the wiki edit screen, your work will be saved in the system's default font.  
Regardless of the font you paste into the wiki edit screen, your work will be saved in the system's default font.  


==== Bold  ====
==== Bold  ====
In rare cases, if a word must be emphasized, use bold.


==== Italics  ====
==== Italics  ====
Use italics if a word must be emphasized. List book titles in italics. Do not use italics for quoted text.


==== Underline  ====
==== Underline  ====


Because the use of underline frequently indicates text with a [http://www.webopedia.com/TERM/h/hyperlink.html hyperlink] that can be clicked to learn more, do not use underline as a way to emphasize text.  
Because the use of underline indicates text with a [http://www.webopedia.com/TERM/h/hyperlink.html hyperlink] that can be clicked to learn more, do not use underline as a way to emphasize text.Do not underline book titles.<br>


==== Capitalization ====
==== Capitalization ====


=== Source Citations ===
=== Source Citations ===


=== Geographical Names  ===
=== Geographical Names  ===
Line 49: Line 53:
A proposed style guideline ''[[FamilySearch Wiki:Naming Conventions for Geographic Names|Naming Conventions for Geographic Names]]'' is being [[FamilySearch Wiki talk:Naming Conventions for Geographic Names|discussed]]. Once a [[FamilySearch Wiki:Consensus|consensus]] is reached a guideline will be adopted.  
A proposed style guideline ''[[FamilySearch Wiki:Naming Conventions for Geographic Names|Naming Conventions for Geographic Names]]'' is being [[FamilySearch Wiki talk:Naming Conventions for Geographic Names|discussed]]. Once a [[FamilySearch Wiki:Consensus|consensus]] is reached a guideline will be adopted.  


=== Acronyms and Abbreviations ===
=== Acronyms and Abbreviations ===


== Linking  ==
== Linking  ==
{{main|FamilySearch Wiki:Linking}}
 
{{main|FamilySearch Wiki:Linking}}  
 
=== Linking to other articles in FamilySearch wiki  ===
=== Linking to other articles in FamilySearch wiki  ===


*[[FamilySearch Wiki:Linking]]
*[[FamilySearch Wiki:Linking]]  
*[[Help:Create an internal link]]
*[[Help:Create an internal link]]  
*[[Help:Create an external link]]
*[[Help:Create an external link]]  
*[[Help:Advanced Linking]]
*[[Help:Advanced Linking]]  
*[[Help:Section]] - the content under "Section linking" appears to be incorrect. A review is needed.
*[[Help:Section]] - the content under "Section linking" appears to be incorrect. A review is needed.  
*[[Help:Wiki markup]]
*[[Help:Wiki markup]]


Line 75: Line 81:
*{{tl|Cat also}} - see Wikipedia's Template:Cat also for details
*{{tl|Cat also}} - see Wikipedia's Template:Cat also for details


==== Linking through the use of metatemplates ====
==== Linking through the use of metatemplates ====


*See [[:Category:Metatemplates]] for a list of metatemplates available for use
*See [[:Category:Metatemplates]] for a list of metatemplates available for use
Line 123: Line 129:
Using the {{tl|Wikipedia}} template for these links will allow the links to be easily updated if the web address changes.  
Using the {{tl|Wikipedia}} template for these links will allow the links to be easily updated if the web address changes.  


==== Maps ====
==== Maps ====


== Box layout: columns vs. portals  ==
== Box layout: columns vs. portals  ==


Authors desiring to display a wiki page's content in boxes should use tables within columns instead of using sub-pages within portals. To see the code that allows one to layout columns and tables, go to the [[Maryland|Maryland page]], click '''Edit''', and switch to Wikitext view. To see an example of portal code, go to the [http://en.wikipedia.org/wiki/Portal:India India portal on Wikipedia] and click '''Edit this page'''. For more about this topic, see [[FamilySearch Wiki:The Un-Portal Page |The Un-Portal Page]].  
Authors desiring to display a wiki page's content in boxes should use tables within columns instead of using sub-pages within portals. To see the code that allows one to layout columns and tables, go to the [[Maryland|Maryland page]], click '''Edit''', and switch to Wikitext view. To see an example of portal code, go to the [http://en.wikipedia.org/wiki/Portal:India India portal on Wikipedia] and click '''Edit this page'''. For more about this topic, see [[FamilySearch Wiki:The Un-Portal Page|The Un-Portal Page]].  


{{policies and guidelines}}
{{policies and guidelines}}