Difference between revisions of "Help:Building Event Note Cards"

From Herocopia
Jump to: navigation, search
(consolidate the help documentation - move Timeline and Events Commentary to their own page)
 
m (individual issue no longer available from Comixology.)
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{editMark
 
|notes = this needs work. It is just collected together here for now.  Need to move teh time line history and implementation notes to the discussion tab, but leave the how it works and how to use it stuff here for authors to use.
 
}}
 
 
 
 
== Timelines and Annotation Lists Are Back (with a vengeance) ==
 
== Timelines and Annotation Lists Are Back (with a vengeance) ==
  
The structural framework and working mechanics for Building dynamic on-demand Timelines using '''Event Note-Cards''' is pretty much in place and functioning smoothly.  There are still lots of fine-tuning and look'n'feel things to attend to, but most of that will not impact the event note-card process for entering events/.
+
People should feel free to try their hand at making '''Event Note-Cards.''' The button mentioned in Step 2 (below) 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.
 
 
People are free to try their hand at making '''Event Note-Cards.''' I suggest picking a favorite issue and begin identifying and annotating events as a list.  There is a button down below to prime an event page. (It will be moving elsewhere eventually). But for now it will hang here.
 
 
 
* I will be adding some documentation which might also include a basic Q&A as time permits.
 
* 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.
 
 
 
As always, thanks for your participation, help and patience.
 
 
 
--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 10:11, 12 December 2014 (PST)
 
 
 
P.S. most of the earlier notes (below) on Timelines will be archived and/or incorporated into Help documentations.
 
 
 
== Timelines are Coming Back (Part III): ==
 
 
 
'''Milestone #2 - 90% achieved'''
 
 
 
An entire issue of an Astro City comic annotated using the new (and currently still in test mode) event templates.
 
 
 
