Difference between revisions of "Help:Building Event Note Cards"
Infobroker (talk | contribs) (consolidate the help documentation - move Timeline and Events Commentary to their own page) |
Infobroker (talk | contribs) (streamline the instructions) |
||
Line 1: | Line 1: | ||
− | |||
− | |||
− | |||
− | |||
− | |||
== Timelines and Annotation Lists Are Back (with a vengeance) == | == Timelines and Annotation Lists Are Back (with a vengeance) == | ||
− | + | People should feel free to try their hand at making '''Event Note-Cards.''' This button is a fast way to prime a Herocopia page with a shell of the basic templates you need to detail and link it to an event. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | Doing an Event Annotation is easy and straightforward because it is template driven. | |
− | + | === Here's the process in a nutshell: === | |
− | Step 1: | + | '''Step 1:'''<br> |
Start by making a list of the events in an outline like format. I put my outline on a [[ Sandbox:infobroker/Sample1 | Sandbox page ]] I built here on the herocopia site. You will note, I made them links so they serve as the feed to make the Event Annotation pages, one for each defined event. | Start by making a list of the events in an outline like format. I put my outline on a [[ Sandbox:infobroker/Sample1 | Sandbox page ]] I built here on the herocopia site. You will note, I made them links so they serve as the feed to make the Event Annotation pages, one for each defined event. | ||
− | Step #2: | + | '''Step #2:'''<br> |
− | + | Edit an '''event framework''' page to annotate the event. You can use this button to get it started, or you can cut and paste from an existing event. | |
<inputbox> | <inputbox> | ||
Line 54: | Line 22: | ||
</inputbox> | </inputbox> | ||
− | '' | + | '''step #3:'''<br> |
+ | Edit the "EventHeader" template. This is where you add information about the element itself. The parameters should be fairly self-explanatory. I'll add more documentation later. | ||
+ | |||
+ | '''step #4:'''<br> | ||
+ | An event is made of one to many '''event elements.''' You use an '''eventElement''' template for each one. I've identified two types for now (character and device). There might be more. Feel free to weigh in on your thoughts here. | ||
+ | |||
+ | '''step #5:'''<br> | ||
+ | Close the framework with an '''EventFooter''' template. | ||
+ | |||
− | + | There are still some glitches and ghosts in the machine. But don't worry about them, they are minor and/or don't impact the process. | |
− | |||
− | + | == Caveats, Guidelines and Such == | |
− | + | * I will be adding some documentation which will also include a basic Q&A as time permits. Feel free to append question on the Discussion Tab(above). | |
+ | * The template names might (WILL) change, but that impact should be negligible to authors. | ||
+ | * There will be ongoing impact and changes to the site as a whole as these events note-cards firm up. | ||
+ | * I ask for now, that any issue being annotated not to have been published within the last six months. Yes there are already some that I did during testing that violate this guideline, but lets try to adhere to this going forward. | ||
+ | * As current examples show, there is only '''ONE EVENT PER PAGE.''' | ||
+ | * Use the discussion tab on this page for questions, suggestions, ideas and comments. | ||
− | + | == Example Issue == | |
− | + | The Flip Book is the prototype example of a fully(subject to viewpoint) annotated issue. This is a perfect choice for two very good reasons: | |
− | + | # It is straight line continuity, without too many references to other time periods, and there are no flashbacks or flashforwards. | |
+ | # The issue is available for a free read to anyone that wants to register an account with Comixology (also free). So everyone can read it and be familiar with the granularity I used in delineating the events. | ||
− | + | You can read the issue [[https://www.comixology.com/Astro-City-Flipbook/comics-series/12461 | here]]. | |
− | + | You can see the list of events that were defined for that issue [[Astro_City:_The_Flip_Book/Events | here]]. | |
+ | You can see an example of one of the events by clicking [[Honor_Guard's_First_Big_Clash_with_Pyramid |here]]. | ||
− | + | And you can see how the event incorporates into a character page by clicking on one of the "event elements," like this one for [[Starwoman]]. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | The events for this issue({{ACA}}) incorporated into some of the many Annotation Pages that we will have available as part of the Herocopia Project. The possibilities here are massive, cool and ongoing. | + | The events for this issue({{ACA}}) incorporated into some of the many Annotation Pages that we will have available as part of the '''Herocopia Project'''. The possibilities here are massive, cool and ongoing. |
* [[TestEvents| Master Event Timeline Page]] | * [[TestEvents| Master Event Timeline Page]] | ||
Line 86: | Line 63: | ||
* [[Minor_Events]] | * [[Minor_Events]] | ||
* [[TestCharaterTimeline | Master Character Annotation Timeline]] (Work in progress) | * [[TestCharaterTimeline | Master Character Annotation Timeline]] (Work in progress) | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | == Peeling Back the Cover on Templates: == | |
− | + | Start with the major output page - a Chronological Timeline (it will be pretty printed later) of all the handful of events from two different Astro City comical books. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | Start with the output page - a Chronological Timeline (it will be pretty printed later) of | ||
[[TestEvents]] | [[TestEvents]] | ||
Line 174: | Line 122: | ||
[[Ms._Ellie_in_her_workshop_repairing_the_robot_that_would_become_Arthur]] | [[Ms._Ellie_in_her_workshop_repairing_the_robot_that_would_become_Arthur]] | ||
− | |||
− | |||
− | |||
− | |||
'''These functions, and others, will have significant impact (just like the info-boxes did), in how the Herocopia will evolve going forward.''' | '''These functions, and others, will have significant impact (just like the info-boxes did), in how the Herocopia will evolve going forward.''' | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | --Infobroker (talk) | + | As always, thanks for your participation, help and patience.--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 19:07, 22 December 2014 (PST) |
Revision as of 22:07, 22 December 2014
Contents
Timelines and Annotation Lists Are Back (with a vengeance)
People should feel free to try their hand at making Event Note-Cards. This button is a fast way to prime a Herocopia page with a shell of the basic templates you need to detail and link it to an event.
Doing an Event Annotation is easy and straightforward because it is template driven.
Here's the process in a nutshell:
Step 1:
Start by making a list of the events in an outline like format. I put my outline on a Sandbox page I built here on the herocopia site. You will note, I made them links so they serve as the feed to make the Event Annotation pages, one for each defined event.
Step #2:
Edit an event framework page to annotate the event. You can use this button to get it started, or you can cut and paste from an existing event.
step #3:
Edit the "EventHeader" template. This is where you add information about the element itself. The parameters should be fairly self-explanatory. I'll add more documentation later.
step #4:
An event is made of one to many event elements. You use an eventElement template for each one. I've identified two types for now (character and device). There might be more. Feel free to weigh in on your thoughts here.
step #5:
Close the framework with an EventFooter template.
There are still some glitches and ghosts in the machine. But don't worry about them, they are minor and/or don't impact the process.
Caveats, Guidelines and Such
- I will be adding some documentation which will also include a basic Q&A as time permits. Feel free to append question on the Discussion Tab(above).
- The template names might (WILL) change, but that impact should be negligible to authors.
- There will be ongoing impact and changes to the site as a whole as these events note-cards firm up.
- I ask for now, that any issue being annotated not to have been published within the last six months. Yes there are already some that I did during testing that violate this guideline, but lets try to adhere to this going forward.
- As current examples show, there is only ONE EVENT PER PAGE.
- Use the discussion tab on this page for questions, suggestions, ideas and comments.
Example Issue
The Flip Book is the prototype example of a fully(subject to viewpoint) annotated issue. This is a perfect choice for two very good reasons:
- It is straight line continuity, without too many references to other time periods, and there are no flashbacks or flashforwards.
- The issue is available for a free read to anyone that wants to register an account with Comixology (also free). So everyone can read it and be familiar with the granularity I used in delineating the events.
You can read the issue [| here].
You can see the list of events that were defined for that issue here.
You can see an example of one of the events by clicking here.
And you can see how the event incorporates into a character page by clicking on one of the "event elements," like this one for Starwoman.
The events for this issue(Astro City: The Flip Book) incorporated into some of the many Annotation Pages that we will have available as part of the Herocopia Project. The possibilities here are massive, cool and ongoing.
- Master Event Timeline Page
- Major_Events
- Minor_Events
- Master Character Annotation Timeline (Work in progress)
Peeling Back the Cover on Templates:
Start with the major output page - a Chronological Timeline (it will be pretty printed later) of all the handful of events from two different Astro City comical books.
The page is completely auto-generated using the following query (you can see it live and in person by tapping on the edit tab on the page)
== Character Compendium of Astro City == {{#ask:[[Category:TestEvents2]] | ?eventDate | ?name | ?elementType | ?issue | sort = eventDate | order = ascending }}
The data is entered on event pages using some hand-built templates.
Like so:
{{Test:Event2 |title = {{PAGENAME}} |summary = * <bullet form> |date = 20??/mm/dd |type = flashback |comicTitle = {{AC}} No. 14 |issue = {{AC}} No. 14 |page = 11 |panel = 1 }} {{Test:EventCharElem |link = |element = Ms. Ellie }} {{Test:EventCharElem |link = |element = Arthur }} {{Test:EventDeviceElem |link = no |element = Robo-Dog }} {{Test:EventEndMarker2}}
This built the following page and also primed page property data that feeds the auto-generated page above.
Ms._Ellie_in_her_workshop_repairing_the_robot_that_would_become_Arthur
These functions, and others, will have significant impact (just like the info-boxes did), in how the Herocopia will evolve going forward.
As always, thanks for your participation, help and patience.--Infobroker (talk) 19:07, 22 December 2014 (PST)