Difference between revisions of "Style and Presentation"

From the Family Tree Forum Reference Library
m
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
__NOEDITSECTION__
 
__NOEDITSECTION__
 
[[Category:Help]]
 
[[Category:Help]]
[[image:building3.jpg|center|frame|Page being edited by [[User:Caroline|Caroline]]]]
 
 
----
 
 
 
[[image:style1.jpg]]
 
[[image:style1.jpg]]
 
  
 
{| width="100%" border="0" cellspacing="5" cellpadding="5"  
 
{| width="100%" border="0" cellspacing="5" cellpadding="5"  
 
|-valign="top"
 
|-valign="top"
 
| style="width:350px" align="center"| __TOC__
 
| style="width:350px" align="center"| __TOC__
|Please refer to the [[Help:Notes for Editors]] and [[Authoring]] for further information about the conventions of Wiki presentation style.
 
  
The Help Pages also give examples of other useful code such as using galleries, tables and the various ways of using images.  
+
|'''Please follow the conventions as listed on this page when creating new pages or editing existing content on any page in The Wiki.'''
 +
 
  
Please follow the conventions as listed on this page when creating new pages or editing existing content.
+
You should refer to the '''[[Help:Notes for Editors]]''' and '''[[Formatting Text]]''' for further information about the conventions of Wiki presentation style.
 +
 
 +
Pages in '''[[:Category:Help|The Wiki Guide]]''' also give examples of other useful code such as using galleries, tables and the various ways of using images.
 +
 
 +
Any alterations to County pages should follow the '''[[Template for County Pages]]'''. Any pages with lists of links should follow the same format. This will ensure that the presentation and layout of links wll be consistent throughout The Wiki.  
  
Any alterations to County pages should follow the template which can be seen here:- [[County model|Model County Page]]. This will ensure that the presentation and layout of links wll be consistent throughout The Wiki.
 
  
 
'''Unless it is clear that the page is being actively worked on, if text or code is in the Wiki then it is considered as editable, therefore if any deviation from these conventions or any grammatical inaccuracies is spotted, it will be corrected.'''  
 
'''Unless it is clear that the page is being actively worked on, if text or code is in the Wiki then it is considered as editable, therefore if any deviation from these conventions or any grammatical inaccuracies is spotted, it will be corrected.'''  
 
|}
 
|}
 
  
 
==Page creation and editing ==
 
==Page creation and editing ==
Line 45: Line 42:
  
  
'''To avoid pages under construction being overwritten, please refer to [[Adding Content to The Wiki ~ New Pages]]'''
+
'''To avoid pages under construction being overwritten, please refer to [[New Pages]]'''
  
  
Line 79: Line 76:
 
==Hyperlinks in "The Wiki"==
 
==Hyperlinks in "The Wiki"==
  
To add a hyperlink please see: [[Help:Hyperlink Code]]
+
To add a hyperlink please see: '''[[Code for Hyperlinks|Coding a hyperlink for the Wiki]]'''
  
  
Descriptive text following a hyperlink in a list should be avoided. However, if it is absolutely necessary it is allowed provided the following conditions are met:-  
+
Descriptive text following a hyperlink in a list should be avoided.  
 +
 
 +
However, if it is absolutely necessary it is allowed provided the following conditions are met:-  
  
 
* The link plus its descriptive text will occupy no more than two lines and preferably only one.
 
* The link plus its descriptive text will occupy no more than two lines and preferably only one.
  
* The descriptive text must add value to the link: For example: "Maps of England - many English maps can be found here" is not acceptable, whereas Maps of England on its own is adequate.
+
* The descriptive text must add value to the link.
 +
 
 +
 
 +
:'''For example:'''
 +
 
 +
:'''[http://www.ordnancesurvey.co.uk/oswebsite/ Maps of England]''' - many English maps can be found here  
 +
 
 +
:'''is not acceptable, whereas'''
 +
 
 +
:'''[http://www.ordnancesurvey.co.uk/oswebsite/ Maps of England]'''
 +
 
 +
:'''on its own is adequate.'''
 +
 
  
 
* The link should reflect the content of the hyperlinked website.
 
* The link should reflect the content of the hyperlinked website.
Line 97: Line 108:
 
'''ALL LINKS SHOULD BE TESTED WHEN THEY HAVE BEEN ADDED'''
 
'''ALL LINKS SHOULD BE TESTED WHEN THEY HAVE BEEN ADDED'''
  
'''Any links not confirming to these conventions will be edited.'''  
+
'''Any links not conforming to these conventions will be edited.'''  
  
 
'''Any links and descriptive text which can be shortened without changing their meaning or impact will be edited.'''
 
'''Any links and descriptive text which can be shortened without changing their meaning or impact will be edited.'''
Line 104: Line 115:
 
==Layout and Presentation of County Pages ==
 
==Layout and Presentation of County Pages ==
  
