Difference between revisions of "DPLs: How to Update the Magic Window"

From Librivox wiki
Jump to: navigation, search
(Created page with " =Accessing the System – First Time Login= # Use this Link to go the main login screen: http://librivox.org/workflow # Click on '''Login (for BCs & MCs)''' # Enter your foru...")
 
Line 1: Line 1:
 +
Thank you for committing to listen to an entire project as DPL (Dedicated Proof Listener)! Below are instructions on how to log into and update the Magic Window.
 +
 +
Please note, being a DPL means you'll need to keep an eye on the project, so you can download and give feedback on files reasonably quickly. If you're unable to do this for whatever reason (if you're away on holiday for a while, for instance, or if your life has just gotten too busy for this) it's NO problem at all, just let the BC (Book Coordinator) know.
  
 
=Accessing the System – First Time Login=
 
=Accessing the System – First Time Login=
Line 38: Line 41:
 
[[Image:MW_Wordcount.jpg]]
 
[[Image:MW_Wordcount.jpg]]
  
==Adding links to PL notes==
+
=Adding links to PL notes=
 
You may want to link directly to the post you made with the PL notes. This is helpful both to the reader and to the BC, so that they can easily access the PL notes for that section.
 
You may want to link directly to the post you made with the PL notes. This is helpful both to the reader and to the BC, so that they can easily access the PL notes for that section.
  
Line 46: Line 49:
 
# You'll need to get the URL of the post with the PL notes. Go to the forum post and right click the paper icon in the upper left corner of the post. Select "Cppy link location" from the popup menu.
 
# You'll need to get the URL of the post with the PL notes. Go to the forum post and right click the paper icon in the upper left corner of the post. Select "Cppy link location" from the popup menu.
  
# Now, between the quotation marks, paste in the URL to the post with the PL notes, e.g. <font color=red><tt><nowiki>https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en</nowiki></tt></font>
+
'''Example of post icon:'''
# So the whole thing reads: <font color=red><tt><nowiki><a href="https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en" target="_blank">Link to text</a></nowiki></tt></font>
+
[[Image:Postlink.jpg]]
 +
 
 +
# Now, between the quotation marks, paste in the URL to the post with the PL notes, e.g. <font color=red><tt><nowiki>https://forum.librivox.org/viewtopic.php?p=1795221#p1795221</nowiki></tt></font>
 +
# So the whole thing reads: <font color=red><tt><nowiki>PL notes <a href="https://forum.librivox.org/viewtopic.php?p=1795221#p1795221" target="_blank">HERE</a></nowiki></tt></font>
 
# Click the "Save" button.
 
# Click the "Save" button.
 
# Right click your new link to open in a new tab and make sure it works :)
 
# Right click your new link to open in a new tab and make sure it works :)
 
'''Example of admin:'''
 
[[Image:MW_Admin.jpg]]
 
 
=Signing up readers=
 
== Assigning and removing readers ==
 
As readers sign up, add them to the reader list.
 
 
# Click on the BC admin link under your MW.
 
# To assign a reader to a section, click the "'''Assign reader Sections'''" button above the table.
 
# Enter the first few letters of the reader's username and then select the correct reader from the dropdown list.  '''''You must select a reader from the dropdown.'''''  Please do not just type in a full username without choosing the reader from the list. 
 
# Enter the section number(s) that are to be assigned to the reader and then click Add.
 
# The reader assignment should appear in the reader column in the table and the status should change from Open to Assigned.
 
# To add more than one reader to a section, repeat the process above to add the additional reader(s).
 
# Optional: Record the date the reader has claimed the section in the Notes field - please use the word for the month as this will be less confusing for volunteers: something like "Claimed 03 June."  (Tip: leave in the word count and the text link, if you have one, until the reader actually submits the section.  If you have to orphan the section, all you have to do is remove the claim date!)  The claim date will be used to determine when sections should be put back in the pool if a reader doesn't submit their recording within the two-month guideline.
 
# To remove a reader from a section, simply repeat the process above, but click '''Remove''' rather than Add.
 
 
 
[[Image:MW_Add_Reader.jpg]]
 
 
== Adding a new reader to the dropdown list ==
 
'''If your reader is new to LibriVox''' and is not in the dropdown, you will need to add them to the reader list before you can assign them a section to read. 
 
# Click the "Add new reader" button.  A popup window will appear. 
 
# Enter the reader's forum username and catalog (display) name and a website if one has been provided. 
 
# Click Add Reader to add the new reader to the system.
 
# NOTE: If you get an error message that the email can't be found, contact your MC for help. 
 
# Once this is done, you can now assign sections to this reader as outlined above.
 
 
 
=Adding submitted files=
 
When they are submitting files, readers should provide the file location (a URL) and the file duration. The latter is important because your MC needs it during cataloguing to check the file hasn't been chopped off somewhere during the process.
 
 
==Adding file durations==
 
See 5.2 above.
 
 
==Adding link to uploaded file==
 
# Click in the Listen URL column and paste the link provided by the reader. 
 
# '''Hit Enter on your keyboard to Save.''' 
 
# NOTE:  Please be careful that the Listen URL does not include any extra spaces at the beginning or the end.  This will cause your MC a big headache during the cataloging process!! The best way to avoid these bad white space errors is to copy the link by right clicking on it and selecting copy link location. Then right click in the Listen URL column in the Section Compiler and choose paste.
 
# A link to the new file will appear in the Link column. 
 
  
 
==Changing the status of a section==
 
==Changing the status of a section==
Line 105: Line 71:
 
*'''Ready for spot PL''' – The reader has made the requested edits and the file is ready for the proof listener to spot check
 
*'''Ready for spot PL''' – The reader has made the requested edits and the file is ready for the proof listener to spot check
 
*'''PL OK''' – file is ready to catalog
 
*'''PL OK''' – file is ready to catalog
 +
As DPL, you will be interested most in the statuses Ready for PL, See PL Notes, Ready for Spot PL, and PL OK. You will change the status of a section to either '''See PL Notes''' or '''PL OK''', depending on whether the section needs correction.
  
 
Note: The section compiler rows will not change color. When you go back to the forum, Open sections will appear blue in the Magic Window and PL OK will be green. Ready for PL and Ready for Spot PL will have blue text, and See PL Notes will have red text.
 
Note: The section compiler rows will not change color. When you go back to the forum, Open sections will appear blue in the Magic Window and PL OK will be green. Ready for PL and Ready for Spot PL will have blue text, and See PL Notes will have red text.
 
=Special Instructions for Collections – Entering Section Metadata=
 
If you are the BC of a collection or compilation, when you enter each section, you will also need to add the author and source and language for each section to the section metadata. 
 
 
# Click on the icon in the Meta column next to the title. 
 
# This opens a new area at the top of the table where you will enter the Author, Text Source link and Language.
 
## To enter the author, click in the author field and type a few letters of the author's last name. Select the correct author from the dropdown list. (See notes below for special cases.)
 
###If you don’t know the author’s name, please choose “Unknown” from the author list. Use “Anonymous” if that is specified on the text. If the author is not a person, try entering the first few letters of the agency, company or organization to find it in the list. 
 
###''If the author you are trying to enter is not on the dropdown list, that means this author is not in the database yet. Please contact your MC to have the author added.'' If you have the author’s dates of birth and death and a Wikipedia link, please provide these to your MC along with the author’s full name and any known pseudonyms.
 
###If an author uses a pseudonym, and you can’t find it in the list, please try the author’s real name. Only the main entry shows on the dropdown list, but pseudonyms are searchable in the catalog. In this case, let your MC know so they can check to make sure the pseudonym is associated with the author’s entry in the database.
 
###If you have any other questions about authors (i.e. spelling seems incorrect, multiple authors, translators, etc.), please contact your MC.
 
##Copy and Paste the text link in the source field. If all the sections are from a common source (like a book of short stories or poems), just past the same link to the online text for the book in for all the sections. 
 
##Use the dropdown to change the language from the default if this is a multilingual collection.  ##''Do not make any entries in the Duration field or in the fields for the mp3 urls. These fields will be automatically filled in when your MC catalogs the project.'' 
 
##'''Click Add to save your entries.''' 
 
#Note:  the metadata will not display in the magic window. It is there so the information appears on the catalog pages and is searchable. If you want the author and text link to show in the magic window, you will need to enter these into the Notes field as well as in the metadata fields. Do not enter any of this in title field!!
 
 
=What if I need to change the number of rows in the table?=
 
#To add a section to the table, click the button "Add new section" at the top of the table. 
 
#You can fill in the title, reader and notes info and then click Add or you can just click Add to add a blank row. 
 
#The new section will appear at the bottom of the table.
 
#To move a row to a new location in the table, simply click in the row you want to move in the section numbers column and drag and drop the row where you want it in the table. 
 
#The rows will automatically be renumbered. 
 
#If you need rows deleted, please move them to the bottom of the table and then ask your MC to delete them.   
 
#Note:  the click and drag function may not work on tablet screens.
 
 
=Special Instructions for Dramatic Works=
 
#Set up the section compiler with a row for each role or character. (Some BCs find it easier to make rows for each scene/chapter each role is in. This adds a lot of rows to the MW, but it is easier to keep track of which scenes have been submitted.)
 
#Once editing begins and final acts or chapters are available, add a row to the section compiler for each finished section and put the title. Mark these sections as “Assigned” so they don’t show in the MW as open.
 
#Do not assign readers to the finished acts/chapters unless your MC instructs you to do this.
 
#You can leave these rows at the bottom of the table while the project is ongoing or move them to the top, whichever is more convenient. 
 
#The original rows with the individual roles will be deleted when the project is cataloged.
 
#If instructed by your MC, prepare the cast list to be added to the catalog description.  As an aid in doing this try out the [https://ia600309.us.archive.org/0/items/LibrivoxM4bCollectionAudiobooks/CastCoder.html Cast Coder], a nifty app for generating the code needed to add LibriVox Cast Listings to the catalog pages.
 
  
 
=Other Areas of the Workflow Tool=
 
=Other Areas of the Workflow Tool=
Line 187: Line 122:
  
 
=FAQ=
 
=FAQ=
==Are there rules about how we must enter information in the "Notes" fields?==
+
==Is there a way to tell which existing projects are looking for a DPL?==
You can enter information in the "notes" fields in whatever format is most efficient for you. There's no real standard; just try to keep everything as clear and comprehensible as possible for you, your readers, and your proof-listeners.
+
There are three ways to find projects that need a DPL:
 
+
# Some projects advertise their need for a DPL in the [https://forum.librivox.org/viewforum.php?f=21 Listeners & Editors Wanted] forum. These threads will be "stickied" to the top of the forum list.
==What do I do if I have a work which is divided into several "books", each with subdivisions, e.g. "Book Two, Chapter Four, Part Three"?==
+
# Also, the titles of the project threads that have a tilde ~ at the beginning of them do not have a DPL.  
When you first enter the project, total up how many files you will have. Enter this number in the "Number of Sections" field (this usually corresponds to the eventual "track number") in the Template Generator. Then type out the names of all the sections into the "Title" fields so your readers know exactly what sections they're signing up for. (See 5.2 above.)
+
# Tired of sifting through the threads looking for projects to PL? You can see a listing of active projects without an assigned DPL on the [[Project Status Table]] wiki page.
 +
You can also volunteer for New Projects as they appear in the [http://librivox.org/forum/viewforum.php?f=28 New Projects Launch Pad] forum. Post directly in the project thread there and ask the BC or soloist if you can be the DPL.
  
 
==Can I see a list of all the projects I'm working on?==
 
==Can I see a list of all the projects I'm working on?==

Revision as of 13:51, 21 October 2020

Thank you for committing to listen to an entire project as DPL (Dedicated Proof Listener)! Below are instructions on how to log into and update the Magic Window.

Please note, being a DPL means you'll need to keep an eye on the project, so you can download and give feedback on files reasonably quickly. If you're unable to do this for whatever reason (if you're away on holiday for a while, for instance, or if your life has just gotten too busy for this) it's NO problem at all, just let the BC (Book Coordinator) know.

Accessing the System – First Time Login

  1. Use this Link to go the main login screen: http://librivox.org/workflow
  2. Click on Login (for BCs & MCs)
  3. Enter your forum username.
  4. Click “Forgot Password” (Note: Your forum password will not work here!!)
  5. You will receive an email with a link to reset your password. Click the link and enter a password and submit the form. TIP: if you use the same password as your forum password, you'll only have the one to remember.
  6. Go back to the main login screen and use the new password you entered above to log in to the system.
  7. When you log in from the main screen above, you will be taken to the LibriVox Management Dashboard default screen where you should see a list of your active projects along with options for dropdown menus, searching and editing your profile. (more on this later)

For more explicit step by step directions with screen shots, please see Accessing the System - First Time Login

NOTE: If a DPL is also a reader, they should use their personal workflow login to upload files. If you recently logged in with the general login to upload files to a project and the system still had you logged in, you may see this:

You don't have permissions for this area.

Return to Librivox Management Tool Homepage

Logout

To remedy this, click Logout and then login with your BC/DPL login and password.

Changing your Workflow Password after your first login – Editing "My Profile"

  1. Click on the My Profile link at the upper right of the screen.
  2. You will see a popup that shows your username, catalog display name and your personal website if you provided one, as well as the option to change your password. If you wish to change your password (we recommend using the same one as your forum login for simplicity), enter it in the Password field and again in the Confirm Password field and then click Save Changes.
  3. If you have forgotten your password and can’t login to the system, follow the instructions under the First Time Login to reset your password.

Login from the Forum (after first time login!)

Click the BC admin link under the Magic Window for the project

  1. You will not see the main screen, but will be taken directly to the login screen
  2. Login with your username and password (see above)
  3. You will be taken to the Section Compiler screen for your project where you can update and or edit the information that appears in the Magic Window.


Example of a Magic Window: MW Wordcount.jpg

Adding links to PL notes

You may want to link directly to the post you made with the PL notes. This is helpful both to the reader and to the BC, so that they can easily access the PL notes for that section.

  1. Click in the "Notes" field.
  2. Paste in this code: PL notes <a href="" target="_blank">HERE</a>
  3. Click Save before leaving the field, or you'll lose your work!
  4. You'll need to get the URL of the post with the PL notes. Go to the forum post and right click the paper icon in the upper left corner of the post. Select "Cppy link location" from the popup menu.

Example of post icon: Postlink.jpg

  1. Now, between the quotation marks, paste in the URL to the post with the PL notes, e.g. https://forum.librivox.org/viewtopic.php?p=1795221#p1795221
  2. So the whole thing reads: PL notes <a href="https://forum.librivox.org/viewtopic.php?p=1795221#p1795221" target="_blank">HERE</a>
  3. Click the "Save" button.
  4. Right click your new link to open in a new tab and make sure it works :)

Changing the status of a section

This is a new feature which eliminates the need to type “PL Needed” and “PL OK” etc in the Notes field. This information will now show in the last column of the new MW.

  1. To change the status of a section, click in the status column. Use the down arrow to expand the list and then click on the appropriate status.

(Alternate method: Click once to expand the list, then type the first letter of the status (i.e., P for PL OK) and hit enter to save.)

How to use the new status designations:

  • Open - no reader assigned
  • Assigned – section assigned to a reader
  • Ready for PL – file uploaded by the reader and ready for proof listening
  • See PL Notes – proof listener has listened to the file and posted edits for the reader
  • Ready for spot PL – The reader has made the requested edits and the file is ready for the proof listener to spot check
  • PL OK – file is ready to catalog

As DPL, you will be interested most in the statuses Ready for PL, See PL Notes, Ready for Spot PL, and PL OK. You will change the status of a section to either See PL Notes or PL OK, depending on whether the section needs correction.

Note: The section compiler rows will not change color. When you go back to the forum, Open sections will appear blue in the Magic Window and PL OK will be green. Ready for PL and Ready for Spot PL will have blue text, and See PL Notes will have red text.

Other Areas of the Workflow Tool

Note: If you click on a link that is an MC only area, you will get a page that says you do not have permission for that page. There are links to go back to the main workflow page or logout. To go back to the previous page just use the back button in your browser.

Projects Menu - My Projects

  • Shows all projects where you are BC, DPL or reader
  • Default view shows only currently active projects
  • View all your projects by clicking the radio button next to Show all Projects.
  • Table can be sorted ascending or descending by any title, author, status or role in the project, by clicking in the header field for any of the columns. For example, to bring all your BC projects to the top of the table, click twice in the "as BC" column header.
  • Refine your search to find a specific project by entering a search term in the box on the left above the table
  • Adjust the number of entries displayed per page using the dropdown on the right
  • Navigate to the section compiler for a project by clicking on the icon in the SC column
  • Go to the project forum thread via the link in the Forum URL column
  • For completed projects, the catalog URL link will take you to the catalog page
  • Project ID links are for MC use only. If you click on one, you will get a message that you don't have permission to view that page. Use the back button to return to the previous page.

Stats Menu

  • My Sections - Shows all the open projects for which you are a reader or DPL. It is equivalent to the top section of your catalog page in the old system, but with a lot more detail. A public view of this table will also be available from the catalog
    • Reader View – shows sections you have claimed sorted into columns by the section status
    • PL View - shows all the projects where you are DPL with sections that have statuses of Ready for PL, See PL Notes, Ready for Spot check and PL OK.
  • Monthly stats are the number of projects catalog by month and by year
  • General stats - number of projects, completed projects, etc.
  • Chapter Counts - pending
  • Project Status Table - Admin access only

Section Compiler Opens a search form to let you search for a project by its project ID number, title or status. Clicking on the links in the list of hits and will take you directly to the section compiler if it's one of your projects.

People Menu Links to lists of volunteers.

  • Show BCs gives a list of all BCs
  • Show MCs likewise shows the list of MCs
  • Show Active Readers shows a list of all the people who have been added to the list of readers
  • Show all users is a list of everyone registered on the forum and includes active readers and nonreaders

Links Menu A list of useful links

Help Will have links to this and other help files

Search by Project ID, Title, Author enter project ID or words from title or author name and click Go to search

Search by Reader/User searches the reader and user lists

FAQ

Is there a way to tell which existing projects are looking for a DPL?

There are three ways to find projects that need a DPL:

  1. Some projects advertise their need for a DPL in the Listeners & Editors Wanted forum. These threads will be "stickied" to the top of the forum list.
  2. Also, the titles of the project threads that have a tilde ~ at the beginning of them do not have a DPL.
  3. Tired of sifting through the threads looking for projects to PL? You can see a listing of active projects without an assigned DPL on the Project Status Table wiki page.

You can also volunteer for New Projects as they appear in the New Projects Launch Pad forum. Post directly in the project thread there and ask the BC or soloist if you can be the DPL.

Can I see a list of all the projects I'm working on?

Yup! Go to the "Projects" drop down and select "My Projects."

(Have a question? Need clarification? Think something should be added to this page? Found a bug in the system? Have a feature request? Contact your MC or post in the forum.)