Difference between revisions of "Template:Document"

From Wikispooks
Jump to navigation Jump to search
m (t)
(Deprecate |comment parameter)
(38 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
|object=document
 
|object=document
 
}}
 
}}
For pages in the {{NS|main}} ''about'' documents, use [[Template:Publication]].
+
For pages in the {{NS|main}} ''about'' documents, use [[Template:Publication]].<br/>
 
'''Usage:'''
 
'''Usage:'''
 
<poem>
 
<poem>
Line 11: Line 11:
 
|{{NAVY|publication_date}}= PublicationDate ''([[Property:Has publicationDate]])''
 
|{{NAVY|publication_date}}= PublicationDate ''([[Property:Has publicationDate]])''
 
|type={article, essay, paper, book review, letter, memo etc.} ''([[Property:Has documentType]])''
 
|type={article, essay, paper, book review, letter, memo etc.} ''([[Property:Has documentType]])''
|{{GREEN|authors}}= Comma separated list of authors. For pseudonyms, use single quotes. If anonymous, use ''Unknown''. ''([[Property:Has author]])''
+
|{{GREEN|authors}}= Comma separated list of authors. For pseudonyms, use single quotes. If anonymous, use ''[[Unknown]]''. ''([[Property:Has author]])''
 
|{{GREEN|subjects}}= Comma separated list of subject items. For pseudonyms, use single quotes. If anonymous, use ''Unknown''. ''([[Property:Is about]])''
 
|{{GREEN|subjects}}= Comma separated list of subject items. For pseudonyms, use single quotes. If anonymous, use ''Unknown''. ''([[Property:Is about]])''
 
|description= ''A human readable plaintext description of less than 500 characters.''([[Property:Description]])''<!--  
 
|description= ''A human readable plaintext description of less than 500 characters.''([[Property:Description]])''<!--  
 +
|{{BLUE|source_name}}=General name of the source, e.g. "[[Unwelcome Guests]]", "[[Cryptome]]", ... ''([[Property:Sourced from]])''
 +
|{{PURPLE|source_URL}}=URL of the source, if it is available online ''([[Property:Has sourceURL]])''
 
''OPTIONAL DETAILS:''
 
''OPTIONAL DETAILS:''
 
|subtitle=The subtitle, e.g. of a book -->
 
|subtitle=The subtitle, e.g. of a book -->
|{{PURPLE|source_URL}}=URL of the source, if it is available online
+
|source_details            = Extra details for the reference, e.g. "#675", "vol. 3, chapter 20", "pp.212-213"... (For ISBNs, use '|ISBN') ''([[Property:Has sourceDetails]])''
 +
|updated_date=When the document was updated {{RED|Not Yet Implemented}}
 
|{{PURPLE|iframe_URL}}=URL of page for display in an iframe.
 
|{{PURPLE|iframe_URL}}=URL of page for display in an iframe.
|{{BLUE|source_name}}=General name of the source, e.g. "[[Unwelcome Guests]]", "[[Cryptome]]", ... ''([[Property:Sourced from]])''
 
 
|{{BLUE|local}}=Address of the wikispooks copy ''([[Property:Has localCopy]])''
 
|{{BLUE|local}}=Address of the wikispooks copy ''([[Property:Has localCopy]])''
 
|{{GREEN|subjects_detail}}= note about subjects {{RED|Deprecate?}}
 
|{{GREEN|subjects_detail}}= note about subjects {{RED|Deprecate?}}
Line 24: Line 26:
 
|{{ORANGE|draft}}=Yes (Use for draft documents)
 
|{{ORANGE|draft}}=Yes (Use for draft documents)
 
|title=Document title. Usually this is implicit - only specify this if the pagename is different for some reason (such as illegal characters) {{RED|Not yet implemented?}}
 
|title=Document title. Usually this is implicit - only specify this if the pagename is different for some reason (such as illegal characters) {{RED|Not yet implemented?}}
|source_detail=Specific details, e.g. "#675", "vol. 3, chapter 20", "pp.212-213"... (Do ''not'' use this for ISBN numbers, use '|ISBN' for that)
 
 
|{{GREEN|recipients}}= For emails, letters, speeches etc. ''([[Property:Has recipient]])''
 