'''See [[County model|Template for a county page]]'''
+
'''See [[Template for County Pages]]'''
  
 
The top section of each county page is constructed in a table of two rows.  
 
The top section of each county page is constructed in a table of two rows.  
Line 116: Line 127:
  
  
Please refer to the [[Help:Notes for Editors]] and [[Authoring]] for the conventions for the use of code for layout and presentation.
+
Please refer to the '''[[Help:Notes for Editors]]''' and '''[[Formatting Text]]''' for the conventions for the use of code for layout and presentation.
  
  
Line 125: Line 136:
 
'''In order to minimise problems when other sites change, any links which come from websites with national coverage, such as GENUKI, Familia or the IGI, should not be placed on the County Pages.'''  
 
'''In order to minimise problems when other sites change, any links which come from websites with national coverage, such as GENUKI, Familia or the IGI, should not be placed on the County Pages.'''  
  
'''These websites are already listed on the appropriate Country or regional pages of the Wiki.'''  
+
'''These websites are already listed on the appropriate national or regional page of The Wiki.'''  
  
 
'''If found, they will be removed.'''
 
'''If found, they will be removed.'''
 +
 +
 +
====Duplication of links====
 +
 +
The aim for the adding of hyperlinks is for zero duplication HOWEVER as it is not easy to come up with a definitive rule for the adding of hyperlinks which cover more than topic or county or country please follow this guideline:
 +
 +
 +
:As a rule of thumb:
 +
 +
:'''EITHER'''
 +
 +
:If the link to a site would only appear on a few (preferably no more than 5) county or state pages, then it can be added to the pages for the relevant counties/states, adjusting the title to fit the content.
 +
 +
:'''OR'''
 +
 +
:If a website covers more county areas or states and/or is likely to become more varied in coverage then it should be added to the appropriate national page.
  
  
Line 136: Line 163:
 
'''N.B.''' Only the following should appear in this section and in this order; all other links should go in the appropriate sections:-
 
'''N.B.''' Only the following should appear in this section and in this order; all other links should go in the appropriate sections:-
  
* County Record office
+
:* County Record office
* County Family History Society
+
:* County Family History Society
* County Library  
+
:* County Library  
* County Look-up Exchange
+
:* County Look-up Exchange
* Relevant Online Parish Clerk
+
:* Relevant Online Parish Clerk
  
  
Line 180: Line 207:
 
==Spacing for lists of links==
 
==Spacing for lists of links==
  
'''See [[County model]] as an example.'''
+
'''See [[Template for County Pages]] as an example.'''
  
  
[[image:model2.jpg]]
+
[[image:model2b.jpg]]
  
 
==Layout of addresses==
 
==Layout of addresses==
Line 191: Line 218:
  
  
==Help Pages for The Wiki==
+
==Other Help Pages==
 
 
====Adding content====
 
 
 
* [[Help:Notes for Users|Help for Users]] being rewritten
 
 
 
* [[Help:Notes for Editors|Help for Editors]] being rewritten
 
 
 
* [[Authoring|Formatting Text]]
 
 
 
* [[Style and Presentation in The Wiki]]
 
 
 
* [[Help:Hyperlink Code|Coding a Hyperlink for The Wiki]]
 
 
 
* [[Adding Content to The Wiki ~ New Pages]]
 
 
 
* [[Adding Content to The Wiki ~ Images and Tables]]
 
 
 
* [[Adding Content to The Wiki ~ Images and Tables 2]]
 
 
 
* [[Adding Content to The Wiki ~ Mixing Text and Images]]
 
 
 
 
 
====Visual Reference====
 
 
 
* [[Navigating the Wiki|Navigating The Wiki]]
 
 
 
* [[Searching the Wiki|Searching The Wiki]]
 
 
 
* [[Uploading images to The Wiki]]
 
 
 
* [[Editing Your User Page]]
 
 
 
* [[Surname Help|Adding Surnames to The Surname Directory]]
 
 
 
* [[County model|Template for County Pages]]
 
 
 
* [[Examples of useful code|Miscellaneous Code]]
 
 
 
  
*[[Main Page]]
+
[[image:minibad.jpg]] '''[[:Category:Help|The Wiki Guide]]'''

Latest revision as of 14:57, 12 February 2010

Style1.jpg

Please follow the conventions as listed on this page when creating new pages or editing existing content on any page in The Wiki.


You should refer to the Help:Notes for Editors and Formatting Text for further information about the conventions of Wiki presentation style.

Pages in The Wiki Guide also give examples of other useful code such as using galleries, tables and the various ways of using images.

Any alterations to County pages should follow the Template for County Pages. Any pages with lists of links should follow the same format. This will ensure that the presentation and layout of links wll be consistent throughout The Wiki.


Unless it is clear that the page is being actively worked on, if text or code is in the Wiki then it is considered as editable, therefore if any deviation from these conventions or any grammatical inaccuracies is spotted, it will be corrected.

Page creation and editing

