This is an old revision of the document!
Table of Contents
Editing Guide
We may use this space to document process decisions or simply track style-guide decisions.
For Discussion
- Is there a usefulness and desire to create a more regular structure of “sub-sections” to our wiki entries?
- See Sherwood's example as a possibile guide Law of the Rights of Mother
- Template from example above entry-template
Tags
We may decide to generate a controlled vocabulary content tags that would serve to create cross references or links to other pages in the wiki. Consider what might be useful-tags for the pages you have recently worked on.
Images
- When using images, please look for Public Domain or Creative Commons available documents.
- Upload only images less than 500K; smaller is preferable. Resize your found image if necessary.
- Use the “Caption” element to provide a descriptive name for accessibility; add brief source information; see below.
{{robert_johnson.png?250|Robert Johnson - Fair Use from https://en.wikipedia.org/wiki/File:Robert_Johnson.png}}
Basic Formatting
1. At the top of each page, give the title a heading level of one
====== Title of Page ======
2. Use succinct level 2 headlines to categorize major sections. exs.
==== Context =====
==== Language =====
==== Genre ====
Bullets and Numbered Lists
Succint points can be in lists when it helps clarity
Block quote
Long quotes and poem quotes can be visually flagged with special markup.
Here is a block quote:
This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.This is a long quote.
Here is a few lines from a poem within a block quote:
This is a line
from a poem
and it respects
the line breaks
when you put in the
special
tags
like
so
<blockquote> <poem> Text Here </poem> </blockquote>
Fancy Format - Boxes and Borders
It is possible to “WRAP” content with code that changes the way it is displayed. You'll see some paragraphs and sections visually set off on this wiki and my course pages in boxes with colorful borders. I'll share the code for some of these people, but we should discuss as a class whether and which to use. It won't contribute to overall coherence of the entries if we all use different visual markers. Be careful since each “box” has a pair of tags; you can easily “break” the box by omitting a closing tag or otherwise not “pairing” them. Also, some other formatting might not work when wrapped in a box.
columns
simple centered box
info box
tip box
important box
alert box
help box</wrap>
todo box
<WRAP center round box 60%> simple centered box </WRAP> <WRAP center round info 60%> info box </WRAP> <WRAP center round tip 60%> tip box </WRAP> <WRAP center round important 60%> important box </WRAP> <WRAP center round alert 60%> alert box </WRAP> <WRAP center round help 60%> help box</wrap> </WRAP> <WRAP center round todo 60%> todo box </WRAP>