|{{GREEN|recipients}}= For emails, letters, speeches etc. ''([[Property:Has recipient]])''
 
|{{GREEN|constitutes}}= For topics which this document is not about, but directly constitutes (e.g. "censorship", "war propaganda") ''([[Property:Constitutes]])''
 
|{{GREEN|constitutes}}= For topics which this document is not about, but directly constitutes (e.g. "censorship", "war propaganda") ''([[Property:Constitutes]])''
 
|image= AN image for the document (Recommended, for example the cover if the document is a book)
 
|image= AN image for the document (Recommended, for example the cover if the document is a book)
 +
|image_caption=Caption for the image
 
|image_width= The default value is "250px"
 
|image_width= The default value is "250px"
|{{PURPLE|audio_URL}}=URL of an audio version, if available
 
 
<s>|AuthorDetail= Short note about the author, (e.g. "Home Office accredited forensic pathologist")</s>
 
<s>|AuthorDetail= Short note about the author, (e.g. "Home Office accredited forensic pathologist")</s>
 
|classification=Original security classification, e.g. "official", "secret", "top secret"... ''([[Property:Has classification]])''
 
|classification=Original security classification, e.g. "official", "secret", "top secret"... ''([[Property:Has classification]])''
Line 39: Line 40:
 
|author_type=Explanatory note about authorship, e.g. "alleged"
 
|author_type=Explanatory note about authorship, e.g. "alleged"
 
|version=For versioned documents
 
|version=For versioned documents
 +
|warning=Plaintext warning
 
''FOR FOREIGN TRANSLATIONS:''
 
''FOR FOREIGN TRANSLATIONS:''
 
|original_language=Language name for non-English originals ''([[Property:Has originalLanguage]])''
 
|original_language=Language name for non-English originals ''([[Property:Has originalLanguage]])''
Line 44: Line 46:
 
|{{GREEN|translators}}=Who translated it ''([[Property:Has translator]])''
 
|{{GREEN|translators}}=Who translated it ''([[Property:Has translator]])''
 
|translators_detail=Short note on the translators
 
|translators_detail=Short note on the translators
 +
''FOR AUDIO (readings):''
 +
|{{PURPLE|audio_URL}}=URL of this audio version
 +
|{{BLUE|audio_name}}=Name of the source of the audio version
 
''FOR BOOKS:''
 
''FOR BOOKS:''
 
|{{PURPLE|webpage}}=URL of this book
 
|{{PURPLE|webpage}}=URL of this book
Line 57: Line 62:
 
|wikipedia_protection      = Set to 1 if the wikipedia page is edit protected, 0 or empty otherwise ''([[Property:Has wikipediaProtection]])''
 
|wikipedia_protection      = Set to 1 if the wikipedia page is edit protected, 0 or empty otherwise ''([[Property:Has wikipediaProtection]])''
 
|authors_note= ''Author's Note'' subsection
 
|authors_note= ''Author's Note'' subsection
|comment= ''Wikispooks Comment'' subsection about why this is relevant (Recommended)
+
<s>|comment= ''Wikispooks Comment'' subsection about why this is relevant (Recommended)</s> ''Depreceated, please use [[Template:Rating]] about the document on your user page instead''<ref>Ask an administrator if you need help with this.</ref>
 
<s>|see_also= ''See Also'' subsection (Use for related pages which cannot be linked in from the text)</s> ''Deprecated, but still available in emergencies''
 
<s>|see_also= ''See Also'' subsection (Use for related pages which cannot be linked in from the text)</s> ''Deprecated, but still available in emergencies''
 
}}
 
}}
 
</poem>
 