General Principles

  • If you want to create a page - do it, but please try to ensure its content is valid and that it follows the layout and style of already published pages.
  • If you edit a page, use the Summary pane at the bottom of the edit box to give a brief overview of why you have edited.
  • If your content has been edited and you feel it shouldn’t have been, check the summary box first for an explanation. If there isn’t one, and the reason for the edit is not obvious by looking at the page history, you should contact the member involved and ask them.
  • If you are working on a page, you must use the "WORK IN PROGRESS" image to let others know. If this image is missing the page is classed as open for editing by all.


Building3.jpg


  • If you feel that something needs to be changed on a locked page, please contact the originator of that page.


N.B. Unless it is clear that the page is being actively worked on, if text or code is in the Wiki then it is considered as editable. Therefore if any deviations from these conventions or any grammatical inaccuracies are spotted, they will be corrected.


To avoid pages under construction being overwritten, please refer to New Pages


Writing style in "The Wiki"

  • Write formally in complete sentences or bullet points, following the standard rules of written English rather than the more chatty style of the forums.
  • Prepare your text in advance and check it for spelling and grammar before pasting it into the Wiki, otherwise it may be edited without any consultation or warning.


Please use the following conventions for punctuation:-

  • Use one or two spaces after a full stop and there should be no spaces before a full stop.
  • Use one space after a comma and there should be no spaces before a comma.
  • Capital letters (upper case) should only be used for the beginning of a sentence and proper nouns. All other text should be in lower case.


  • Section Headings should be in Title Case.


Please Note:-

Text pasted from Word loses its formatting, therefore lists such as addresses need <br> after each line.

Text which needs an extra line to separate it from the line above also needs an extra carriage return.


Rule.jpg


Hyperlinks in "The Wiki"

To add a hyperlink please see: Coding a hyperlink for the Wiki


Descriptive text following a hyperlink in a list should be avoided.

However, if it is absolutely necessary it is allowed provided the following conditions are met:-

  • The link plus its descriptive text will occupy no more than two lines and preferably only one.
  • The descriptive text must add value to the link.


For example:
Maps of England - many English maps can be found here
is not acceptable, whereas
Maps of England
on its own is adequate.


  • The link should reflect the content of the hyperlinked website.
  • It may be necessary to alter the text which shows on the page if you copy the URL from the address bar in your browser.
  • Care should be taken when copying and pasting links direct from posts in the Forums.


ALL LINKS SHOULD BE TESTED WHEN THEY HAVE BEEN ADDED

Any links not conforming to these conventions will be edited.

Any links and descriptive text which can be shortened without changing their meaning or impact will be edited.


Layout and Presentation of County Pages

See Template for County Pages

The top section of each county page is constructed in a table of two rows.

This can mean that the the line spacing will vary on each page and will depend on how much text is present.

N.B. Unless you are confident in editing the code, please do not edit this area of the page.


Model6b.jpg


Please refer to the Help:Notes for Editors and Formatting Text for the conventions for the use of code for layout and presentation.


Organising links on any county page in “The Wiki”

Please note

In order to minimise problems when other sites change, any links which come from websites with national coverage, such as GENUKI, Familia or the IGI, should not be placed on the County Pages.

These websites are already listed on the appropriate national or regional page of The Wiki.

If found, they will be removed.


Duplication of links

The aim for the adding of hyperlinks is for zero duplication HOWEVER as it is not easy to come up with a definitive rule for the adding of hyperlinks which cover more than topic or county or country please follow this guideline:


As a rule of thumb:
EITHER
If the link to a site would only appear on a few (preferably no more than 5) county or state pages, then it can be added to the pages for the relevant counties/states, adjusting the title to fit the content.
OR
If a website covers more county areas or states and/or is likely to become more varied in coverage then it should be added to the appropriate national page.


Primary Reference

In the Primary Reference section, please make sure that links are in alphabetical order. The exception to this is the county record office, which goes at the top of the list under the Primary Reference Links heading, and is formatted in bold type.

N.B. Only the following should appear in this section and in this order; all other links should go in the appropriate sections:-

  • County Record office
  • County Family History Society
  • County Library
  • County Look-up Exchange
  • Relevant Online Parish Clerk


Model5b.jpg


Countywide Interest

In the Countywide Interest section, links should be alphabetised according to keyword/topic.

N.B. Only links which cover the whole or most of the county should appear here.


Model4b.jpg


Specific Town and Village Interest

In the Specific Town and Village Interest section, links should be alphabetised according to town/village/location.


Model3b.jpg


Maps and Photographs

In the Maps and Photographs section, links to maps should be listed first. These should then be followed by links to collections of photgraphs and then by links to local photographers. Within this order, links should be listed in alphabetical order by location.


Model7b.jpg

Books of local interest

Model8.jpg


Spacing for lists of links

See Template for County Pages as an example.


Model2b.jpg

Layout of addresses

Model1.jpg


Other Help Pages

Minibad.jpg The Wiki Guide