Difference between revisions of "Performing arts review submission"

From KDHX Production
Jump to: navigation, search
(→‎Getting started)
 
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
−
The Next KDHX.org website seeks to present theatre, film and music reviews in a beautiful manner that is also friendly to readers.  
+
==Overview==
 +
KDHX.org website seeks to present theater, film and music reviews in a beautiful manner that is also friendly to readers.  
  
−
We are striving for clean, consistent text and formating.  
+
:- Film reviews are located here: http://kdhx.org/film/film-reviews
 +
:- Theater reviews are located here: http://kdhx.org/arts/theater-reviews
 +
:- Music reviews are located here: http://kdhx.org/music/reviews
  
−
To achieve this, we are using AP Style as much as possible.
+
==Preparation==
 +
{{:Preparing text for pasting}}
  
−
Please review the KDHX AP Style guide for proper capitalization and other conventions. You should do your best to prep your text according to these conventions:  
+
==Logging in to KDHX.org==
 +
{{:Logging into KDHX.org}}
 +
'''These 2 short tutorials''' will walk you through the submission process.
 +
# [http://screencast.com/t/dI9C24leCH Tutorial #1]
 +
# [http://screencast.com/t/2xD9jYz5RIAh Tutorial #2]<br>
  
−
http://wiki.kdhx.org/wiki/Ap_style
+
==Getting started==
  
−
For best results, we recommend using Firefox or Chrome as your browser.
+
===Enter a good headline in the Title field===
 +
: [[Image:K2-add-item-top.jpg|border]]
  
−
If you do not know your user name or password, contact roy at kdhx dot org.
+
The KDHX website tries to use AP style headlines whenever possible.  
  
−
'''Log in to KDHX.org'''
+
Your headline should be approximately 6-12 words. If you can write a clever headline in less than 6 words, that's fine, but try not to go over 12 words.  
  
−
#Log in using the my Account button along the top right side of the homepage, just under the donate now button.
+
: '''Examples:'''
−
#Look at the top main menu on the site. Click on the section your review will be going in -- either Film (for movies) or Arts (for Theatre).
+
−
#Beneath the Arts news slider, click Add new Item to this category. The Page editor will then pop up.
+
−
#Select your category; make sure to select either Film Review or Theatre Arts Review not just the general category.
+
  
−
<br> '''Enter a good headline in the Title field'''  
+
:''- See it at the Rep, but 'You Can't Take It With You'''
 +
:''- Dozens of plays, freshly drawn and quartered''
 +
:''- Surprising testimony from Theatre Guild's 'Witness for the Prosecution'''
 +
:''- Contrived script sinks Flood Stage's 'Coupla White Chicks'''
 +
:''- 'Young Frankenstein' stalks and stumbles at the Fox''
 +
:''- Masters of puppets: Avenue Q entertains at the Fox Theatre''
 +
:''- St. Louis Shakespeare sails through 'The Tempest'''
  
−
The next KDHX website tries to use AP style headlines whenever possible.  
+
A good headline will be unique to the review itself. It should be snappy and clever, witty and intriguing. Ideally it should hint at a positive or negative review and it should also identify the play/musical or theater group in some fashion. Puns are good, so long as they aren't groan inducing.  
  
−
Your headline should be approximately 6-14 words. If you can write a clever headline in less than 6 words, that's fine, but try not to go over 14 words.  
+
:- Strong verbs make for excellent headlines.  
 +
:- Compose your headline before you begin the submission process. That way you can just copy and paste it in to the '''Title''' field.  
  
