ETHNOPOETICS.ORG : a collaboration to extend the valuing and study of global poetries

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
omnipoetics:editing_guide_2025 [2025/02/13 15:21] – [Block quote] adminomnipoetics:editing_guide_2025 [2025/04/23 23:57] (current) – [Bullets and Numbered Lists] admin
Line 3: Line 3:
 We may use this space to document process decisions or simply track style-guide decisions. We may use this space to document process decisions or simply track style-guide decisions.
  
-<WRAP center round important 90%>+<WRAP left round important 50%>
  
-**For discussion**+===== For Discussion =====
  
   * Is there a usefulness and desire to create a more regular structure of "sub-sections" to our wiki entries?    * 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 [[omnipoetics:law_of_the_rights_of_mother_earth|Law of the Rights of Mother]]     * See Sherwood's example as a possibile guide [[omnipoetics:law_of_the_rights_of_mother_earth|Law of the Rights of Mother]]
     * Template from example above [[entry-template]]     * Template from example above [[entry-template]]
 +  * Should we rename and/or reclassify entries so that information and "commentary" (essay-like) entries are distinguished? Option (flat the section of an entry that is more interpretive as "commentary"
  
  
 +You can make other suggestions here or in the "Discussion" are at the bottom of the page. 
 </WRAP> </WRAP>
  
 +===== Entry Editing Process =====
  
 +  - Begin by discussing and making desired edits to entry structure
 +    - Pay attention to headings and subheadings
 +    - Use the edit guide below
 +    - Name a "subsection" if there are more than two paragraphs on the sub-topic. 
 +  - Work on cross-references (using tags but also links to other entries of relevance
 +  - Update or complete list of Works Cited and/or Additional References
 +  - Copy edit for clarity, grammar, puncuation, and consistency.
 +===== I. Review Tags =====
  
-===== Basic Formatting =====+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.  
 + 
 + 
 + 
 +===== II. Apply Standard Heading and Structural Formatting ===== 
 + 
 +==== Basic Formatting =====
  
 **1. At the top of each page, give the title a heading level of one** **1. At the top of each page, give the title a heading level of one**
Line 38: Line 55:
  
  
-===== Block quote =====+**3. Endnotes for quoted/paraphrased sources - Additional References Listed at bottom ** 
 + 
 +Include links when possible. Include the most complete publication information available, for sources referenced and quoted.  
 + 
 +This code 
 +<code> 
 +((Rothenberg, Symposium of the Whole, 246)) 
 +</code> 
 + 
 +will embed a link to the full information and list it at the bottom of the page.((Rothenberg, Symposium of the Whole, 246)) 
 + 
 + 
 +<WRAP center round help 60%> 
 +Distinguish sources that are referenced and listed at the end as "Works Cited."  
 + 
 +"Additional References" should come at the end, listing a source not referenced. 
 +</WRAP> 
 + 
 + 
 + 
 +===== III. 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.  
 + 
 + 
 +<code> 
 +{{robert_johnson.png?250|Robert Johnson - Fair Use from https://en.wikipedia.org/wiki/File:Robert_Johnson.png}} 
 +</code> 
 + 
 +{{ :omnipoetics:robert_johnson.png?direct&200 |Robert Johnson - Fair Use from https://en.wikipedia.org/wiki/File:Robert_Johnson.png}} 
 + 
 + 
 += 
 + 
 + 
 +===== IV. Quotations - Block quote =====
  
 Long quotes and poem quotes can be visually flagged with special markup.  Long quotes and poem quotes can be visually flagged with special markup. 
Line 48: Line 102:
  
 Here is a few lines from a poem within a block quote:  Here is a few lines from a poem within a block quote: 
 +
 +<blockquote>
  
 <poem> <poem>
Line 63: Line 119:
 so so
 </poem> </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.  
- 
- 
- 
-<WRAP group> 
-<WRAP half column> 
-columns 
- 
- 
-<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> 
- 
- 
-</WRAP> 
- 
-<WRAP half column> 
 <code> <code>
  
-<WRAP center round box 60%> +<blockquote>
-simple centered box +
-</WRAP>+
  
 +<poem>
  
-<WRAP center round info 60%> +Text Here 
-info box +</poem> 
-</WRAP>+</blockquote>
  
  
-<WRAP center round tip 60%> +</code>
-tip box +
-</WRAP>+
  
-<WRAP center round important 60%> 
-important box 
-</WRAP> 
  
  
-<WRAP center round alert 60%> +====== Fancy Format - Boxes and Borders ======
-alert box +
-</WRAP>+
  
 +Let's generally omit fancy formating.  [[fancy format boxes and borders]]
  
-<WRAP center round help 60%> +-----
-help box</wrap> +
-</WRAP> +
- +
- +
-<WRAP center round todo 60%> +
-todo box +
-</WRAP> +
-</code> +
- +
-</WRAP> +
-</WRAP> +
-<WRAP clear/> +
  
  

Trace:

Navigation

Current:

Alcheringa:

Print/export
QR Code
QR Code omnipoetics:editing_guide_2025 (generated for current page)