Difference between revisions of "Help:Contents"

From Herocopia
Jump to: navigation, search
m (testing preload button)
m
(32 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{|
 +
| style="vertical-align:top; text-align:left" |
 +
Read on if you are interested in contributing content to the officially sanctioned website, dedicated to the award winning comic series '''Astro City.'''
 +
 
----
 
----
<table width="100%"><tr><td><!-- You could create (or transclude) a forum header here --></td><td width="50%"><inputbox>
+
'''New Users: Aid to Getting Started'''
type=create
 
break=no
 
prefix=Test:
 
<!-- preload=Template:Forumheader/{{PAGENAME}}
 
-->
 
  
preload=Template:character infobox2/preload
+
Kurt Busiek, Brent Anderson, Alex Ross and Company have been creating new characters at a frantic pace.  So frantic, Herocopia authors have been challenged  to keep pace.  Many of these new characters either are missing from Herocopia altogether, or they have what we call a stub-page, with little to no information provided.  I have used some basic wiki query code, to build a stub list on your user talk pages. It is also included at the bottom of this page.  You can use either of them to navigate directly to pages that are stubby in nature, or feel free to build a new page for characters not yet included. 
  
buttonlabel=Add new character
+
As the Orbor Mystery continues to unfold, there are a dozen or so new (and old) characters that need entries built for them, or clean-up editing updates.  A review of {{AC}} issues one, five, and six would be a good starting point for fleshing out more details about the [[the Broken Man | Broken Man]], [[Mister Cakewalk]]. [[Dame Progress]], [[Lord Saampa]], to name but a few.
</inputbox></td></tr>
+
 
</table>
+
- jb the ib -
  
 
----
 
----
As the [[Broken Man]] mentions on the [[Main Page]], this site took some damageIt's part of the challenges of living in the age of the 'tubes of internets.'  We are in the midst of a rebuilding campaign and we welcome all the help we can get.   Most of the character pages that we had are gone. Some are recoverable (see below), and some will need to be rebuilt from scratch.
+
There are four major areas (and a lot of little ones too) where Herocopia is always in need of help.
 +
 
 +
''' [[Help:Character Editing | #1) Authoring Character Pages]]'''<br>
 +
We use templates for Characters and other things relating to '''Astro City'''. Assistance on how to use them can be found by clicking [[Help:Character Editing | here.]]
 +
 
 +
 
 +
''' [[Help:Building Event Note Cards | #2) Building Event Note Cards for Events and Annotations]]'''<br>
 +
We are currently in a big push to build Event Annotation Note Cards. These too are template driven, and they are engineered to generate automatic timelines and appearance lists for just about everything related to Astro City. 
 +
 
 +
More information on how you can help with this part of the '''Herocopia Project''' can be found by clicking [[Help:Building Event Note Cards | here.]]
 +
 
 +
 
 +
'''[[Help:Non-character Page Editing | #3) Authoring Non-Character Pages]]'''<br>
 +
These are pages that relate to City infrastructure, places, neighborhoods, organizations and things beyond Astro City proper.  They are built using [[Help:Non-character Page Editing | Device templates]].   
 +
 
 +
 
 +
''' #4) General Editing and Fact Checking'''<br>
 +
In addition, a lot of the longer running characters need updates, or attention, and some could use a touch of editing here and there to make them more readable.  The Fact Checking usually requires going back to the source material and validating the information here on the '''Herocopia''' site.  That means reading Astro City Comics.  Rough work for sure, but someone has to do it.
 +
 
 +
Help information for general mediaWiki editing can be found further down on this very page.
 +
 
 +
== General Editing Tools ==
 +
'''Herocopia.com''' is a MediaWiki website. Do you want to contribute, but do not know how to edit pages? These guides might be of help.
 +
 
 +
<!-- * [[MetaWikipedia:Help:Contents|MediaWiki Users' Handbook]] -->
 +
* [[Wikipedia:Category:Wikipedia style guidelines|Wikipedia's style guidelines]]
 +
* [[Wikipedia:Category:Wikipedia how-to|How-to... in Wikipedia]]
 +
* [[Wikipedia:Category:Wikipedia style guidelines|Wikipedia's style guidelines]]
 +
* http://www.mediawiki.org/wiki/Help:Formatting - Formatting tips
 +
 
 +
== Basic Guidelines pertaining to Herocopia ==
 +
 
 +
The intended audience for this website are the casual readers of Astro City Comics.  It is a place for them to visit when they want additional information about the characters, places and events that occur between the covers of those publications.
 +
 
 +
With that in mind, here are some additional Guidelines for authors to consider.
  
That's the bad news.
+
* '''Provide Context to your Writing'''
  
The good news is we are back and we are making great progress with the rebuilding.  For some of you veterans, you will see that we are improving the templates used for building character pages, and are just beginning the process of incorporating them into the initial batch of pages that are currently linked and displayable.  So most of what you see during this early stage of recovery, is a hodgepodge of contents. Thrown together bits of old data with little to no formatting.  With each passing day this is getting better and betterFeel free to assist with the clean up operations.  
+
:Trivia is great, that is a major aspect of what this site is all aboutHowever, when appending it to Herocopia pages, try to provide context, so the information isn't just noise.
  
Another bit of good news, we have ramped up security measures a bit by upgrading the software and adding a few features to keep the vandalism 'bots at bay.  So current and new content should be safe and this site will be a steady resource for information on one of the all time best super hero mythologies of our times.
+
:For example this isn't very useful to a casual reader:
  
Read on if you are interested in contributing to the restoration process of the officially sanctioned website, dedicated to the award winning comic series '''Astro City.'''
+
::''Earliest Appearance: 1959, 1964 to general population of Earth''
  
 +
:This on the other hand provides meaningful context that allows a Herocopia visitor to clearly understand the information being provided. Basically it has meaning and can be easily understood:
  
== Become a Digital Archeologist For Herocopia ==
+
::''In 1959, Eliot Mills saw and reported this incident for a feature story that he hoped would be printed in the [[Astro City Rocket]] newspaper. It was massively edited before publication and the general public did not hear of [[Shirak]] until five years later.''
One of the most precious aspects of the '''Herocopia Project''' has been the accumulation of a warehouse of information about the Characters of '''Astro City.''' Unfortunately, '''Herocopia.com''' underwent a serious crash that left a lot of interesting data for and about '''Astro City''' hanging in the limbos of the massively complex cavities of the internet. We are working diligently to restore as much of this previous information as possible. We are also adding new content as time and the urge to do so permit.
 
  
We have been searching the web for old saved '''Herocopia''' pages, along with checking local hard-drives of veteran contributors. We have discovered that the '''Wayback Machine''' located at www.archive.org is a fairly good source and can be mined for '''herocopia.com''' content from the past.  The only problem, it requires a lot of hand editing to bring it back to a format suitable for mediawiki development and deployment.
 
  
First steps are simple, just a bit tedious.
+
* '''{{Clarify}}'''
  
# Use the '''Wayback Machine''' site to find old '''Herocopia''' webpages. See links section below.
+
:Usually and in most cases, when "{{clarify}}" is sprinkled into the commentary, it is because some form of specific information is needed to provide context to the commentary. Follow the suggestion mention above and/or a combination of the following is also suggested as a possibility.  
# Be sure to check the '''Wayback''' timeline to find the best capture of data from the original '''Herocopia''' site. Dates from 2009 are proving the most fruitful, but it can vary dramatically from page to page.
+
# An issue, page and panel reference if it is in story.
# Copy the text (not the page source) to your computer's clipboard.
+
# If it is out of story, a reference or link to the outside source is helpful. The letters page perhaps, or a thread forum on the web (link provided if at all possible).
# Head back here to the new Herocopia site and dump the text to that character's page.  Create a new page if needed.
+
# If you are referencing a comment that one of the creators have stated, an exact quote is nice if possible, with a link if it is online.
# Add a <code>"{{{cutPaste}}}"</code> template at the top, to indicate this is a cut-n-paste entry that still needs editing, and if appropriate, a <code>"{{{stub}}}"</code> template at the bottom to signal that this page needs more authorship work.
+
# Bruisers, the message board run by John Rosell, is gone. Many of us long timers still have memories of commentary made there, but with it gone there is no linkBut if you are referring to something from there,  some kind of specific reference to it is helpful, provides context and backs up the comment.  
#Later on, you or a fellow Herocopia author can incorporate the old raw information into the new template structures that we use nowMore information on that coming right up, after we take a '''Links-break.'''
 
''
 
=== Links ===
 
http://web.archive.org/web/20090217195513/http://herocopia.com/index.php/Category:Heroes
 
<p>http://web.archive.org/web/20100401223306/http://www.herocopia.com/index.php/Category:Villains</p>
 
<p>http://web.archive.org/web/20100401223551/http://www.herocopia.com/index.php/Category:Teams</p>
 
<p>http://web.archive.org/web/20100401223253/http://www.herocopia.com/index.php/Category:Civilians</p>
 
<p>http://web.archive.org/web/20100401223556/http://www.herocopia.com/index.php/Category:The_City</p>
 
  
{{editMark
+
::Example:
|notes =
+
:::During the heyday of the creator developed message board, '''Bruiser's''', the identity and background of [[The Blue Knight]] caused  quite a flurry of activity.  Many commentators immediately noticed the visual hint of the Blue Knight's image reflected in car mirrors and darkened windows, strategically placed in a few of the panels featuring police officer Joshua Stone.  One poster even tried to elicit commentary by suggesting that not only was Joshua the Blue Knight, but he was also patrolling the streets of Astro City as [[The Street Angel]].
<b>STATUS!</b>
+
 
These are estimates, but currently about 30-40% of the actual old content, and 20-25% of the total pages have made the migration from the old siteYAY!
+
:Keep in mind, the goal is to provide a reference point, a basis for stating the speculation.
}}
+
 
 +
:Use footnotes if the reference is cumbersome and breaks the word flow of the main commentary.
 +
 
 +
 
 +
 
 +
* '''Try to avoid "passive voice" sentence structures.'''
 +
 
 +
:They are cumbersome and difficult to read with comprehension.  Unfortunately, this site is littered with examples. Please try not to add to the confusion-pollution. If you need help identifying "passive voice,"  this article [http://www.dailywritingtips.com/7-examples-of-passive-voice/] is concise and clearAnyway I liked it. You can also "google" for others.
 +
 
 +
:''Please use good judgement when editing "passive voice" passages. Not all of them are evil.''
  
== Constructing a Character Page ==
 
We've got templates.  Not very many, but for editing Characters, these work great.  They work for Heroes and Villains (the templates signed a neutrality clause) and for now, can even be used for Teams, Civilian pages and other miscellaneous stuff.  It might be a stretch to get them to work for City related pages, and until they have templates of their own, perhaps building a new City page can best be done by using an existing Landmark, Neighborhood, or other City page as a model.  Plans are in place to design special templates for these other page categories as time permits. But for now think of the character templates as being generic, and use them wherever you feel you can make them work for whatever content you are doing.
 
 
A Character Page is usually constructed using the following two Character templates.  In fact, for consistency across the Herocopia site, it is highly recommended to use them.  With practice, you will find them very helpful and much easier than building a Character page from scratch. 
 
  
*[[Template:Character infobox2]]
+
* '''Create and Use Tables!'''
*[[Template:Character page]]
 
  
Each template has several parameters (all optional) that can be filled in where appropriateIt will depend on the character, how much information is available from the stories, or if the information applies. Currently two of the best examples are the [[Silver Agent]] and [[Astra Furst]] pages.
+
:Please try to minimize creating a multitude of Herocopia pages for depositing tiny tidbits of information. Consider instead using a table or list on a single page.  The information will organize better that way, and will be a more pleasing reading experience for visitors to our siteIf you need help building tables, this page[http://www.mediawiki.org/wiki/Help:Tables] should prove useful.  You can also tug on my cape for questions.  I will work to answer then as time permits.
  
These two templates are also undergoing major editing work of their own, mainly cosmetic. But any future changes made to the templates, should not effect the outer mechanics of authors using them to construct pages. Another reason to stick with using these templates when building a character page.
+
:'''UPDATE:''' now that we are integrating more and more SemanticWiki queries into the pages of Herocopia, the best choice for containing tibits of data will be on the pages of ''Annotation Event Note Cards.''  We can use queries to extract out the information and let wiki derived a lot of our tables automatically.  Maintenance will be far easier, and the note cards provided direct context to the source of the data tidbits being referenced.
 +
 
  
See each templates' associated documentation section for more information.
 
  
{{editMark
+
* '''Other Stuff'''
|notes = '''UPDATE!''' Both the ''Character infobox2'' template  and the ''Character page'' template now includes detailed instructions for how to use them  effectively. Please click on their links for more details.
 
}}
 
  
 +
:The Herocopia Project encompassed within this wiki site is changing and maturing. There is still a LOT of stuff about the tools and structures of mediaWiki to learn and digest.  Changes will continue as we learn more. 
  
== General Editing Tools ==
+
:The general attitudes here are more lax than the main [[wikipedia:|Wikipedia]] site. Please help to keep them that way. I hate rules and fiefdoms.  
'''Herocopia.com''' is a MediaWiki website. Do you want to contribute, but do not know how to edit pages? These guides might be of help.
 
  
* [[Wikipedia:Category:Wikipedia style guidelines|Wikipedia's style guidelines]] - lots of good style tips here.
+
Thanks for your patience and understanding here.  
* [[Wikipedia:Category:Wikipedia how-to|How-to... in Wikipedia]]
 
* http://www.mediawiki.org/wiki/Help:Formatting - Formatting tips
 
  
 +
- '''The Information Broker'''
  
 
==  Quick tips for creating and editing pages ==
 
==  Quick tips for creating and editing pages ==
Line 106: Line 131:
  
 
* Check Special:Imagelist to see if the image you need already exists.
 
* Check Special:Imagelist to see if the image you need already exists.
 +
* If not, upload a new image here: http://www.herocopia.com/index.php/Special:Upload
 +
* Try to find clean images that are complete.  By that, I mean don't chop word balloons in half, don't make small images larger than their scanned size. In otherwords, use good visual editing skills when choosing images.
 +
* Except for covers from Vertigo.com, Don't pirate images from other sites, even if they source from Astro City  comics.  Scan them yourself. 
  
* If not, upload a new image here (400 pixels across is a good size for most images): http://www.herocopia.com/index.php/Special:Upload
+
* To use the image, place this tag into the page: <pre>[[Image:filename.jpg]]</pre>.
 
 
* Then place this tag into the page: <pre>[[Image:filename.jpg]]</pre>.
 
  
 
* To align the image to the right, use this tag: <pre>[[Image:filename.jpg|right]]</pre>.
 
* To align the image to the right, use this tag: <pre>[[Image:filename.jpg|right]]</pre>.
Line 118: Line 144:
  
 
* More image help: http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
 
* More image help: http://meta.wikimedia.org/wiki/Help:Images_and_other_uploaded_files
 +
 +
=== Pages that Need Help ===
 +
While you are always welcome to edit and add to any page(s) that catch your attention, the following pages have been marked as "stubs" and could use some help.
 +
 +
== Stubs List ==
 +
 +
{{#ask:[[stubs::yes]]
 +
| ?
 +
}}

Revision as of 09:47, 21 June 2016

Read on if you are interested in contributing content to the officially sanctioned website, dedicated to the award winning comic series Astro City.


New Users: Aid to Getting Started

Kurt Busiek, Brent Anderson, Alex Ross and Company have been creating new characters at a frantic pace. So frantic, Herocopia authors have been challenged to keep pace. Many of these new characters either are missing from Herocopia altogether, or they have what we call a stub-page, with little to no information provided. I have used some basic wiki query code, to build a stub list on your user talk pages. It is also included at the bottom of this page. You can use either of them to navigate directly to pages that are stubby in nature, or feel free to build a new page for characters not yet included.

As the Orbor Mystery continues to unfold, there are a dozen or so new (and old) characters that need entries built for them, or clean-up editing updates. A review of Astro City issues one, five, and six would be a good starting point for fleshing out more details about the Broken Man, Mister Cakewalk. Dame Progress, Lord Saampa, to name but a few.

- jb the ib -


There are four major areas (and a lot of little ones too) where Herocopia is always in need of help.

#1) Authoring Character Pages
We use templates for Characters and other things relating to Astro City. Assistance on how to use them can be found by clicking here.


#2) Building Event Note Cards for Events and Annotations
We are currently in a big push to build Event Annotation Note Cards. These too are template driven, and they are engineered to generate automatic timelines and appearance lists for just about everything related to Astro City.

More information on how you can help with this part of the Herocopia Project can be found by clicking here.


#3) Authoring Non-Character Pages
These are pages that relate to City infrastructure, places, neighborhoods, organizations and things beyond Astro City proper. They are built using Device templates.


#4) General Editing and Fact Checking
In addition, a lot of the longer running characters need updates, or attention, and some could use a touch of editing here and there to make them more readable. The Fact Checking usually requires going back to the source material and validating the information here on the Herocopia site. That means reading Astro City Comics. Rough work for sure, but someone has to do it.

Help information for general mediaWiki editing can be found further down on this very page.

General Editing Tools

Herocopia.com is a MediaWiki website. Do you want to contribute, but do not know how to edit pages? These guides might be of help.

Basic Guidelines pertaining to Herocopia

The intended audience for this website are the casual readers of Astro City Comics. It is a place for them to visit when they want additional information about the characters, places and events that occur between the covers of those publications.

With that in mind, here are some additional Guidelines for authors to consider.

  • Provide Context to your Writing
Trivia is great, that is a major aspect of what this site is all about. However, when appending it to Herocopia pages, try to provide context, so the information isn't just noise.
For example this isn't very useful to a casual reader:
Earliest Appearance: 1959, 1964 to general population of Earth
This on the other hand provides meaningful context that allows a Herocopia visitor to clearly understand the information being provided. Basically it has meaning and can be easily understood:
In 1959, Eliot Mills saw and reported this incident for a feature story that he hoped would be printed in the Astro City Rocket newspaper. It was massively edited before publication and the general public did not hear of Shirak until five years later.


  • [clarification needed]
Usually and in most cases, when "[clarification needed]" is sprinkled into the commentary, it is because some form of specific information is needed to provide context to the commentary. Follow the suggestion mention above and/or a combination of the following is also suggested as a possibility.
  1. An issue, page and panel reference if it is in story.
  2. If it is out of story, a reference or link to the outside source is helpful. The letters page perhaps, or a thread forum on the web (link provided if at all possible).
  3. If you are referencing a comment that one of the creators have stated, an exact quote is nice if possible, with a link if it is online.
  4. Bruisers, the message board run by John Rosell, is gone. Many of us long timers still have memories of commentary made there, but with it gone there is no link. But if you are referring to something from there, some kind of specific reference to it is helpful, provides context and backs up the comment.
Example:
During the heyday of the creator developed message board, Bruiser's, the identity and background of The Blue Knight caused quite a flurry of activity. Many commentators immediately noticed the visual hint of the Blue Knight's image reflected in car mirrors and darkened windows, strategically placed in a few of the panels featuring police officer Joshua Stone. One poster even tried to elicit commentary by suggesting that not only was Joshua the Blue Knight, but he was also patrolling the streets of Astro City as The Street Angel.
Keep in mind, the goal is to provide a reference point, a basis for stating the speculation.
Use footnotes if the reference is cumbersome and breaks the word flow of the main commentary.


  • Try to avoid "passive voice" sentence structures.
They are cumbersome and difficult to read with comprehension. Unfortunately, this site is littered with examples. Please try not to add to the confusion-pollution. If you need help identifying "passive voice," this article [1] is concise and clear. Anyway I liked it. You can also "google" for others.
Please use good judgement when editing "passive voice" passages. Not all of them are evil.


  • Create and Use Tables!
Please try to minimize creating a multitude of Herocopia pages for depositing tiny tidbits of information. Consider instead using a table or list on a single page. The information will organize better that way, and will be a more pleasing reading experience for visitors to our site. If you need help building tables, this page[2] should prove useful. You can also tug on my cape for questions. I will work to answer then as time permits.
UPDATE: now that we are integrating more and more SemanticWiki queries into the pages of Herocopia, the best choice for containing tibits of data will be on the pages of Annotation Event Note Cards. We can use queries to extract out the information and let wiki derived a lot of our tables automatically. Maintenance will be far easier, and the note cards provided direct context to the source of the data tidbits being referenced.


  • Other Stuff
The Herocopia Project encompassed within this wiki site is changing and maturing. There is still a LOT of stuff about the tools and structures of mediaWiki to learn and digest. Changes will continue as we learn more.
The general attitudes here are more lax than the main Wikipedia site. Please help to keep them that way. I hate rules and fiefdoms.

Thanks for your patience and understanding here.

- The Information Broker

Quick tips for creating and editing pages

Create a new page

  • Go to the two Character templates and copy the "syntax" portion from the template's documentation.
  • Then navigate to the page you want to create, i.e. to create a page for "Samaritan" enter
    http://www.herocopia.com/Samaritan
    in your browser.
  • Click the "edit" tab, paste the template code, and start creating!

Link to another page

  • Surround the word in double brackets...
    [[Samaritan]]
    ...and it will link to that page, whether it exists yet or not.

Linking Page to a Category

  • At the bottom of a page, enter
    [[Category: (category name)]]
    and it will link to that category, as well as include the page in that category (whether the category exists yet or not).
  • To create a link to a category *without* including the page in that category, add a colon in front, i.e.
    [[:Category: (category name)]]
    .


Image Uploading

  • Check Special:Imagelist to see if the image you need already exists.
  • If not, upload a new image here: http://www.herocopia.com/index.php/Special:Upload
  • Try to find clean images that are complete. By that, I mean don't chop word balloons in half, don't make small images larger than their scanned size. In otherwords, use good visual editing skills when choosing images.
  • Except for covers from Vertigo.com, Don't pirate images from other sites, even if they source from Astro City comics. Scan them yourself.
  • To use the image, place this tag into the page:
    [[Image:filename.jpg]]
    .
  • To align the image to the right, use this tag:
    [[Image:filename.jpg|right]]
    .
  • To place a thumbnail of a larger image, use:
    [[Image:filename.jpg|right|thumb|250px]]
    .
  • Any text entered in the tag that isn't recognized will appear as a caption in the thumbnail image, i.e.
    [[Image:filename.jpg|right|thumb|250px|This is a picture of Samaritan]]
    .

Pages that Need Help

While you are always welcome to edit and add to any page(s) that catch your attention, the following pages have been marked as "stubs" and could use some help.

Stubs List

A Little Knowledge, Adventures in Other Worlds, Aftermaths, Alien Spacecraft, An Avian Alliance, Antarean Kaleidojewel, Ar-mang, Arthur, Ashton Colt, Astro City Fire Department, Astro City No.10, Astro City No.2, Astro City No.29, Astro City No.3, Astro City No.30, Astro City No.31, Astro City No.32, Astro City No.33, Astro City No.34, Astro City No.35, Astro City No.36, Astro City No.4, Astro City No.5, Astro City No.6, Astro City No.7, Astro City No.8, Astro City No.9, Back Door Teleportation Spell, Mrs. Bannerjee, Battletoon, Beekeeper, Bob Cottonman, Breslow, Mr. Bridwell, Caleb Tarrant, Candlemen, Carlos Andriani, K.O. Carson, The Choirboys, Cleopatra (Original), Confession, Contrabandit, Council of Nike, Curator of Ashton Museum, Cyberwings, The Dark Age Book One: Brothers and Other Strangers, The Dark Age Book Two: Brothers in Arms, Delphi, Desiree, Dinner At Eight... further results