Difference between revisions of "Help:Style"

From XFamily - Children of God
m (Templates: small update, note: I ran a find/replace sql query through shell to clean up my deviant template tags, this may have made some of my previous edits seem nonsensical and/or identical)
m (Templates)
Line 32: Line 32:
 
*[[Template:FairUse]] - <nowiki>{{FairUse}}</nowiki> - For use where fair use rights are invoked.
 
*[[Template:FairUse]] - <nowiki>{{FairUse}}</nowiki> - For use where fair use rights are invoked.
 
*[[Template:Pseudonym]] - <nowiki>{{Pseudonym|Name}}</nowiki> - 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:Pseudonym]] - <nowiki>{{Pseudonym|Name}}</nowiki> - 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]] - <nowiki>{{External-author|external author}}</nowiki> - 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==
 
==Code Snippets==

Revision as of 09:04, 4 September 2005

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.

  • Featured - [[Image:Icon_star.gif|Featured]] - To highlight a certain link on a page that is worthwhile to the reader. Use sparingly to avoid dillution.
  • Video - [[Image:Icon_video.gif|Video]]
  • Audio - [[Image:Icon_audio.gif|Audio]]
  • Music - [[Image:Icon_music.gif|Music]]
  • PDF - [[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)

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