Help:Style

From XFamily - Children of God
Revision as of 00:46, 15 August 2005 by Craven de Kere (talk | contribs) (+icons section, please add all icons here)

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-liscense their contributions.
  • Template:FairUse - {{Template:FairUse}} - For use where fair use rights are invoked.

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

  • Icon star.gif - [[Image:Icon_star.gif]] - To highlight a certain link on a page that is worthwhile to the reader. Use sparingly to avoid dillution.

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)

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