Difference between revisions of "Style and Presentation"
(38 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | [[image: | + | __NOEDITSECTION__ |
+ | [[Category:Help]] | ||
+ | [[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__ | ||
− | |||
− | The | + | |'''Please follow the conventions as listed on this page when creating new pages or editing existing content on any page in The Wiki.''' |
− | |||
− | Any alterations to County pages should follow the | + | 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. | ||
+ | |||
'''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 28: | Line 31: | ||
* 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. | * 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. | ||
+ | |||
+ | |||
+ | [[image:building3.jpg]] | ||
+ | |||
* If you feel that something needs to be changed on a locked page, please contact the originator of that page. | * 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. | + | |
+ | '''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 [[ | + | '''To avoid pages under construction being overwritten, please refer to [[New Pages]]''' |
Line 68: | Line 76: | ||
==Hyperlinks in "The Wiki"== | ==Hyperlinks in "The Wiki"== | ||
− | To add a hyperlink please see: [[ | + | 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:- | |
* 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: | + | * 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 86: | 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 | + | '''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 93: | Line 115: | ||
==Layout and Presentation of County Pages == | ==Layout and Presentation of County Pages == | ||
− | '''See [[ | + | '''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. | |
Line 101: | Line 127: | ||
− | Please refer to the [[Help | + | 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”== | ==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''' ==== | ===='''Primary Reference''' ==== | ||
− | In the '''Primary Reference''' section, | + | 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 | + | '''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 |
− | [[image: | + | [[image:model5b.jpg]] |
===='''Countywide Interest'''==== | ===='''Countywide Interest'''==== | ||
− | In the '''Countywide Interest''' section, | + | 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. | + | '''N.B.''' Only links which cover the whole or most of the county should appear here. |
− | [[image: | + | [[image:model4b.jpg]] |
===='''Specific Town and Village Interest'''==== | ===='''Specific Town and Village Interest'''==== | ||
− | In the '''Specific Town and Village Interest''' section, | + | In the '''Specific Town and Village Interest''' section, links should be alphabetised according to town/village/location. |
− | [[image: | + | [[image:model3b.jpg]] |
===='''Maps and Photographs'''==== | ===='''Maps and Photographs'''==== | ||
− | In the '''Maps and Photographs''' section, | + | 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. |
− | |||
+ | [[image:model7b.jpg]] | ||
====Books of local interest==== | ====Books of local interest==== | ||
− | |||
+ | [[image:model8.jpg]] | ||
− | |||
==Spacing for lists of links== | ==Spacing for lists of links== | ||
− | See [[County | + | '''See [[Template for County Pages]] as an example.''' |
− | [[image: | + | [[image:model2b.jpg]] |
− | |||
==Layout of addresses== | ==Layout of addresses== | ||
Line 167: | Line 216: | ||
[[image:model1.jpg]] | [[image:model1.jpg]] | ||
+ | |||
+ | |||
+ | ==Other Help Pages== | ||
+ | |||
+ | [[image:minibad.jpg]] '''[[:Category:Help|The Wiki Guide]]''' |
Latest revision as of 14:57, 12 February 2010
Please follow the conventions as listed on this page when creating new pages or editing existing content on any page in The Wiki.
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.
|
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.
- 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.
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
- 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
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.
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
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.
Specific Town and Village Interest
In the Specific Town and Village Interest section, links should be alphabetised according to town/village/location.
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.
Books of local interest
Spacing for lists of links
See Template for County Pages as an example.
Layout of addresses