Help:Style
Contents
Introduction to Style Guide
Basics
Attribution
The summary field for edits should be used to attribute contributions whenever possible.
Categorization
This section is a placeholder. This means it is incomplete and in need of further elaboration.
We will update this as time permits.
Disclaimer
Pages displaying content from The Family should use a disclaimer. Please see the template section below for the approptiate template to use.
Templates
Templates exist Under "Templates:Foo". They are invoked in articles using the following syntax: {{foo}} which then displays the content of the template in the article at the position of the tag. Editors should document any templates they create below:
- Template:Caution - {{caution}} - For articles by xFamily which contain explicit text or images.
- Template:Construction - {{construction}} - For use in articles which do not need outside content contributions.
- Template:Stub - {{stub}} - For use in incomplete articles for which we are accepting outside content contributions.
- Template:Sectionstub - {{sectionstub}} - For use in incomplete article sections for which we are accepting outside content contributions.
- Template:Placeholder - {{placeholder}} - For use in "placeholder" sections within an article.
- Template:Disclaimer-family - {{disclaimer-family}} - For use in articles from The Family which may contain offensive content.
- Template:Disclaimer-article - {{disclaimer-article}} - For use in articles reproduced herein "as is".
- Template:Disclaimer-article-inaccurate - {{disclaimer-article-inaccurate}} - For use in articles reproduced herein "as is" when known to contain inaccuracies.
- Template:Privacy-edited - {{privacy-edited}} - For use in articles where a name has been removed.
- Template:Purged-Document - {{purged-document}} - For use in articles where original material has been purged by The Family International.
- Template:Public-Domain - {{Public-Domain}} - For use in editor's personal profiles should they wish to multi-license their contributions.
- Template:FairUse - {{FairUse}} - For use where fair use rights are invoked.
- Template:Pseudonym - {{Pseudonym|Name}} - For use in name disambiguation pages. Invoke with the name as the template parameter using a pipe character after the template name followed by the name being disambiguated.
- Template:External-author - {{External-author|external author}} - For use in delineating texts by external authors that are reproduced on xFamily.org without the collaborative editing process of our regular articles. Pass the external author's name in as a parameter.
Code Snippets
Quoting
If you include excerpts from or the entire contents of documents, please place them within a blockquote
. If there are quotes within the document, please also place them within a blockquote
.
The following is an example of how this is done:
<div style="padding: 1em; margin: 10px; border: 2px dotted green;"> <small><font color=green>1</font></small> The Devil hates... </div>
This would result in a border like this:
1 The Devil hates...
Icons
Use of the following icons is optional.
- - [[Image:Icon_star.gif|Featured]] - To highlight a certain link on a page that is worthwhile to the reader. Use sparingly to avoid dillution.
- - [[Image:Icon_video.gif|Video]]
- - [[Image:Icon_audio.gif|Audio]]
- - [[Image:Icon_music.gif|Music]]
- - [[Image:Icon_pdf.gif|PDF]]
Article Talk Pages
Please follow these guidelines when using the article talk pages ("discussion" tab).
Threads are demarcated by nested lists. For example
- This is the first part of a thread. --Craven de Kere 14:13, 10 Jun 2005 (CDT)
- This is the response. --Craven de Kere 14:13, 10 Jun 2005 (CDT)
- This is yet another response. --Craven de Kere 14:13, 10 Jun 2005 (CDT)
- This is the response. --Craven de Kere 14:13, 10 Jun 2005 (CDT)
Comments should be signed. Using the following code automatically inserts a signature: --~~~~
New threads should be placed above the older ones on an article talk page. In some cases, the forum is a more appropriate place for discussion.
Tools
Bible Online
When linking to Bible verses use the following script. It will be updated to use a functional online reference resource should the current resource cease to function. Using this script allows us to easily update all Bible references in such a scenario.
The script is located at: http://www.xfamily.org/xscripts/bible/
You should add GET variables to the URL to redirect to a particular passage. See the example below.
http://www.xfamily.org/xscripts/bible/?book=Matthew&chapter=9&verse=17
Ranges are allowed. Please see the example below:
http://www.xfamily.org/xscripts/bible/?book=Matthew&chapter=9&verse=17-20
When a space exists in one of the variables you should use "%20" (no quotation marks) to represent the space. This is necessary with books like I John. Please see the example below:
http://www.xfamily.org/xscripts/bible/?book=I%20John&chapter=1&verse=1
xFamily Forum
When linking to specific portions of the xFamily Forum use the following script. It will be updated to use updated links should the current forum link structure change. Using this script allows us to easily update all forum references in such a scenario.
The script is located at: http://www.xfamily.org/xscripts/forum/
You should add GET variables to the URL to redirect to a particular passage. See the examples below.
Topics
http://www.xfamily.org/xscripts/forum/?topic=1
Posts
http://www.xfamily.org/xscripts/forum/?post=1
Forums
http://www.xfamily.org/xscripts/forum/?forum=1
Users
http://www.xfamily.org/xscripts/forum/?user=1
Categories
http://www.xfamily.org/xscripts/forum/?category=1
Search
http://www.xfamily.org/xscripts/forum/?search=Berg
When a space exists in your forum search query you should use "%20" (no quotation marks) to represent the space. Please see the example below:
http://www.xfamily.org/xscripts/forum/?search=David%20Berg
Sandbox
The sandbox is a place to experiment with this wiki. You can find it here: Sandbox