I was originally planning to do the newest issue of Astro City ({{AC}} #17), but as I explained to Kurt, there were a bit too many events happening in that issue to make a good demonstration vehicle.  He apologized, but he also laughed.
 
So instead I compromised and went with {{ACA}}.  This is a better 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 access the issue [[https://www.comixology.com/Astro-City-Flipbook/comics-series/12461 | here]].
+
Doing an ''Event Annotation'' is easy and straightforward because it is template driven.
  
Doing an Event Annotation is easy and straightforward because it is template driven.  Here's the process in a nutshell.
+
=== 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.
+
Pick an event from an issue of Astro City, or do an entire issue.  For the later, start by making a list of the events in an outline like format. Either way, it means reading an Astro City Comic, so there is a lot of fun to this projectIn both cases, check the [[http://herocopia.com/Category:Events_By_Issue | ''Events By Issue'' link]] to insure that the event(s) haven't already been annotated.
  
Step #2:
+
'''Step #2:'''<br>
Use an '''event framework''' (it may, probably will change over time, but if done properly, the impact will be minimal) to annotate the event. You can use this button to get it started, or you can cut and paste from an existing event.   
+
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>
  
''(I'll explain more about the framework when I get round to building the documentation pages for each of the templates.)''
+
'''step #3:'''<br>
 +
Edit the "EventHeader" template. This is where you add information about the event itself.  The parameters should be fairly self-explanatory.  I'll add more documentation later.
  
step #3:
+
'''step #4:'''<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:
 
 
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.
 
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:
+
'''step #5:'''<br>
Close the framework with and '''EventFooter''' template.
+
Close the framework with an '''EventFooter''' template.  
  
The example I've done should help put all of this into context (I hope).  If you are comfortable about all this, you are welcome to pick an issue and try it out.  Use a sandbox page to test with.  I plan to put up a signout sheet so we can coordinate the process better.  For now please just append a note here saying you are reserving an issue.
 
  
There are still some glitches and ghosts in the machine.  Page name is currently a problem.  The wiki semantic parser likes to frame the name with two single quotes.  Don't worry about that for now, we will fix it so they append from the current Publications pages.  Probably as "<current pub page>/Events" or something similar.
+
There are still some glitches and ghosts in the machine.  But don't worry too much about them, they are minor and/or shouldn't impact the overall process.  
  
Have fun! Ask questions using the discussion tab above.
+
== Caveats, Guidelines and Such ==
 +
* There will be ongoing impact and changes to the site as a whole as these events note-cards firm up.
 +
* Even if annotating material from comics recently published, please do not use Spoiler Alerts. I would prefer NOT having to maintain them for these event pages. Anyone browsing these pages, does so knowing they are risking spoilage.
 +
* I will ask that when creating (or editing) these Event Note Cards, please source from the comic pages directly.  Don't rely on memory, or secondary sources, not even '''Herocopia'''.
 +
* If information like dates get clarification from other places like letters pages, commentary from Kurt, or others on the creative staff, please detail that in the summary section. These Event Notes Cards work very much the same as bibliography notes for a research paper. 
 +
* As current examples show,  there is only '''ONE EVENT PER HEROCOPIA PAGE.''' 
 +
* Use the discussion tab on this page for questions, suggestions, ideas and comments.
  
 +
=== Event Entries Not Showing Up On Herocopia Issue and Character Pages ===
 +
The problem has to do with how wiki sites update pages with queries on them. It is not an automatic process. Pages get cached, and something has to trigger the page that it needs to be updated. Usually a change (edit) to the page will do the trick. But for pages that don't change, the cached paged is what is delivered from the server.  Over time the pages will get refreshed by trigger devices within the wiki server, but if you want to check your entries, here's the steps to take...
  
'''Summary For Milestone #2'''
+
# Go to the events page (for the issue or the character(sometimes they don't show up either), and click the tab to edit that page.
The '''Generated Event''' list for [[''Astro_City:_The_Flip_Book'']]
+
# Click the "show preview" button at the bottom of the page. That should trigger the server to re-generate the page which includes running the query to find all the event note cards that reference the particular issue or character.
 +
# Clicking the "save page" button (even if you didn't make any changes) will insure the update is stored and cached for future viewing.
  
The '''Events Pages''' (one for each event)
+
== Example Issue ==
{{#ask:[[Category:TestEvents2]][[issue::''Astro City: The Flip Book'']]
+
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:
| ?eventType
 
}}
 
  
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.
+
# 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.
  
* [[TestEvents| Master Event Timeline Page]]
+
You can see the list of events that were defined for that issue [[Astro_City:_The_Flip_Book/Events | here]].
* [[Major_Events]]
+
[[image:FlipBookEventList.jpg|600px|center|link=Astro_City:_The_Flip_Book/Events]]
* [[Minor_Events]]
 
* [[TestCharaterTimeline | Master Character Annotation Timeline]] (Work in progress)
 
* [[HonorGuardTimeLine | Honor Guard Annotation Timeline]] (Pretty much one of these for everyone and anyone we want one for) (work in progress)
 
  
  
--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|tal
+
You can see an example of one of the events by clicking [[Honor_Guard's_First_Big_Clash_with_Pyramid |here]].
k]]) 11:46, 22 November 2014 (PST)
+
[[image:eventExample.jpg|600px|center|link=Honor_Guard's_First_Big_Clash_with_Pyramid]]
  
== Issue Reservation List (temporary) ==
 
Please, only check out one issue at a time.
 
  
'''Infobroker'''
+
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]].
:* {{ACA}} - done
+
[[image:StarwomanEventExample.jpg|600px|center|link=Starwoman]]
:* {{KBAC2}} #7 - Premature, not quite done yet.
 
:* {{ASTRA}} #1 - checked out - done
 
:* {{KBAC1}} #5 - checked out
 
  
  
 +
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]]
 +
* [[Major_Events]]
 +
* [[Minor_Events]]
 +
* [[TestCharaterTimeline | Master Character Annotation Timeline]] (Work in progress)
  
== Timelines are Coming Back (Part II): ==
+
== Peeling Back the Cover on Templates: ==
 
+
Start with the major output page - a Chronological Timeline (it will be pretty printed later) of all the  events from Astro City comical books that have been annotated to date.
The chaotic testing over the past week is paying off.  We have devised a scheme for bringing back our Timelines,  but this time in a manner that will allow full participation from our online community.  We are still in test mode, we are still a few weeks away from even being available in a beta-type environment, but  I will post updates when things are open for others to participate.
 
 
 
Things are changing fast, but here's a summary of the demonstration material that is online now.
 
 
 
 
 
'''Milestone #1 achieved'''. 
 
 
 
We have proof of concept on both the process for data entry and a working prototype of a Timeline being built and generated using Semantic Wiki Queries.  I am a happy camper.
 
 
 
This is nothing more than a prototype at this stage.  It is very raw and there is not much in the way of well engineered design layouts.  But the function is working,  and while the data entry process  is still a bit intense, it is not much different from what I was doing with the Access Database structures on my local machines a few years ago.
 
 
 
Start with the output page - a Chronological Timeline (it will be pretty printed later) of a handful of events from two different Astro City comical books.
 
  
 
[[TestEvents]]
 
[[TestEvents]]
  
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)
+
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 that page.
  
 
<pre>
 
<pre>
Line 175: Line 133:
  
  
I know what is here is very rough, but proof of concept is accomplished. Next steps are to smooth out several kinks with how the data is displayed. Then we will construct various Timeline pages for Characters,  Events, and we can subset pages to particular time spans and there will also be Event list pages, one for each issue,  and once we smooth it out even more, we can use this data entry to drive the appearance lists for the character info boxes.  That is currently be built manual.  Once we get enough data events entered, we will wired entries in the '''info boxes''' up to the events.
+
These functions, and others, will have significant impact (just like the info-boxes did), in how the '''Herocopia Project''' will evolve going forward.   
 
 
There will be some very basic guidelines coming, that will help explain the process more fully and will server as guide for the editing community to participate in the process.
 
 
 
'''These functions, and others, will have significant impact (just like the info-boxes did), in how the Herocopia will evolve going forward.'''    
 
 
 
Thanks to all for your patience. 
 
 
 
--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 10:50, 8 November 2014 (PST)
 
 
 
:----
 
 
 
:More auto-generated Event pages,  these filtered to individual issues.--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 15:32, 8 November 2014 (PST)
 
 
 
:[[''Astro_City''_No.14]]
 
:[[''Kurt_Busiek's_Astro_City_Vol._2''_No.7]]
 
 
 
::----
 
 
 
::I received a query about the original Appearance and Annotation Timelines.  I currently don't have a means to resurrect from my local array of computers. However, they are intact at archive.org.--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 15:43, 8 November 2014 (PST)
 
 
 
::https://web.archive.org/web/20081121050723/http://www.herocopia.com/index.php/Annotations_Timeline
 
::https://web.archive.org/web/20100409054033/http://www.herocopia.com/index.php/Appearance_Timeline
 
 
 
 
 
== Timelines coming back ==
 
 
 
It has always been in the back of my head to bring back the Timelines. When up to date, they were a nice list of character appearances, events and some notations to certain aspects (minor and major) that involved Astro City in general.
 
 
 
* They are event driven.
 
* They focused on characters.
 
* There was always a problem keeping them up to date.
 
 
 
The mechanisms for annotating them are tied to a Database (Microsoft Access in this case). That limits them to non-wiki data entry in the initial stages. Being in a Database (relational of course), fully third-normal form, made managing the data a breeze. There wasn't any multiple data entry and bookkeeping to maintain or get out of synch. One event entry, with links to characters and such. There are ways to mimic some of this using #LABELS here in mediaWiki-land, and plans are in place to move more so towards that model for a lot of our pages currently in play. But that still doesn't replace full third normal form data organization.
 
  
However and yet, the offline annotations/timeline/event entry systems has the problem of being offline, and only one person (me in this case), being able to do the entry work. Add in the work to do the updates, and the corrections, and yea somewhere in the early months of the Dark Age books, my personal life veered heavily and time became something more than just chaotic and precious, and entered into some absurd overdrive. The Astro City timeline was one of the causalities. Worse, in the three-four year time span that it has been unattended, the computer it was on is pretty much a decommissioned brick. It might still work, but it will require an weekend or so to bring it back from the dead.
 
  
I am looking at modern alternatives, that might even include some form of online entry. But that is an even more involved time investment.
+
As always, thanks for your participation, help and patience.--[[User:Infobroker|Infobroker]] ([[User talk:Infobroker|talk]]) 19:07, 22 December 2014 (PST)
  
I would like to jump start the project soon. Just wanted to let people know...
 
  
--Infobroker (talk) 11:38, 3 April 2014 (PDT)
+
=== Archive Links ===
 +
[[Help:Building_Event_Note_Cards/Archives1]]

Latest revision as of 15:25, 28 October 2021

Timelines and Annotation Lists Are Back (with a vengeance)[edit]

People should feel free to try their hand at making Event Note-Cards. The button mentioned in Step 2 (below) 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:[edit]

Step 1:
Pick an event from an issue of Astro City, or do an entire issue. For the later, start by making a list of the events in an outline like format. Either way, it means reading an Astro City Comic, so there is a lot of fun to this project. In both cases, check the [| Events By Issue link] to insure that the event(s) haven't already been annotated.

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 event 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 too much about them, they are minor and/or shouldn't impact the overall process.

Caveats, Guidelines and Such[edit]

  • There will be ongoing impact and changes to the site as a whole as these events note-cards firm up.
  • Even if annotating material from comics recently published, please do not use Spoiler Alerts. I would prefer NOT having to maintain them for these event pages. Anyone browsing these pages, does so knowing they are risking spoilage.
  • I will ask that when creating (or editing) these Event Note Cards, please source from the comic pages directly. Don't rely on memory, or secondary sources, not even Herocopia.
  • If information like dates get clarification from other places like letters pages, commentary from Kurt, or others on the creative staff, please detail that in the summary section. These Event Notes Cards work very much the same as bibliography notes for a research paper.
  • As current examples show, there is only ONE EVENT PER HEROCOPIA PAGE.
  • Use the discussion tab on this page for questions, suggestions, ideas and comments.

Event Entries Not Showing Up On Herocopia Issue and Character Pages[edit]

The problem has to do with how wiki sites update pages with queries on them. It is not an automatic process. Pages get cached, and something has to trigger the page that it needs to be updated. Usually a change (edit) to the page will do the trick. But for pages that don't change, the cached paged is what is delivered from the server. Over time the pages will get refreshed by trigger devices within the wiki server, but if you want to check your entries, here's the steps to take...

  1. Go to the events page (for the issue or the character(sometimes they don't show up either), and click the tab to edit that page.
  2. Click the "show preview" button at the bottom of the page. That should trigger the server to re-generate the page which includes running the query to find all the event note cards that reference the particular issue or character.
  3. Clicking the "save page" button (even if you didn't make any changes) will insure the update is stored and cached for future viewing.

Example Issue[edit]

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:

  1. It is straight line continuity, without too many references to other time periods, and there are no flashbacks or flashforwards.
  2. 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 see the list of events that were defined for that issue here.

FlipBookEventList.jpg


You can see an example of one of the events by clicking here.

EventExample.jpg


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.

StarwomanEventExample.jpg


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.

Peeling Back the Cover on Templates:[edit]

Start with the major output page - a Chronological Timeline (it will be pretty printed later) of all the events from Astro City comical books that have been annotated to date.

TestEvents

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 that 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 Project will evolve going forward.


As always, thanks for your participation, help and patience.--Infobroker (talk) 19:07, 22 December 2014 (PST)


Archive Links[edit]

Help:Building_Event_Note_Cards/Archives1