Edit Guide: Difference between revisions

From howdoi
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
[https://docs.google.com/spreadsheets/d/1dh7Myh6vxGqvw0BchbLgyjTPJ1lEUBH-E429ARk6xGk/edit#gid=0 Our Google spreadsheet] for organizing content for this wiki.
[https://docs.google.com/spreadsheets/d/1dh7Myh6vxGqvw0BchbLgyjTPJ1lEUBH-E429ARk6xGk/edit#gid=0 Our Google spreadsheet] for organizing content for this wiki.


==General style guide==
== Top of article - abox info template ==
; [[Template:abox|<nowiki>{{abox}}</nowiki>]]
: Goes at the TOP of every article to indicate authorship, currency, audience, etc. <br>Click the link to get the full text, copy / paste to your article, then fill it out.
Β 
==Article content==
* each page answers a single question -- e.g. how do I find a list of Riverdale Google Calendars
* each page answers a single question -- e.g. how do I find a list of Riverdale Google Calendars
** it is not a catch-all for everything about a subject -- other question means another page
** it is not a catch-all for everything about a subject -- other question means another page
*** except for our Get help from Google page, which is a catch-all Β 
*** except for our Get help from Google page, which is a catch-all Β 
* each page starts with an <nowiki>{{abox}} and ends with a {{CategoryTemplate}}</nowiki>
* each page starts with an <nowiki>{{abox}} and ends with a {{CategoryTemplate}}</nowiki>
* inline images (for instructions) are now added in a very particular way, with a variation of this code:
* inline images (for instructions) are now added in a very particular way, with a variation of this code:<br>
:<nowiki>#[[File:Interesting cal.png|thumbnail]]Select '''"interesting calendars"''' from the drop-down menu<br clear="all"></nowiki><br>which gives you this, including the open space below the instruction:
::<nowiki>[[File:Interesting cal.png|thumbnail]]Here's a picture of what you should do<br clear="all"></nowiki>
#[[File:Interesting cal.png|thumbnail]]Select '''"interesting calendars"''' from the drop-down menu<br clear="all">
:which gives you this, including the open space before the next instruction:<br>
::[[File:Interesting cal.png|thumbnail]]Here's a picture of what you should do<br clear="all">
:plus you can alter the size of the images by adding "|100px" (or another size) as follows:
::<nowiki>[[File:Interesting cal.png|thumbnail|100px]]</nowiki>
:to get this:
::[[File:Interesting cal.png|thumbnail|100px]]Here's a tiny image. It's cheaper that way.<br clear="all">


See [https://howdoi.riverdale.edu/wiki/Add_a_Riverdale_calendar_(of_any_type_--_event,_room,_or_resource)_to_my_own_calendar/edit this example] for a guide to our style.
See [https://howdoi.riverdale.edu/wiki/Add_a_Riverdale_calendar_(of_any_type_--_event,_room,_or_resource)_to_my_own_calendar/edit this example/edit] for source code examples.


== Article Templates ==
== Bottom of article - category templates ==
; [[Template:abox|<nowiki>{{abox}}</nowiki>]]
ONE of these should be placed at the very bottom of an article. Choose its main category.
: used on every Article to indicate authorship, currency, audience, etc.
*Don't list a secondary/specific category unless it's critical to show two sets of "other articles in this category" links.
== Category Templates ==
*Do list a secondary/specific category for the subsets under the main categories below.
Just ONE of these should be placed at the very bottom of an Article:
; [[Template:Calendaring|<nowiki>{{Calendaring}}</nowiki>]]
; [[Template:Calendaring|<nowiki>{{Calendaring}}</nowiki>]]
: Adds Article to [[:Category:Calendars and Scheduling]], and inserts a list of other Articles in that Category.
: Adds Article to [[:Category:Calendars and Scheduling]], and inserts a list of other Articles in that Category.
Line 23: Line 31:
; [[Template:ClassTech|<nowiki>{{ClassTech}}</nowiki>]]
; [[Template:ClassTech|<nowiki>{{ClassTech}}</nowiki>]]
: Adds Article to [[:Category:Classroom technology and systems]], and inserts a list of other Articles in that Category.
: Adds Article to [[:Category:Classroom technology and systems]], and inserts a list of other Articles in that Category.
:; [[Template:Chromebooks|<nowiki>{{Chromebooks}}</nowiki>]] (level 2, specific category)
:: Adds Article to [[:Category:Chromebooks]], and inserts a list of other Articles in that Category.
; [[Template:Communication|<nowiki>{{Communication}}</nowiki>]]
; [[Template:Communication|<nowiki>{{Communication}}</nowiki>]]
: Adds Article to [[:Category:Communication]], and inserts a list of other Articles in that Category.
: Adds Article to [[:Category:Communication]], and inserts a list of other Articles in that Category.

Revision as of 22:05, 20 August 2017

Our Google spreadsheet for organizing content for this wiki.

Top of article - abox info template

{{abox}}
Goes at the TOP of every article to indicate authorship, currency, audience, etc.
Click the link to get the full text, copy / paste to your article, then fill it out.

Article content

  • each page answers a single question -- e.g. how do I find a list of Riverdale Google Calendars
    • it is not a catch-all for everything about a subject -- other question means another page
      • except for our Get help from Google page, which is a catch-all
  • each page starts with an {{abox}} and ends with a {{CategoryTemplate}}
  • inline images (for instructions) are now added in a very particular way, with a variation of this code:
[[File:Interesting cal.png|thumbnail]]Here's a picture of what you should do<br clear="all">
which gives you this, including the open space before the next instruction:
Interesting cal.png
Here's a picture of what you should do
plus you can alter the size of the images by adding "|100px" (or another size) as follows:
[[File:Interesting cal.png|thumbnail|100px]]
to get this:
Interesting cal.png
Here's a tiny image. It's cheaper that way.

See this example/edit for source code examples.

Bottom of article - category templates

ONE of these should be placed at the very bottom of an article. Choose its main category.

  • Don't list a secondary/specific category unless it's critical to show two sets of "other articles in this category" links.
  • Do list a secondary/specific category for the subsets under the main categories below.
{{Calendaring}}
Adds Article to Category:Calendars and Scheduling, and inserts a list of other Articles in that Category.
{{SS}}
Adds Article to Category:Software and Services, and inserts a list of other Articles in that Category.
{{ClassTech}}
Adds Article to Category:Classroom technology and systems, and inserts a list of other Articles in that Category.
{{Chromebooks}} (level 2, specific category)
Adds Article to Category:Chromebooks, and inserts a list of other Articles in that Category.
{{Communication}}
Adds Article to Category:Communication, and inserts a list of other Articles in that Category.