Difference between revisions of "Template:Document"
(Clarify params and publication object) |
m (add source_URL) |
||
(53 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
− | <noinclude> | + | <noinclude>{{WStemplate |
− | {{WStemplate | ||
|summary=This template provides a standard format for documents. | |summary=This template provides a standard format for documents. | ||
|description=It ''must'' be included at the top of all pages in the {{NS|document}}. | |description=It ''must'' be included at the top of all pages in the {{NS|document}}. | ||
|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 12: | 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|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]])''<!-- | ||
|{{BLUE|source_name}}=General name of the source, e.g. "[[Unwelcome Guests]]", "[[Cryptome]]", ... ''([[Property:Sourced from]])'' | |{{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 --> | ||
− | |{{GREEN|subjects_detail}}= note about subjects | + | |source_details = Extra details for the reference, e.g. "#675", "vol. 3, chapter 20", "pp.212-213"... (For ISBNs, use '|ISBN') ''([[Property:Has sourceDetails]])'' |
− | |collection=Yes (Use if this is a collection of documents) | + | |updated_date=When the document was updated {{RED|Not Yet Implemented}} |
− | |draft=Yes (Use for draft documents) | + | |{{PURPLE|iframe_URL}}=URL of page for display in an iframe. |
− | + | |{{PURPLE|source_URL}}=Link to the source of the document | |
− | | | + | |{{BLUE|local}}=Address of the wikispooks copy ''([[Property:Has localCopy]])'' |
+ | |{{GREEN|subjects_detail}}= note about subjects {{RED|Deprecate?}} | ||
+ | |{{ORANGE|collection}}=Yes (Use if this is a collection of 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?}} | ||
|{{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" | ||
<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]])'' | ||
|classification_detail= Optional note about the security classification | |classification_detail= Optional note about the security classification | ||
− | |leaked=Yes (Use for leaked documents) | + | |{{ORANGE|leaked}}=Yes (Use for leaked documents) |
− | |declassified=Yes (Use for declassified documents) | + | |{{ORANGE|declassified}}=Yes (Use for declassified documents) |
|declassified_date=When the document was declassified | |declassified_date=When the document was declassified | ||
|declassified_detail= Optional Note about the declassification | |declassified_detail= Optional Note about the declassification | ||
|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]])'' | ||
|original_title=The title of the original document ''([[Property:Has originalTitle]])'' | |original_title=The title of the original document ''([[Property:Has originalTitle]])'' | ||
|{{GREEN|translators}}=Who translated it ''([[Property:Has translator]])'' | |{{GREEN|translators}}=Who translated it ''([[Property:Has translator]])'' | ||
− | |translators_detail=Short note on the | + | |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 | ||
|ISBN= ISBN number ''([[Property:Has ISBN]])'' | |ISBN= ISBN number ''([[Property:Has ISBN]])'' | ||
− | |||
− | |||
|{{PURPLE|publisher_URL}}=Web address of the publishers | |{{PURPLE|publisher_URL}}=Web address of the publishers | ||
|{{BLUE|publisher_name}}=Name of the publishers | |{{BLUE|publisher_name}}=Name of the publishers | ||
Line 59: | Line 63: | ||
|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:Rate]] 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>{{SMWObjectHeader|Document}}<div style="border-style:solid; border-width:1px; border-color:#a7d7f9; margin:0px; background-color:#f5f5f5; padding: 1.0em; margin-right:0px;">{{ | + | </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|}}}}} |
− | {{ | + | {{DocDisclaimer}}{{#ifeq: {{{NAMESPACE}}}|Document|{{DocEditMsg}}|}}{{Infobox class icon}}'''<big> <!-- |
+ | Comment this out until we get it working... | ||
+ | {{AORAN|{{DisplayDocType|{{{type|}}}|{{{draft|}}}|{{{collection|}}}}}}} -->{{DisplayDocType|{{{type|}}}|{{{draft|}}}|{{{collection|}}}}}{{#if: {{{authors|}}} | by {{ArrayMapPropertyListLink|{{{authors|}}}|Has author}}{{#if: {{{author_type|}}} | ({{{author_type}}})|}}| of unknown authorship [[Category:Authorless documents]]}}{{#if: {{{recipients|}}}| 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:''' {{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|}}} | - 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> | ||
---- | ---- | ||
− | {{{ | + | {{{authors_note|}}} |}}{{DisplayRatings}}{{#if: {{{permission|}}} |<br> |
---- | ---- | ||
− | {{{ | + | '' © {{{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: {{{ | + | {{#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]] |}} {{#if: {{{DateYear|}}} | {{DateCategory|publication_date={{{DateYear|}}}}} | {{DateCategory|publication_date={{#time: Y | {{{Date|}}} }} }} }}{{#ifeq: {{{Leaked|}}} | Yes | [[Category:Leaked Documents]] |}} |
{{SMWDefaultMarkup}}</includeonly> | {{SMWDefaultMarkup}}</includeonly> |
Latest revision as of 13:28, 4 July 2023
Concept • Document • Employment • Event • Group • Person • Publication • Website |
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 parameterswere 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.
|source_URL=Link to the source of the document
|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:Rate 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
}}
- ↑ Ask an administrator if you need help with this.