</poem>
</noinclude><includeonly>{{DISPLAYTITLE:''{{FULLPAGENAME}}''}}{{SMWObjectHeader|Document}}<div style="border-style:solid; border-width:1px; border-color:#a7d7f9; margin:0px; background-color:#f5f5f5; padding: 1.0em; margin-right:0px;">{{WikiSpooks:Site Status}}[[Has objectClass::Document| ]][[Has objectClass2::Document| ]]{{#if: {{{Badge|}}} | <div style="float:right;"> {{ {{{Badge}}} }} </div> }}{{#if: {{{image|}}} |[[Has image::File:{{{image|}}}| ]][[Has image2::File:{{{image|}}}| ]] <div style="float:right; margin:0 0 0 12px"> [[File:{{{image|}}}|{{#if: {{{image_width|}}}|{{{image_width|}}}|250px}}]] </div>}}{{Description|{{{description|}}}}}
+
</noinclude><includeonly>{{DISPLAYTITLE:''{{FULLPAGENAME}}''}}{{SMWObjectHeader|Document}}<div style="border-style:solid; border-width:1px; border-color:#a7d7f9; margin:0px; background-color:#f5f5f5; padding: 1.0em; margin-right:0px;">{{Wikispooks:Site Status}}[[Has objectClass::Document| ]][[Has objectClass2::Document| ]]{{#if: {{{Badge|}}} | <div style="float:right;"> {{ {{{Badge}}} }} </div> }}{{#if: {{{image|}}} |[[Has image::File:{{{image|}}}| ]][[Has image2::File:{{{image|}}}| ]] <div style="float:right; margin:0 0 0 12px"> [[File:{{{image|}}}|{{#if: {{{image_width|}}}|{{{image_width|}}}|250px}}]] {{#if: {{{image_caption|}}} |<br/>{{{image_caption|}}}}}</div>}}{{Description|{{{description|}}}}}
{{#ifeq: {{{NAMESPACE}}}|Document|{{DocEditMsg}}|}} {{Infobox class icon}}'''<big>&nbsp;{{#ifeq: {{{collection|}}}|Yes|a|{{AORAN|{{{type|}}}}}}}&nbsp;{{DisplayDocType|{{{type|}}}|{{{draft|}}}|{{{collection|}}}}}{{#if: {{{authors|}}} | &nbsp; by {{ArrayMapPropertyListLink|{{{authors|}}}|Has author}}{{#if: {{{author_type|}}} | &nbsp;({{{author_type}}})|}}|&nbsp;of unknown authorship [[Category:Authorless documents]]}}{{#if: {{{recipients|}}}| &nbsp; to {{#arraymap:{{{recipients|}}}|,|@@@@|[[Has recipient::@@@@]]}}}} {{#if: {{{PublisherName|}}}|{{#if: {{{publication_date|}}} | published [[Has publicationDate::{{{publication_date|}}}]]}} {{#if: {{{PublisherName|}}} | by {{Agent|Has publisher|{{{publisher_name|}}}|{{#if: {{{publisher_URL|}}}| <nowiki>[</nowiki>[{{{publisher_URL}}} Link]<nowiki>]</nowiki>}} {{{publisher_detail|}}} }} |}}|{{#if: {{{publication_date|}}} |dated [[Has publicationDate::{{{publication_date|}}}]]}}}}</big>'''<hr/>{{#if: {{{ISBN|}}}|''':''' {{ArrayMapPropertyListLink|{{{ISBN|}}}Has ISBN|}} <br/>}}{{#if: {{{wikipedia|}}} | <br/>'''Wikipedia: '''{{WikipediaLink|{{{wikipedia|}}}|{{{wikipedia_protection|}}}}}<br/>}}{{#if: {{{subjects|}}}|'''Subjects:''' {{#arraymap:{{{subjects|}}}|,|@@@@|[[Is about::@@@@]]}} {{{Subjects_detail|}}}<br/>|[[Category:Subjectless Documents]]}}{{#if: {{{constitutes|}}} | '''Example of:''' {{#arraymap: {{{constitutes|}}}|,|@@@@|[[Constitutes::@@@@]]}}<br/>}} {{DisplayClassification|{{{classification|}}}|{{{classification_detail|}}}|{{{Leaked|}}}|{{{declassified|}}}|{{{declassified_date|}}}|{{{declassified_detail|}}}}}{{#if: {{{source_name|}}}{{{source_URL|}}{{{source_detail|}}}|'''Source:'''&nbsp;{{DisplaySource|{{{source_URL|}}}|{{{source_name|}}}|{{{source_detail|}}}}}<br/>}}{{#if: {{{audio_URL|}}} | '''Audio version:''' [{{{audio_URL|}}} Here]<br/>|}}{{#ifexist: {{{local|}}} | [[Has localCopy::{{{local}}}]] | {{#if:{{#pos:{{{local|}}}|http}} | [{{{local}}} Here] | {{RED|Broken Link: [[{{{local}}}]] }} }} }}<br/>|}}{{DocDisclaimer}}{{#if: {{{original_language|}}} | {{#ifeq: {{{original_language|}}} | English |[[Has originalLanguage::English| ]]| <br/>Translated from [[Has originalLanguage::{{{original_language|}}}]] {{#if: {{{translators|}}} | by {{ArrayMapPropertyListLink|{{{translators|}}}Has translator|}} {{{translators_detail|}}} |}}}}|}}{{#if: {{{original_title|}}} |&nbsp;- Original title: ''[[Has originalTitle::{{{original_title|}}}]]'' |}}{{#if: {{{Credit|}}} | <br/>'''Credit: '''{{{credit}}}}}{{#if: {{{version|}}}|'''Version:''' {{{version}}}<br/>}}{{#if: {{{note|}}} |<br/>{{{note}}} }}{{#if: {{{comment|}}} | <br/><br/><big><big>Wikispooks Comment</big></big>
+
{{DocDisclaimer}}{{#ifeq: {{{NAMESPACE}}}|Document|{{DocEditMsg}}|}}{{Infobox class icon}}'''<big>&nbsp;<!--
 +
Comment this out until we get it working...
 +
{{AORAN|{{DisplayDocType|{{{type|}}}|{{{draft|}}}|{{{collection|}}}}}}}&nbsp;-->{{DisplayDocType|{{{type|}}}|{{{draft|}}}|{{{collection|}}}}}{{#if: {{{authors|}}} | &nbsp; by {{ArrayMapPropertyListLink|{{{authors|}}}|Has author}}{{#if: {{{author_type|}}} | &nbsp;({{{author_type}}})|}}|&nbsp;of unknown authorship [[Category:Authorless documents]]}}{{#if: {{{recipients|}}}| &nbsp; to {{#arraymap:{{{recipients|}}}|,|@@@@|[[Has recipient::@@@@]]}}}} {{#if: {{{PublisherName|}}}|{{#if: {{{publication_date|}}} | published {{LinkYear|[[Has publicationDate::{{{publication_date|}}}]]}}}} {{#if: {{{PublisherName|}}} | by {{Agent|Has publisher|{{{publisher_name|}}}|{{#if: {{{publisher_URL|}}}| <nowiki>[</nowiki>[{{{publisher_URL}}} Link]<nowiki>]</nowiki>}} {{{publisher_detail|}}} }} |}}|{{#if: {{{publication_date|}}} |dated [[Has publicationDate::{{{publication_date|}}}]]}}}}</big>'''<hr/>{{#if: {{{ISBN|}}}|'''ISBN:''' {{ArrayMapPropertyListLink|{{{ISBN|}}}|Has ISBN}} <br/>}}{{#if: {{{wikipedia|}}} | <br/>'''Wikipedia: '''{{WikipediaLink|{{{wikipedia|}}}|{{{wikipedia_protection|}}}}}<br/>}}{{#if: {{{subjects|}}}|'''Subjects:''' {{#arraymap:{{{subjects|}}}|,|@@@@|[[Is about::@@@@]]}} {{{Subjects_detail|}}}<br/>|[[Category:Subjectless Documents]]}}{{#if: {{{constitutes|}}} | '''Example of:''' {{#arraymap: {{{constitutes|}}}|,|@@@@|[[Constitutes::@@@@]]}}<br/>}} {{DisplayClassification|{{{classification|}}}|{{{classification_detail|}}}|{{{Leaked|}}}|{{{declassified|}}}|{{{declassified_date|}}}|{{{declassified_detail|}}}}}{{#if: {{{source_name|}}}{{{source_URL|}}{{{source_detail|}}}|'''Source:'''&nbsp;{{DisplaySource|{{{source_URL|}}}|{{{source_name|}}}|{{{source_detail|}}}}}<br/>}}{{#if: {{{local|}}} | '''Local copy:''' {{#ifexist: {{{local|}}} | [[Has localCopy::{{{local}}}]] | {{#if:{{#pos:{{{local|}}}|http}} | [{{{local}}} Here] | {{RED|Broken Link: [[{{{local}}}]] }} }} }}<br/>|}}{{#if: {{{audio_URL|}}} | '''Audio version:''' [{{{audio_URL}}} Here] {{#if: {{{audio_name|}}}|from [[{{{audio_name}}}]]}}<br/>|}}{{#if: {{{original_language|}}} | {{#ifeq: {{{original_language|}}} | English |[[Has originalLanguage::English| ]]| <br/>Translated from [[Has originalLanguage::{{{original_language|}}}]] {{#if: {{{translators|}}} | by {{ArrayMapPropertyListLink|{{{translators|}}}|Has translator|}} {{{translators_detail|}}} |}}}}|}}{{#if: {{{original_title|}}} |&nbsp;- Original title: ''[[Has originalTitle::{{{original_title|}}}]]'' |}}{{#if: {{{Credit|}}} | <br/>'''Credit: '''{{{credit}}}}}{{#if: {{{version|}}}|'''Version:''' {{{version}}}<br/>}}{{#if: {{{warning|}}}|'''Warning:''' {{{warning}}}<br/>}}{{#if: {{{note|}}} |<br/>{{{note}}} }}{{#if: {{{comment|}}} | <br/><br/><big><big>Wikispooks Comment</big></big>
 +
----
 +
{{{comment}}}|}}{{#if: {{{authors_note|}}} |<br/><br/><big><big>Author{{#if: {{{Author2|}}}|s'|'s}} Note</big></big>
 
----
 
----
{{{comment}}} |}}{{DisplayRatings}}{{#if: {{{authors_note|}}} | <br/><br/><big><big>Author{{#if: {{{Author2|}}}|s'|'s}} Note</big></big>
+
{{{authors_note|}}} |}}{{DisplayRatings}}{{#if: {{{permission|}}} |<br>
 
----
 
----
{{{authors_note}}} |}}{{#if: {{{see_also|}}} | <br/><br/><big><big>See Also</big></big>
+
'' © {{{publication_date|}}} {{ArrayMapListLink|{{{authors|}}}}}. Republished with permission. All rights reserved. You may not republish this without explicit permission from {{{authors|}}}.''}}{{#if: {{{see_also|}}} | <br/><big><big>See Also</big></big>
 
----
 
----
 
{{{see_also}}} |}}</div>
 
{{{see_also}}} |}}</div>
{{#ifexist: Document_talk:{{PAGENAME}} | [[Document_talk:{{PAGENAME}} | ★ Join the Discussion about this document]] | [[Document_talk:{{PAGENAME}} | ★ Start a Discussion about this document]]}} {{#if: {{{title|}}} | <br/><br/><big><big>{{{title}}}</big></big> |}}
+
{{#ifexist: Document_talk:{{PAGENAME}} | [[Document_talk:{{PAGENAME}} | ★ Join the Discussion about this document]] | [[Document_talk:{{PAGENAME}} | ★ Start a Discussion about this document]]}} {{#if: {{{title|}}} | <br/><big><big>{{{title}}}</big></big> |}}
 
----
 
----
 
{{#if: {{{iframe_URL|}}} |[[Category:IframeDoc]]<br/>{{#widget:Iframe |url={{{iframe_URL}}} |width=900 |height=800 |border=0}} }}
 
{{#if: {{{iframe_URL|}}} |[[Category:IframeDoc]]<br/>{{#widget:Iframe |url={{{iframe_URL}}} |width=900 |height=800 |border=0}} }}
 
{{#ifeq: {{{Leaked|}}} | Yes | [[Category:Leaked Documents]] |}} {{#if: {{{DateYear|}}} | {{DateCategory|publication_date={{{DateYear|}}}}} | {{DateCategory|publication_date={{#time: Y | {{{Date|}}} }} }} }}{{#ifeq: {{{Leaked|}}} | Yes | [[Category:Leaked Documents]] |}}
 
{{#ifeq: {{{Leaked|}}} | Yes | [[Category:Leaked Documents]] |}} {{#if: {{{DateYear|}}} | {{DateCategory|publication_date={{{DateYear|}}}}} | {{DateCategory|publication_date={{#time: Y | {{{Date|}}} }} }} }}{{#ifeq: {{{Leaked|}}} | Yes | [[Category:Leaked Documents]] |}}
 
{{SMWDefaultMarkup}}</includeonly>
 
{{SMWDefaultMarkup}}</includeonly>

Revision as of 11:09, 31 March 2020

SMWObjects
Semantic Object Templates:        DecadePlaceTimelineYearDisambiguation
ConceptDocumentEmploymentEventGroupPersonPublicationWebsite

This template provides a standard format for documents.

It must be included at the top of all pages in the document: namespace.

Blue parameters are for a single Wikispooks page name (If no suitable page exists, then pick a title for a future page)
Brown parameters are for numbers
Green parameters are for comma-separated lists of page names (Or planned page names).
Navy parameters are for dates
Orange parameters are for booleans. (Usually, either "Yes" or just leave blank).
Purple parameters are URLs.
Violet parameters are slash-separated lists.
Pink parameters are for coordinates.
Crossed out parameters were formerly available, but have been upgraded. Some may still work, but do not use these.

See document for a list of pages that use this template.

For pages in the main: namespace about documents, use Template:Publication.
Usage:

{{Document
ESSENTIAL DETAILS
|publication_date= PublicationDate (Property:Has publicationDate)
|type={article, essay, paper, book review, letter, memo etc.} (Property:Has documentType)
|authors= Comma separated list of authors. For pseudonyms, use single quotes. If anonymous, use Unknown. (Property:Has author)
|subjects= Comma separated list of subject items. For pseudonyms, use single quotes. If anonymous, use Unknown. (Property:Is about)
|description= A human readable plaintext description of less than 500 characters.(Property:Description)
|source_details = Extra details for the reference, e.g. "#675", "vol. 3, chapter 20", "pp.212-213"... (For ISBNs, use '|ISBN') (Property:Has sourceDetails)
|updated_date=When the document was updated Not Yet Implemented
|iframe_URL=URL of page for display in an iframe.
|local=Address of the wikispooks copy (Property:Has localCopy)
|subjects_detail= note about subjects Deprecate?
|collection=Yes (Use if this is a collection of documents)
|draft=Yes (Use for draft documents)
|title=Document title. Usually this is implicit - only specify this if the pagename is different for some reason (such as illegal characters) Not yet implemented?
|recipients= For emails, letters, speeches etc. (Property:Has recipient)
|constitutes= For topics which this document is not about, but directly constitutes (e.g. "censorship", "war propaganda") (Property:Constitutes)
|image= AN image for the document (Recommended, for example the cover if the document is a book)
|image_caption=Caption for the image
|image_width= The default value is "250px"
|AuthorDetail= Short note about the author, (e.g. "Home Office accredited forensic pathologist")
|classification=Original security classification, e.g. "official", "secret", "top secret"... (Property:Has classification)
|classification_detail= Optional note about the security classification
|leaked=Yes (Use for leaked documents)
|declassified=Yes (Use for declassified documents)
|declassified_date=When the document was declassified
|declassified_detail= Optional Note about the declassification
|author_type=Explanatory note about authorship, e.g. "alleged"
|version=For versioned documents
|warning=Plaintext warning
FOR FOREIGN TRANSLATIONS:
|original_language=Language name for non-English originals (Property:Has originalLanguage)
|original_title=The title of the original document (Property:Has originalTitle)
|translators=Who translated it (Property:Has translator)
|translators_detail=Short note on the translators
FOR AUDIO (readings):
|audio_URL=URL of this audio version
|audio_name=Name of the source of the audio version
FOR BOOKS:
|webpage=URL of this book
|ISBN= ISBN number (Property:Has ISBN)
|publisher_URL=Web address of the publishers
|publisher_name=Name of the publishers
|publisher_detail=Optional extra note about the publishers
OPTIONAL NOTES:
|note= Random spare note
|credit= Note of thanks
OPTIONAL SUBSECTIONS:
|wikipedia = URL of the document's Wikipedia page, if any (Property:Has wikipediaPage)
|wikipedia_protection = Set to 1 if the wikipedia page is edit protected, 0 or empty otherwise (Property:Has wikipediaProtection)
|authors_note= Author's Note subsection
|comment= Wikispooks Comment subsection about why this is relevant (Recommended) Depreceated, please use Template:Rating about the document on your user page instead[1]
|see_also= See Also subsection (Use for related pages which cannot be linked in from the text) Deprecated, but still available in emergencies
}}

  1. Ask an administrator if you need help with this.