Difference between revisions of "Editing"

From Critiques Of Libertarianism
Jump to: navigation, search
(Quotations)
(Quotations)
 
Line 3: Line 3:
 
This page should explain the editing conventions that keep the site functional and the look-and-feel uniform.
 
This page should explain the editing conventions that keep the site functional and the look-and-feel uniform.
 
==Indexes==
 
==Indexes==
A major objective is creating indexes by using DPL to display links to and descriptions of pages that are in some category.  This is done with [[Template:List Category]].  It creates a definition list with the page title as the term to be defined, and the definition information is fetched with the metadata template [[Template:DES]].  The defined term is linked to the wiki page or (if the page has a metadata template [[Template:URL]]) to an external page.  This indexing system deliberately does no transclusion with DPL: all the information extracted comes from the page title and the metadata templates.
+
A major objective is creating indexes by using DPL to display links to and descriptions of pages that are in some category.  This is done with [[Template:List]].  It creates a definition list with the page title as the term to be defined, and the definition information is fetched with the metadata template [[Template:DES]].  The defined term is linked to the wiki page or (if the page has a metadata template [[Template:URL]]) to an external page.  This indexing system deliberately does no transclusion with DPL: all the information extracted comes from the page title and the metadata templates.
  
Pages indexing categories that resemble Category pages are easily constructed using [[Template:List Category]] like this:
+
Pages indexing categories that resemble Category pages are easily constructed using [[Template:List]] like this:
  
 
<code>
 
<code>
 
<nowiki>
 
<nowiki>
{{List | Some Category Name}}
+
{{List | Some Category Name}} <!-- if the argument is omitted, PAGENAME is used.
 
</nowiki>
 
</nowiki>
 
</code>
 
</code>
Line 15: Line 15:
 
Here is an example wiki page that could be listed by the above:  
 
Here is an example wiki page that could be listed by the above:  
  
<code>
+
<pre>
 
<nowiki>
 
<nowiki>
 
<noinclude>[[Category:Some Category Name]][[Category:Another]]{{DES | des = Short description to be transcluded.}}</noinclude>
 
<noinclude>[[Category:Some Category Name]][[Category:Another]]{{DES | des = Short description to be transcluded.}}</noinclude>
 
{{URL | url = the URL of the resource}}
 
{{URL | url = the URL of the resource}}
 +
{{Other URL | url = another URL of the resource}} <!-- never a reason to throw away such information -->
 +
{{Old URL | url = a formerly working URL of the resource}}  <!-- never a reason to throw away such information -->
 
Text on the page.
 
Text on the page.
 
</nowiki>
 
</nowiki>
</code>
+
</pre>
  
 
The above example is in the two categories explicitly listed, and [[Category:Description]] from the transcluded [[Template:DES]].  The presence of the [[Template:URL]] makes this [[Template:List]] display this title with an external link and a [more...] link to the wiki page.  If the [[Template:URL]] is not there, the title is linked to the wiki page only.  The <nowiki><noinclude></nowiki> is not necessary unless this page is going to be transcluded elsewhere (since [[Template:List]] does not transclude.)
 
The above example is in the two categories explicitly listed, and [[Category:Description]] from the transcluded [[Template:DES]].  The presence of the [[Template:URL]] makes this [[Template:List]] display this title with an external link and a [more...] link to the wiki page.  If the [[Template:URL]] is not there, the title is linked to the wiki page only.  The <nowiki><noinclude></nowiki> is not necessary unless this page is going to be transcluded elsewhere (since [[Template:List]] does not transclude.)
Line 32: Line 34:
 
</nowiki>
 
</nowiki>
 
</code>
 
</code>
 +
 
==Quotations==
 
==Quotations==
A major objective is to make lists of quotations from authors, books and other sources and index them by author, subject, and book.  Quotations should be available in lists or singly (and also in a footnoted format.)  
+
A major objective is to make lists of quotations from authors, books and other sources and categorize them by author, index (subject), and book (or other publication.) Quotations are available in lists (with [[Template:Quotes]] or singly (with [[Template:QuoteText]] and [[Template:QuoteCite]].)  
  
Each quotation should be hidden as a subpage of an author, book or other source.  The subpage would not normally be viewed by readers.  One category, [[:Category:Quotations]], is automatically inserted from the parent page, and the others should be manually inserted.  If there is a choice between the subpage of a source versus the subpage of a person, choose the former.  As many subject categories as wanted can be added.
+
Each quotation should be hidden as a subpage of an author, book or other source.  The subpage would not normally be viewed by readers.  Instead, quotations are normally read either as collections in a category (with [[Template:Quotes]]) or inserted in text (with other templates.)  [[Template:Quote]] automatically places quotes in two categories: [[:Category:Quotations]] and a category for the base page.  Other categories should be manually inserted.  If there is a choice between the subpage of a source versus the subpage of a person, choose the former.  As many subject categories as wanted can be added.
  
Quotations have a text and a citation which are set with a metadata template.  DPL will be used to extract this information.
+
Quotations have a text and a citation which are set with a metadata template.  DPL is used to extract this information.  Quotation pages should never be transcluded because that would also transclude the [[Template:Quote]] and its categorizations.
  
To add a quote, Use [[Template:Quote]] to add a quote:
+
To add a quote, use [[Template:Quote]]:
  
 
<code>
 
<code>
 
<nowiki>
 
<nowiki>
{{Quote | text = somebody said something | cite = whoever said it}}.
+
{{Quote | text = something somebody said | cite = whoever said it}}.
 
</nowiki>
 
</nowiki>
 
</code>
 
</code>
  
Use [[Template:Quote]] to display quotes in a category:
+
When adding a quote, it is good to:
 +
* add categories for the author(s), publication, and desired indexes
 +
* add links for the above in the citation
 +
* add links in the text as needed
 +
* add <nowiki>{{Quotes}}</nowiki> to the pages for the author(s), publication, and desired indexes
 +
* add redirects for the categories for the author(s), publication, and desired indexes to the pages
 +
 
 +
Use [[Template:Quotes]] to display quotes in a category:
  
 
<code>
 
<code>
 
<nowiki>
 
<nowiki>
{{Quotes | some category}}. <!-- argument is optional, if omitted, all quotations found -->
+
{{Quotes | some category}}. <!-- argument is optional, if omitted, PAGENAME is used for the category -->
 
</nowiki>
 
</nowiki>
 
</code>
 
</code>
  
Use [[Template:Quotations]] to make a section that displays quotes in a category:
+
To insert a quote on a page, use [[Template:QuoteText]] for the text and [[Template:QuoteCite]] for the citation.  While this isn't the most convenient way, it is the most flexible, since you can put it in quotes, use <nowiki><blockquote></nowiki>, put the citation in a reference, etc.
 +
 
 +
For example:
  
 
<code>
 
<code>
 
<nowiki>
 
<nowiki>
{{Quotations | section title}}. <!-- argument is optional, if omitted, title is "Quotations" -->
+
Somebody said "{{QuoteText | some quotation}}"<ref>{{QuoteCite | some quotation}}</ref> somewhere.
 
</nowiki>
 
</nowiki>
 
</code>
 
</code>

Latest revision as of 12:56, 8 November 2010