−
Examples:  
+
'''''Note:''' In headlines, composition titles, like play titles, go in single quotation marks ('). However, in text, composition titles go in double quotation marks (").''
  
−
See it at the Rep, but You Can't Take It With You Dozens of plays, freshly drawn and quartered Surprising testimony from Theatre Guild's Witness for the Prosecution Contrived script sinks Flood Stage's Coupla White Chicks Young Frankenstein stalks and stumbles at the Fox Masters of puppets: Avenue Q entertains at the Fox Theatre
+
===Title Alias===
 +
Leave this field blank. K2 will auto-generate the alias once the item is saved.
  
−
A good headline will be unique to the review itself. It should be snappy and clever, witty and intriguing. Ideally it should hint at a positive or negative review. Puns are good, so long as they aren't groan inducing.
+
===Tags===
  
−
Strong verbs make for excellent headlines.  
+
Add a few tags (keywords). Title of the play/film/music piece, name of the theater company, name of the director, genre, playwright, lead actor, etc. 4-6 tags are adequate.
  
−
Compose your headline before you begin the submission process. That way you can just copy and paste it in to the Title field.  
+
Be careful to spell your tags correctly. Use the drop down suggestions whenever possible.
  
−
Use standard AP style for headlines. Only capitalize the first word, unless the word is part of the title to the film or play or piece of music you are reviewing, or is part of a proper noun. For instance:
+
===Category===
  
−
See it at the Rep, but You Can't Take It With You
+
Make sure you choose the correct category (i.e., Film Reviews, Theater Review, etc.) from the drop down list.
  
−
Rep is capitalized because it is a proper noun (the name of the theatre). You Can't Take It With You is capitalized as such because it is the title of the play.
+
===Featured===
  
−
Leave the Title Alias blank
+
Leave "Featured" defaulted to '''No'''.
  
−
'''Tags'''
+
===Published===
  
−
Add a few tags (keywords). Title of the play/film/music piece, name of the theatre company, name of the director, genre, playwright, lead actor, etc. 4-6 tags are adequate.  
+
Click '''No''' for "Published."
  
−
'''Publishing state'''
+
----
  
−
For now, click No for published state. Leave "Featured" unchecked. Select the correct category (Film Reviews, Theatre Review, etc) from the drop down.
+
==Pasting your text into the Editor windows==
 +
{{:Pasting text into Editor}}
  
−
'''Pasting your text in the editor windows'''
+
Before pasting in, you should scrub your plain text using this tool: http://jhy.io/tools/convert-word-to-plain-text
 +
----
  
−
A few notes before we get started on this step.  
+
===Editor Content===
 +
: [[Image:Editor-window.jpg]]
  
−
Online publishing is tricky. If it were as simple as cutting and pasting from a formatted Word document, all of our lives would be easier. However, it quite simply is not that simple.  
+
====First Window====
 +
The '''first window''' is the intro paragraph or '''''lede'''''. The lede should be a snappy, engaging teaser to the rest of the article. It should make the reader want to read more. The lede should be short: under 30 words if possible.  
  
−
People have different browsers, different versions of Word, different operating systems, etc., all of which impact the way text behaves on the Web.  
+
Make sure you can see the '''WYSIWYG''' ''(What You See Is What You Get)'' toolbar above the editor windows.
 +
:[[Image:WYSIWYG.jpg]]<br>
 +
Do '''not''' paste text directly into these windows. Do '''not''' paste text using the W (Word) button.  
  
−
So, we have simplified the process as much as possible. Following these steps carefully will result in cleaner and more consistent copy in all articles, fewer headaches for you and far fewer headaches for your tireless editors.  
+
:* Copy the lede paragraph from your document.<br>
 +
:* Click on the '''Paste as plain text''' button in the toolbar.  
 +
:: [[Image:Plain-text-paste-icon.jpg|border]]<br>
 +
:* A window will pop up and you can paste in your lede paragraph. Click '''OK'''.<br>
  
−
The steps are not difficult, but it is vital that you do your best to follow them.  
+
====Second Window====
 +
Go down to the '''second window'''.
  
−
Tip: Format your Word document as single space text without indented paragraphs. Instead, just enter an extra return between paragraphs. If possible, turn off "curly quotes" or "smart quotes" in Word. Search your Word help for how to do this. There is no need to add italics to your Word document. You will add italics in the editor window.  
+
* Copy the rest of your review and again click the '''Paste as plain text''' button.
 +
* Paste your text into the pop up window and click '''OK'''.
  
−
The first window is the intro paragraph or lede. The lede should be a snappy, engaging teaser to the rest of the article. It should make the reader want to read more. Lede should be short: approximately 30-50 words.  
+
: '''''Note:''' The reason that you are pasting text in this way is to strip out all unnecessary code or artifacts from your text.''
  
−
Click on the Show/Hide Editor button. This will hide the WYSIWYG (What You See Is What You Get) toolbar. You must hide the WYSIWYG for this process to work.  
+
You should now see your text cleanly formatted. Note: You will not see any line breaks after you have pasted in. This is a limitation of the WYSIWYG preview.
 +
* If there are any extra line breaks between paragraphs, just delete them.
 +
* Do not add bold, italic or any other character formatting.
  
−
Copy the lede paragraph from your document. Paste it in this first window with the WYSIWYG hidden.  
+
====Adding Links====
 +
You can now add links to words or phrases within the text found in either of the Editor Content windows.
 +
* Highlight the linked word or phrase
 +
* Click on the link icon (example below) in the toolbar.
 +
:[[Image:LinkButton.jpg|border]]
  
−
Go down to the second window. Copy the rest of your review and paste in with the WYSIWYG hidden.
+
The '''Link''' window will display:<br>
 +
:[[Image:URLLinkWdw.png|275px]]
  
−
The reason you are pasting in this way is to strip out all unnecessary code or artifacts from your text.  
+
Add / paste the URL into the field labeled '''URL'''.
  
−
Now, to format your paragraphs properly copy this bit of code:  
+
:'''Important Information:'''
−
<pre>&lt;/p&gt;&lt;p&gt; </pre>
+
:* for '''External links''' make sure that the '''Protocol''' field contains "'''http://'''". If it does not, use the droplist to change it.
−
These are the html tags for paragraphs. Paste after the END of each paragraph. When you get to the final paragraph, remove the last
+
:* for '''Internal links''' (i.e., links leading back to KDHX.org,) please use the '''[http://kdhx.org/link-lookup-tool/ Reverse URL Lookup]'''. Once you have pasted the '''Reverse URL''' into the '''URL''' field of the '''Link''' window, make sure that the '''Protocol''' field contains "'''<other>'''."
  
−
<pre><p></pre>
+
No other formatting is required of the Editor Content text.
 +
----
  
−
only.
+
===Extra Fields===
 +
Click on the '''Extra Fields''' tab above the '''Editor Content''' window.  
  
−
Now click on show/hide again, and you will see the beautiful and clean preview of your text!
+
:[[Image:ExtraFieldsFilmRvw.png|600px|border]]
  
−
You may now add italics for play/film/symphony titles. Simply highlight the words you want to italicize and click the I button in the tool bar.  
+
# Add the name of the theater in the '''Venue''' field. If it is a movie, and is playing at several theaters in the St. Louis region, use "'''Various'''."
 +
# Add the '''URL''' for the theater whenever possible. Always use "'''http://'''" with the URL.  
 +
# If showing in several theaters;
 +
#* Click this link for '''[http://www.google.com/movies?q=&btnG=Search+Movies&hl=en&near=st+louis&ei=ajjUTLjhHdGbnwfCreHLBQ Google's Showtimes for St. Louis]''' page.
 +
#* Type the title of the film into '''Search Movies''', and click the search icon or hit enter.
 +
#* Use the URL to Google's response from your menu bar as the URL for "Various" theaters. This will take the viewer to a list of all showtimes in the area.)<br><br>
  
−
Do not add bold or other formatting.
+
::'''Popular St. Louis movie theater websites'''
 +
::- Tivoli: [http://www.landmarktheatres.com/market/st.louis/tivolitheatre.htm http://www.landmarktheatres.com/market/st.louis/tivolitheatre.htm]
 +
::- Plaza Frontenac: [http://www.landmarktheatres.com/market/St.Louis/PlazaFrontenacCinema.htm http://www.landmarktheatres.com/market/St.Louis/PlazaFrontenacCinema.htm]
 +
::- Webster Film Series: [http://www.webster.edu/filmseries http://www.webster.edu/filmseries]<br><br>
  
−
Do the same for links, if you want to add them. Just highlight the linked word or phrase, click on the link icon in the toolbar, and add a URL.
+
:4. The '''Open in''' field should remain set at '''Same Window'''.
 +
:5. Add the '''Director''' name, always double check for the correct spelling.
 +
:6. For '''Dates''', follow these conventions to indicate the opening and closing dates, whenever possible.<br>
 +
 +
::- '''Theater reviews''' ''- represent the opening and closing dates like this '''Oct. 1-10, 2010''', or if overlapping months '''Oct. 28-Nov. 7, 2014'''.''
  
−
That should be all the formatting you need.  
+
::- '''Film reviews''' ''- if only the opening date is known, use this format: '''Opens Sept. 15, 2010'''.''
 +
::: ''If the closing date is also known, use the format: '''Oct. 1-10, 2010''', or if overlapping months '''Oct. 28-Nov. 7, 2014'''.''
 +
::: ''If the performance or screening only takes place over one day, use this format: '''Sept. 15, 2010'''.''
  
−
We are no longer including "run dates" or theatre information at the end of the article. This information will be in the Extra Fields.
+
----
  
−
'''Fill out Extra Fields.'''
+
===Metadata Information===
 +
On the right of the '''K2 Add Item''' window, click the blue arrow by '''Metadata Information''' to reveal it.
  
−
Click on the Extra Fields tab above the first editor window.
+
: [[Image:MetadataWdwK2AddItem.png|border]]
  
−
Add the name of the theatre. If it is a movie, and is playing at various theatres in St. Louis, simply put Various.
+
* Copy your lede paragraph and paste it into the '''Description''' window.
 +
:- Remove any quotation marks.
 +
* For the '''Keywords''' field, type in the same words that you included in '''[http://wiki.kdhx.org/wiki/Performing_arts_review_submission#Tags Tags]''',  also adding '''your name,'''" '''the title of the film or play,'''" '''review,'''" "'''theater review'''" and/or "'''film review'''."
 +
:- Separate keywords by commas.
 +
* Leave the '''Robots''' and '''Author''' fields empty.
  
−
Add the URL for the theatre whenever possible. If Various, leave blank. Make sure you use http:// in your URL.
+
==Review your article==
 +
Click on the '''Content''' tab above the '''Content Editor''' windows and take some time to double check and proofread your article.  
  
−
Leave all Open in Same Window menus as they are.
+
If it all looks good, you may click '''Save''' at the top.  
  
−
Add the Director name. Double check the spelling.
+
The page will refresh and you must now click Close or the X in the upper right corner.
  
−
Add the Running Through date if you have it. If not, leave blank.  
+
Your editor will review the article, add an image to it and publish it on [http://www.kdhx.org KDHX.org.]
  
−
Ignore Website and Event Link for now.
+
: '''Important:'''
 +
: ''- email '''chuck at kdhx dot org''' that you have submitted a review; he will then review and publish.''
 +
: ''- if you run into any problems whatsoever with submitting your review, please contact '''kelly at kdhx dot org''' and she will help you out.''
  
−
'''Review your article'''
+
'''You're done!''' You may now '''log out'''.
−
 
+
[[Category:Websites]] [[Category:KDHX.org]]
−
Click on Content tab above the editor windows and take some time to double check and proofread your article. If it all looks good, you may click Save at the top. Your editor will review, add an image and publish on KDHX.org.
+
−
 
+
−
You're done! You may now log out.
+
−
 
+
−
'''Important: E-mail Chuck Lavazzi that you have submitted a review, so that he may review it and publish.'''
+

Latest revision as of 19:59, 29 January 2016

Overview

KDHX.org website seeks to present theater, film and music reviews in a beautiful manner that is also friendly to readers.

- Film reviews are located here: http://kdhx.org/film/film-reviews
- Theater reviews are located here: http://kdhx.org/arts/theater-reviews
- Music reviews are located here: http://kdhx.org/music/reviews

Preparation

Please review the Wiki page KDHX online writing style for tips on proper capitalization, punctuation and other conventions.

Logging in to KDHX.org

For best results, we recommend using Google Chrome as your browser.

If you do not know your username or password, contact kelly at kdhx dot org.

1. Log in using the My Account button along the top right side of the homepage, just under the "Donate Now" button.
KDHXlogin-button.jpg
2. Look at the menu labeled KDHX.org on the left side of your screen. Click on the appropriate section for your new article.
3. Near the top of the page, find and click the button Add a new item to this category.
KDHXAddNewItemBtn.jpg
The Page editor will then pop up.
4. Select the appropriate category or sub-category.
K2Category-TheatreRvws.jpg
5. You are now ready to begin adding content to the editor.

These 2 short tutorials will walk you through the submission process.

  1. Tutorial #1
  2. Tutorial #2

Getting started

Enter a good headline in the Title field

K2-add-item-top.jpg

The KDHX website tries to use AP style headlines whenever possible.

Your headline should be approximately 6-12 words. If you can write a clever headline in less than 6 words, that's fine, but try not to go over 12 words.

Examples:
- See it at the Rep, but 'You Can't Take It With You'
- Dozens of plays, freshly drawn and quartered
- Surprising testimony from Theatre Guild's 'Witness for the Prosecution'
- Contrived script sinks Flood Stage's 'Coupla White Chicks'
- 'Young Frankenstein' stalks and stumbles at the Fox
- Masters of puppets: Avenue Q entertains at the Fox Theatre
- St. Louis Shakespeare sails through 'The Tempest'

A good headline will be unique to the review itself. It should be snappy and clever, witty and intriguing. Ideally it should hint at a positive or negative review and it should also identify the play/musical or theater group in some fashion. Puns are good, so long as they aren't groan inducing.

- Strong verbs make for excellent headlines.
- Compose your headline before you begin the submission process. That way you can just copy and paste it in to the Title field.

Note: In headlines, composition titles, like play titles, go in single quotation marks ('). However, in text, composition titles go in double quotation marks (").

Title Alias

Leave this field blank. K2 will auto-generate the alias once the item is saved.

Tags

Add a few tags (keywords). Title of the play/film/music piece, name of the theater company, name of the director, genre, playwright, lead actor, etc. 4-6 tags are adequate.

Be careful to spell your tags correctly. Use the drop down suggestions whenever possible.

Category

Make sure you choose the correct category (i.e., Film Reviews, Theater Review, etc.) from the drop down list.

Featured

Leave "Featured" defaulted to No.

Published

Click No for "Published."

Pasting your text into the Editor windows

A few notes before we get started on this next step.

Online publishing is tricky. If it were as simple as cutting and pasting from a formatted Word document, all of our lives would be much easier. Unfortunately, it is not that simple.

People use different web browsers, different versions of Word, different operating systems, etc., all of which impact the way that text behaves on the Web.

Following these steps carefully will result in cleaner and more consistent copy in all articles, fewer headaches for you and fewer headaches for your tireless editors.

The steps are not difficult, but it is vital that you do your best to follow them.

Tip: The easiest and cleanest way to make a dash is to type the word, then a space, then two hyphens, then a space, then the next word. That will give you a nice clean dash.

AP style reminders:

- Only 1 space between sentences.
- Commas and periods ALWAYS go inside quotation marks.
- Do not indent paragraphs, instead enter an extra return between paragraphs.
- Turn off smart or "curly" quotes, or use this tool to clean up your text before pasting. jhy.io/tools/convert-word-to-plain-text
- Composition titles, like play titles, go in double quotation marks in text. Do not italicize such titles.
- Do not use the serial (Oxford) comma unless to avoid ambiguity. That's the final comma before the "and" in a series of items:
ex. "Hamlet," "Macbeth" and "The Tempest" are my three favorite plays.

Your text, before pasting it into the KDHX.org editor, should look essentially like this: Click for example

Before pasting in, you should scrub your plain text using this tool: http://jhy.io/tools/convert-word-to-plain-text

Editor Content

Editor-window.jpg

First Window

The first window is the intro paragraph or lede. The lede should be a snappy, engaging teaser to the rest of the article. It should make the reader want to read more. The lede should be short: under 30 words if possible.

Make sure you can see the WYSIWYG (What You See Is What You Get) toolbar above the editor windows.

WYSIWYG.jpg

Do not paste text directly into these windows. Do not paste text using the W (Word) button.

  • Copy the lede paragraph from your document.
  • Click on the Paste as plain text button in the toolbar.
Plain-text-paste-icon.jpg
  • A window will pop up and you can paste in your lede paragraph. Click OK.

Second Window

Go down to the second window.

  • Copy the rest of your review and again click the Paste as plain text button.
  • Paste your text into the pop up window and click OK.
Note: The reason that you are pasting text in this way is to strip out all unnecessary code or artifacts from your text.

You should now see your text cleanly formatted. Note: You will not see any line breaks after you have pasted in. This is a limitation of the WYSIWYG preview.

  • If there are any extra line breaks between paragraphs, just delete them.
  • Do not add bold, italic or any other character formatting.

Adding Links

You can now add links to words or phrases within the text found in either of the Editor Content windows.

  • Highlight the linked word or phrase
  • Click on the link icon (example below) in the toolbar.
LinkButton.jpg

The Link window will display:

URLLinkWdw.png

Add / paste the URL into the field labeled URL.

Important Information:
  • for External links make sure that the Protocol field contains "http://". If it does not, use the droplist to change it.
  • for Internal links (i.e., links leading back to KDHX.org,) please use the Reverse URL Lookup. Once you have pasted the Reverse URL into the URL field of the Link window, make sure that the Protocol field contains "<other>."

No other formatting is required of the Editor Content text.

Extra Fields

Click on the Extra Fields tab above the Editor Content window.

ExtraFieldsFilmRvw.png
  1. Add the name of the theater in the Venue field. If it is a movie, and is playing at several theaters in the St. Louis region, use "Various."
  2. Add the URL for the theater whenever possible. Always use "http://" with the URL.
  3. If showing in several theaters;
    • Click this link for Google's Showtimes for St. Louis page.
    • Type the title of the film into Search Movies, and click the search icon or hit enter.
    • Use the URL to Google's response from your menu bar as the URL for "Various" theaters. This will take the viewer to a list of all showtimes in the area.)

Popular St. Louis movie theater websites
- Tivoli: http://www.landmarktheatres.com/market/st.louis/tivolitheatre.htm
- Plaza Frontenac: http://www.landmarktheatres.com/market/St.Louis/PlazaFrontenacCinema.htm
- Webster Film Series: http://www.webster.edu/filmseries

4. The Open in field should remain set at Same Window.
5. Add the Director name, always double check for the correct spelling.
6. For Dates, follow these conventions to indicate the opening and closing dates, whenever possible.
- Theater reviews - represent the opening and closing dates like this Oct. 1-10, 2010, or if overlapping months Oct. 28-Nov. 7, 2014.
- Film reviews - if only the opening date is known, use this format: Opens Sept. 15, 2010.
If the closing date is also known, use the format: Oct. 1-10, 2010, or if overlapping months Oct. 28-Nov. 7, 2014.
If the performance or screening only takes place over one day, use this format: Sept. 15, 2010.

Metadata Information

On the right of the K2 Add Item window, click the blue arrow by Metadata Information to reveal it.

MetadataWdwK2AddItem.png
  • Copy your lede paragraph and paste it into the Description window.
- Remove any quotation marks.
  • For the Keywords field, type in the same words that you included in Tags, also adding your name," the title of the film or play," review," "theater review" and/or "film review."
- Separate keywords by commas.
  • Leave the Robots and Author fields empty.

Review your article

Click on the Content tab above the Content Editor windows and take some time to double check and proofread your article.

If it all looks good, you may click Save at the top.

The page will refresh and you must now click Close or the X in the upper right corner.

Your editor will review the article, add an image to it and publish it on KDHX.org.

Important:
- email chuck at kdhx dot org that you have submitted a review; he will then review and publish.
- if you run into any problems whatsoever with submitting your review, please contact kelly at kdhx dot org and she will help you out.

You're done! You may now log out.

Retrieved from "http://wiki.kdhx.org/index.php?title=Performing_arts_review_submission&oldid=6073"