BC's: How to update the Magic Window: Difference between revisions

From Librivox wiki
Jump to navigationJump to search
← Older edit
Content deleted Content added
LordOider (talk | contribs)
94 edits
Update instructions for adding authors - pseudonyms are included in the drop-down, and the search is more flexible.
 
(43 intermediate revisions by 8 users not shown)
Line 1: Line 1:
:<i>This page is also available in: [[Coordinadores de Libros: Como actualizar la Ventanita Mágica|Spanish]] / Esta página tambien existe en [[Coordinadores de Libros: Como actualizar la Ventanita Mágica|español]]</i>


=Creating a new group project=
=Creating a new group project=
--> See: [[How To Become A Book Coordinator#What does a book coordinator do?|What does a book coordinator do?]]
# Go to http://librivox.karenrsavage.com/lv/ and fill in the form, then copy the code it spits out. Or, the old fashioned way: go to [[Project Templates for BCs]] and copy the template for collaborative projects there (please note that these templates are regularly updated with the latest LibriVox procedures, so it's a good idea to copy any subsequent project templates from here, too, rather than copy your old projects).
# Post the template as a New Topic in the '''NEW PROJECTS LAUNCH PAD''' forum (add your project details in the relevant places first). Paste in the code from the template form, or fill out all the missing bits in the template. Be sure to check it over and change anything that needs changing (such as symbols in the file name, etc.)
# Wait for an MC to come along and claim your project. The MC will enter the details into the system and replace the placeholder text in number 5. of your current first post. As if by magic, the list of sections and readers will appear! From then on, volunteers can sign up for your project.
# Your MC will move your project thread to the appropriate Readers Wanted or Solo forum and will also give you the URL and login info for the new BC admin system. From there, you can sign up readers, post links to completed sections so they can be proof-listened, etc.


=Accessing the System – First Time Login=
=Basics about using the BC admin=
# Use this Link to go the main login screen: http://librivox.org/workflow
# To make things easy for you, you'll see there's a tiny link to the BC admin right underneath the reader list in the first post of your project: [[Image:Bc_admin.jpg]]
# Click on '''Login (for BCs & MCs)'''. If you are presented with "'''You don't have permissions for this area.'''", then click '''Logout''' and try again.
# When you get to the BC admin, you'll see your project's reader list. The reader list has two views: (a) the 'reader' view (where you enter readers) and (b) the 'sections/chapters' view (where you mark sections complete, etc). You can get from one to the other by changing the sort order - there is a link just above the list:
# Enter your forum username.
[[Image:SortReader.jpg]]
# Click “Forgot Password” (Note: Your forum password will not work here!!)
# You will receive an email with a link to reset your password. Click the link and enter a password and submit the form.
# Go back to the main login screen and use the new password you entered above to log in to the system.
# 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 https://librivox.org/uploads/xx-nonproject/Firsttimeaccessing_workflowsystem.pdf
=Preparing the Magic Window for reader claims=

== Adding chapter/section titles to the reader list ==
NOTE: BCs 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 login and password.

=Changing your Workflow Password after your first login – Editing "My Profile"=
# Click on the My Profile link at the upper right of the screen.
# 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.
# 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 your project'''
# You will not see the main screen, but will be taken directly to the login screen
# Login with your username and password (see above)
# 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.

=Editing the Magic Window from the Section Compiler Screen: Preparing the Magic Window for reader claims=

There's a video showing basic actions in the Section Compiler, [https://www.youtube.com/watch?v=nOP4tcr1kl8 on Youtube].

== Entering titles into the Section Compiler ==


Often a book will have chapter titles. It's good to include these in your reader list so your readers know EXACTLY which sections they're signing up for. Give plenty of specific information to avoid confusion!
Often a book will have chapter titles. It's good to include these in your reader list so your readers know EXACTLY which sections they're signing up for. Give plenty of specific information to avoid confusion!


Also, MCs can now import the titles for cataloguing. Therefore, enter the titles as you'd like them to appear later. This means that they have to be sortable. Usually, we achieve that by putting the section in front of the chapter title, e.g. "00 - Preface" and "01 - The Red Carpet" etc. However, if the chapters are just called 'Chapter 1,' 'Chapter 2' etc, you can put in the title field "Chapter 01" and "Chapter 02-03" (note that it has to be Chapter not Chapters all the way through, and that you need the leading zeros to make it sort correctly later).
Also, titles in the Magic Window will be used during cataloging and added to files as ID3 tags. Therefore, enter the titles as you'd like them to appear later, remembering that the section number will be automatically added to the beginning of each title. This will make the files sortable. So a title entered as "Chapter I" in the MW will be given an ID3 title tag of "01 - Chapter I" during the cataloging process. To add titles:


# Go to your BC admin.
# Click on the BC admin link under your MW.
# Click in a "Title" field. Type (or paste) the chapter/section name. '''NEW: Do not add the section number! The new system will add these automatically during cataloging.'''
# Click "Sort by sections/chapters" (see section 2. "Basics on using the BC admin" above).
# Hit '''"return/enter"''' on your keyboard to '''save''' the title.
# Click "edit" in a "Title" field. Type (or paste) the chapter/section name.
# Continue adding titles for all the sections in the same manner.
# Hit "return/enter" on your keyboard to save the title.
# '''Important:''' The title column should only include plain text for the chapter title - no text formatting or links! You may include the section author's name here, if it is NOT a collection and the section is written by someone other than the primary author (e.g., a translator's introduction to a book, a short story in a magazine, or a song in a hymnal). If you need other information (such as links or reader instructions) to show in the magic window, please enter it in the Notes column.
# NOTE: Occasionally you find that once a project has been going for a little while, that you need to split a chapter into two sections. Should this happen, please ask your MC to make another section for you. Each section should only contain one file in the end. This only works in solo projects, or fairly early on in group projects (otherwise it'll lead to confusion).
# If this is a non-English project, enter the titles with the proper accents or non-English characters.
'''Do not include the following characters in section titles (or ID3 tags)
" ; / & > or <'''


'''Example of a Magic Window:'''
'''Example of a Magic Window:'''
[[Image:Mw_example.jpg]]
[[Image:MW_Example.jpg]]


== Adding the sections' word count ==
== Adding Word Counts, Text Links or PL Notes ==
It is very helpful if you enter each section's word count in the Notes field. This will enable readers to choose better which sections they can manage in the time they have available. Above the Magic Window, there is a sentence explaining the word count: "Forum discussions have shown that average reading speed is approx. 2000 words in 15 minutes."
It is very helpful if you enter each section's word count in the Notes field. This will enable readers to choose better which sections they can manage in the time they have available. Forum discussions have shown that average reading speed is approx. 2000 words in 15 minutes. How to count the words, see: [[Word Count]]


# Click inside the notes column to add word counts, text links, file durations or other notes. This field can contain html as well as simple text.
How to count the words, see: [[Word Count]]
# Click Save to save your edits.

''Note: You '''must''' click Save before leaving the field in order to save the information. If you switch to a new field or new window without clicking Save, you will lose your work.''
# Go to your BC admin.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click the "Edit" link for a section's Notes field.
# Enter "Word count: xxxx" or similar (you can round the number)
# Click the "save" button.
# Repeat 3.-5. for all sections.


'''Example of a Magic Window:'''
'''Example of a Magic Window:'''
[[Image:mw_wordcount.jpg]]
[[Image:MW_Wordcount.jpg]]


== Adding links to text sections ==
==Adding links to text sections==
Sometimes you may want to divide a very long chapter up into smaller sections (most readers prefer sections no longer than 4000 words, i.e. ~30 minutes' reading time). You can give your readers links to those sections (use Google docs or similar to host the text portions). This is also helpful when the sections are not clear-cut, e.g.when there are no chapters.
Sometimes you may want to divide a very long chapter up into smaller sections (most readers prefer sections no longer than 4000 words, i.e. ~30 minutes' reading time). You can give your readers links to those sections (use Google docs or similar to host the text portions). This is also helpful when the sections are not clear-cut, e.g. when there are no chapters.


# Go to your BC admin.
# Click in the "Notes" field.
# Paste in this code: <font color=red><tt><a href="">Link to text</a></tt></font>
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click the "Edit" link for a section's Notes field.
# Click Save before leaving the field, or you'll lose your work!
# Paste in this code: <font color=red><tt><a href="" target=new>Link to text</a></tt></font>
# Now, between the quotation marks, paste in the URL to the text, e.g. <font color=red><tt><nowiki>https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en</nowiki></tt></font>
# Now, between the quotation marks, paste in the URL to the text, e.g. <font color=red><tt><nowiki>https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en</nowiki></tt></font>
# So the whole thing reads: <font color=red><tt><nowiki><a href="https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en" target=new>Link to text</a></nowiki></tt></font>
# So the whole thing reads: <font color=red><tt><nowiki><a href="https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en">Link to text</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 :)
# Click the "View public list" link.
# Click your new link to make sure it works :)


'''Example of admin:'''
'''Example of admin:'''
[[Image:mw_admin.jpg]]
[[Image:MW_Admin.jpg]]

'''Example of a Magic Window:'''
[[Image:mw_full.jpg]]


=Signing up readers=
=Signing up readers=
== Assigning and removing readers ==
== Adding readers new to your project ==
As readers sign up, add them to the reader list.
As readers sign up, add them to the reader list.


# Go to your BC admin.
# 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.
# Sort by Readers (see section 2. "Basics on using the BC admin" above).
# 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.
# '''If your reader is new to LibriVox''' and has given you his/her catalog name, please scroll down to the very bottom of the page and add the reader to the database (copy and paste the forum name, catalog name, and URL (make sure URLs begin with "http://" and end with a slash "/"), using these fields - ignore the comment about the "dropdown": [[Image:mw_newperson.png]]
# To assign a section or chapter to a reader, look for this line: [[Image:mw_assign.jpg]]
# 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.
# Type in the section/chapter number(s) and copy and paste the reader's forum name. (If the reader has not yet been entered in the system, a new page will load with a message something like "This reader has not previously been assigned a section. Someone may want to enter his/her catalog name." Click your browser's Back button to return to the admin.) Then click the "Add Reader" button. The system automatically goes to "Currently sorting by readers" view. [[Image:Mw_addsection.jpg]]
# To add more than one reader to a section, repeat the process above to add the additional reader(s).
# Unless you know for sure that the reader has read sections for LibriVox before, please check if the reader's catalog name is already in the database. To do this, click the bottom item in the yellow menu in the top right of the screen: "Readers' Catalog Info." You'll see a list of all readers who have claimed sections in your project. If the reader's catalog name is not yet listed, please contact the reader (by PM, or by posting in the forum), asking under which name or pseudonym they'd like to appear in the LibriVox catalog. We can also link to a personal web site/blog.
# Click the "Sort by Sections/Chapters" link and 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 (in Europe and America, month and day are reversed so 7/8/10 could be in August or in July): 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 guidelines. All Notes entered in the Sections/Chapters view are public (they will be visible to everyone in the Magic Window in your first post of your project), whereas the Readers view notes are private (only visible to the BC). - See also section on 'Making notes about your communications with readers' below
# 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.


'''Example of a Magic Window:'''
[[Image:mw_filled.jpg]]


[[Image:MW_Add_Reader.jpg]]
==Adding readers who have already claimed a section of the project==

Sometimes readers come back for more.
== Adding a new reader to the dropdown list ==
# Go to your BC admin.
'''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.
# Sort by Readers (see section 2. "Basics on using the BC admin" above).
# Look for the reader in the list.
# 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 on 'Edit' next to the existing section/s the reader has claimed.
# Add the new section/s, separating them with commas.
# 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.
# Hit return/enter to save. Everything will be updated and the reader should show up as having claimed the new section/s.
# Once this is done, you can now assign sections to this reader as outlined above.
# Click the "Sort by Sections/Chapters" link and record the date the reader has claimed the section in the Notes field (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!). This date will be used to determine when sections should be orphaned if a reader doesn't submit their recording within the new two month guidelines. Notes in the Sections/Chapters view are public (they will be visible to everyone in the table in your first post of your project), whereas the Readers view notes are private (only visible to the BC). - See also section on 'Making notes about your communications with readers' below


'''Example of a Magic Window:'''
[[Image:mw_filled.jpg]]


=Adding submitted files=
=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.
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.
==Noting down the file duration and "PL needed"==
# Go to your BC admin.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click "Edit" in the 'Notes' field of the section for which you've received a file.
## If you wish, you can delete the claim date and the word count now. Leave the text link if you have provided one (your PLer may wish to use it).
## Enter the file duration in the format mm:ss.
## Enter "PL needed" so your PLer(s) know the section is ready to be downloaded for proof-listening. To make this stand out more so it's easier to spot, we like to enter it in red and bold. Copy and paste this code to do this: <font color=red><tt><nowiki><font color=red><b>PL needed</b></font></nowiki></tt></font>[[Image:mw_plneeded.jpg]]
# Click the "save" button. See c. Marking sections 'Complete' to see how this same section will look in the Magic Window.


==Entering the file location==
==Adding file durations==
See 5.2 above.
# Go to your BC admin.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click "Edit" in the 'Listen URL' field of the section for which you've received a file. Copy and paste the full URL. In the Magic Window, this URL will automatically appear as a clickable "Listen!" link.
# Hit return/enter to save.
# Make sure the URL is correct (that it follows your filename scheme). If it isn't, PM your MC and ask her/him to correct it for you in the Uploader admin. When it's done, change the URL to the correct one in the admin as in 1.-4. above.
# See c. Marking sections 'Complete' to see how this same section will look in the Magic Window.


==Adding link to uploaded file==
==Marking sections 'Complete'==
# Click in the Listen URL column and paste the link provided by the reader.
Once a reader has completed a section, you'll mark it 'complete.'
# Go to your BC admin.
# '''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.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# A link to the new file will appear in the Link column.
# Click the "Complete" checkbox(es) for the completed section(s). The colour of the section will change to green. In the Magic Window, the "Status" column will change from 'available' to 'complete' and the colour will change there, too.
[[Image:mw_sectioncomplete.jpg]]


==Changing the status of a section==
OR:
This information will show in the last column of the MW.
# Sort by Readers (see section 2. "Basics on using the BC admin" above).
# Click the "edit" link in the "Completed" column.
# Enter the number(s) of the completed section(s).
# Hit return/enter on your keyboard to save.


# 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.
=Adding PL notes=
As your proof-listeners report back, add their findings to the "Notes" field (if they are DPLs, they can do so themselves as they will have Admin access).


(Alternate method: Click once in the status column, then type the first letter of the desired status (i.e., R for Ready for PL, P for PL OK) and hit enter to save.)
# Go to your BC admin.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click "Edit" in the "Notes" field for the chapter you wish to notate.
## If the file is good to go, change "PL needed" if you had it there before, to "PL OK:" or just "OK." If your "PL needed" was red, you now want to change the colour to green by using this code: <font color=red><tt><nowiki><font color="green"><b>PL OK</b></font></nowiki></tt></font>
## If the file has PL notes, change "PL needed" if you had it there before, to "PL notes" and add notes, such as "Repeat @ 14:32" or "too soft" or "Funny background noise through entire file" or "OK to catalog". You can achieve line breaks with this code: <font color=red><tt><nowiki><br/></nowiki></tt></font>. See screenshot below. <br/>-- Or simply refer to the page of the project thread where the PL notes for this section were posted. The code for this: <font color=red><tt><nowiki><font color="red"><b>PL notes (see p.x)</b></font> mm:ss</nowiki></tt></font> (replace 'x' with page number; mm:ss should already be there as the file duration). <br/>-- The most elegant solution is to link to the post where the PL notes have been posted in the forum thread. The code: <font color=red><tt><nowiki><font color="red"><b>PL needed, see <a href="URL for forum post" target=new><u>PL notes</u></a>)</b></font> mm:ss</nowiki></tt></font> (replace URL for forum post with the URL but leave the quotation marks around it!)
## See below for examples of code and how this will look in the Magic Window.
## Make sure you leave the file duration in the Note.
# Click the "save" button.


'''Example of admin:'''
'''The status designations:'''
*'''Open''' - no reader assigned
[[Image:mw_admin2.jpg]]
*'''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


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.
'''The sections above in the Magic Window:'''
[[Image:Mw_admin3.jpg]]


=Special Instructions for Collections – Entering Section Metadata=
=Marking a Section Edited=
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.
Once the PL notes are back, if the section is not OK, the reader will edit the file. They should re-upload the edited file with the same name as before, so you shouldn't have to change the Listen URL (make sure the URL is correct, though). They should also note the new, post-edit, file duration.


# Click on the icon in the Meta column next to the title.
You will need to change the Notes field. (Ideally, the PLer will double-check that the required changes have been made.)
# 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 there are too many authors with the same last name, you can narrow down your search by adding a comma, then the author's first name (for example: "Smith, Harriet"). You can also search by a name in the "proper" order, but authors with a middle name or initial (e.g. "Samuel L. Clemens") may not show up if you do not include that in your search.
###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 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?=
# Go to your BC admin.
#To add a section to the table, click the button "Add new section" at the top of the table.
# Sort by Sections/Chapters (see section 2. "Basics on using the BC admin" above).
# Click "Edit" in the "Notes" field for the chapter you wish to notate.
#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.
** If the file is good to go, change "PL note" if you had it there before, to "PL OK (edited)" or just "OK (edited)" - it's advisable to note that a file is edited so there's no confusion about the status. If your "PL notes" or similar was red, you now want to change the colour to green by using this code: <font color=red><tt><nowiki><font color="green"><b>PL OK (edited)</b></font></nowiki></tt></font>
#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.
** See the images above about editing the Notes field.
#The rows will automatically be renumbered.
# Change the file duration to the post-edit duration.
#If you need rows deleted, please move them to the bottom of the table and then ask your MC to delete them.
# Click the "save" button.
#Note: the click and drag function may not work on tablet screens.


=Special Instructions for Dramatic Works=
=Making notes about your communication with readers=
#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.)
Sometimes you may contact one or several readers via PM or email - for instance, to tell them that the project has moved to Readers Found, or to ask them for an update about their sections. You may wish to note down the date/the particulars of your correspondence. These sorts of note are typically just admin notes that need not be public. You can add private notes like this:
#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.
# Go to your BC admin.
#Do not assign readers to the finished acts/chapters unless your MC instructs you to do this.
# Sort by Readers (see section 2. "Basics on using the BC admin" above).
#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.
# Click the "Edit" link in the "Notes" field for a section.
#The original rows with the individual roles will be deleted when the project is cataloged.
# Type in your note - anything you like. Remember that this is not visible to anyone but you and your MC.
#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.
# Hit "return" on your keyboard to save.


=Other Areas of the Workflow Tool=
'''Example of admin:'''
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.
[[Image:Mw_readersnotes.jpg]]

'''Projects Menu - My Projects'''
*Shows all projects where you are BC, DPL or reader
*Default view shows all projects (complete and active)
*View only your active projects by clicking the radio button next to Show Only Active 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.

'''Projects 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.

'''Projects Menu - 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

'''Stats Menu'''
*Monthly stats are the number of projects catalog by month and by year
*General stats - number of projects, completed projects, etc.
*Chapter Counts - pending

'''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'''
=Orphaning a section=
searches the reader and user lists
Sometimes you must remove a reader from a section - either because they've given up the section, or they've disappeared.
# Go to your BC admin.
# Sort by Readers (see section 2. "Basics on using the BC admin" above).
# Look for the reader in the list.
# If they have not read any of their assigned sections:
## Click the "delete" link at the end of their row in the list.
# If they have completed sections, but you need to remove them from some uncompleted ones:
## Click the "Edit" link in the "Sections" column.
## Delete the section number(s) you are removing them from
## Hit "Return" on your keyboard or click the "Save" button to save.


=FAQ=
=FAQ=
==Are there rules about how we must enter information in the "Notes" fields?==
==Are there rules about how we must enter information in the "Notes" fields?==
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. The use of colour has become wide-spread; we have included bits of code above which you can use. It's not hard. However, this is not a requirement.
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.


==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"?==
==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"?==
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"). 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 3.1 above).
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.)


==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?==
Yup! Click the "View All My Projects" link in the upper-right corner of the admin page.
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? Send a PM to your MC!)'''
'''(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.)'''

Latest revision as of 00:27, 19 June 2024

Creating a new group project

--> See: What does a book coordinator do?

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). If you are presented with "You don't have permissions for this area.", then click Logout and try again.
  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.
  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 https://librivox.org/uploads/xx-nonproject/Firsttimeaccessing_workflowsystem.pdf

NOTE: BCs 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 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 your 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.

Editing the Magic Window from the Section Compiler Screen: Preparing the Magic Window for reader claims

There's a video showing basic actions in the Section Compiler, on Youtube.

Entering titles into the Section Compiler

Often a book will have chapter titles. It's good to include these in your reader list so your readers know EXACTLY which sections they're signing up for. Give plenty of specific information to avoid confusion!

Also, titles in the Magic Window will be used during cataloging and added to files as ID3 tags. Therefore, enter the titles as you'd like them to appear later, remembering that the section number will be automatically added to the beginning of each title. This will make the files sortable. So a title entered as "Chapter I" in the MW will be given an ID3 title tag of "01 - Chapter I" during the cataloging process. To add titles:

  1. Click on the BC admin link under your MW.
  2. Click in a "Title" field. Type (or paste) the chapter/section name. NEW: Do not add the section number! The new system will add these automatically during cataloging.
  3. Hit "return/enter" on your keyboard to save the title.
  4. Continue adding titles for all the sections in the same manner.
  5. Important: The title column should only include plain text for the chapter title - no text formatting or links! You may include the section author's name here, if it is NOT a collection and the section is written by someone other than the primary author (e.g., a translator's introduction to a book, a short story in a magazine, or a song in a hymnal). If you need other information (such as links or reader instructions) to show in the magic window, please enter it in the Notes column.
  6. If this is a non-English project, enter the titles with the proper accents or non-English characters.

Do not include the following characters in section titles (or ID3 tags) 

                           " ;  / & > or <

Example of a Magic Window:

Adding Word Counts, Text Links or PL Notes

It is very helpful if you enter each section's word count in the Notes field. This will enable readers to choose better which sections they can manage in the time they have available. Forum discussions have shown that average reading speed is approx. 2000 words in 15 minutes. How to count the words, see: Word Count

  1. Click inside the notes column to add word counts, text links, file durations or other notes. This field can contain html as well as simple text.
  2. Click Save to save your edits.

Note: You must click Save before leaving the field in order to save the information. If you switch to a new field or new window without clicking Save, you will lose your work.

Example of a Magic Window:

Adding links to text sections

Sometimes you may want to divide a very long chapter up into smaller sections (most readers prefer sections no longer than 4000 words, i.e. ~30 minutes' reading time). You can give your readers links to those sections (use Google docs or similar to host the text portions). This is also helpful when the sections are not clear-cut, e.g. when there are no chapters.

  1. Click in the "Notes" field.
  2. Paste in this code: <a href="">Link to text</a>
  3. Click Save before leaving the field, or you'll lose your work!
  4. Now, between the quotation marks, paste in the URL to the text, e.g. https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en
  5. So the whole thing reads: <a href="https://docs.google.com/Doc?docid=0AcMZiSudHexxZHQ3MjR2d18zZ3RqajNi&hl=en">Link to text</a>
  6. Click the "Save" button.
  7. Right click your new link to open in a new tab and make sure it works :)

Example of admin:

Signing up readers

Assigning and removing readers

As readers sign up, add them to the reader list.

  1. Click on the BC admin link under your MW.
  2. To assign a reader to a section, click the "Assign reader Sections" button above the table.
  3. 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.
  4. Enter the section number(s) that are to be assigned to the reader and then click Add.
  5. The reader assignment should appear in the reader column in the table and the status should change from Open to Assigned.
  6. To add more than one reader to a section, repeat the process above to add the additional reader(s).
  7. 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.
  8. To remove a reader from a section, simply repeat the process above, but click Remove rather than Add.


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.

  1. Click the "Add new reader" button. A popup window will appear.
  2. Enter the reader's forum username and catalog (display) name and a website if one has been provided.
  3. Click Add Reader to add the new reader to the system.
  4. NOTE: If you get an error message that the email can't be found, contact your MC for help.
  5. 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

  1. Click in the Listen URL column and paste the link provided by the reader.
  2. Hit Enter on your keyboard to Save.
  3. 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.
  4. A link to the new file will appear in the Link column.

Changing the status of a section

This information will show in the last column of the 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 in the status column, then type the first letter of the desired status (i.e., R for Ready for PL, P for PL OK) and hit enter to save.)

The 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

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.

  1. Click on the icon in the Meta column next to the title.
  2. This opens a new area at the top of the table where you will enter the Author, Text Source link and Language.
    1. 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.)
      1. If there are too many authors with the same last name, you can narrow down your search by adding a comma, then the author's first name (for example: "Smith, Harriet"). You can also search by a name in the "proper" order, but authors with a middle name or initial (e.g. "Samuel L. Clemens") may not show up if you do not include that in your search.
      2. 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.
      3. 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.
      4. If you have any other questions about authors (i.e. spelling seems incorrect, multiple authors, translators, etc.), please contact your MC.
    2. 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.
    3. Use the dropdown to change the language from the default if this is a multilingual collection.
    4. 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.
    5. Click Add to save your entries.
  3. 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?

  1. To add a section to the table, click the button "Add new section" at the top of the table.
  2. 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.
  3. The new section will appear at the bottom of the table.
  4. 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.
  5. The rows will automatically be renumbered.
  6. If you need rows deleted, please move them to the bottom of the table and then ask your MC to delete them.
  7. Note: the click and drag function may not work on tablet screens.

Special Instructions for Dramatic Works

  1. 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.)
  2. 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.
  3. Do not assign readers to the finished acts/chapters unless your MC instructs you to do this.
  4. 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.
  5. The original rows with the individual roles will be deleted when the project is cataloged.
  6. 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 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

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 all projects (complete and active)
  • View only your active projects by clicking the radio button next to Show Only Active 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.

Projects 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.

Projects Menu - 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

Stats Menu

  • Monthly stats are the number of projects catalog by month and by year
  • General stats - number of projects, completed projects, etc.
  • Chapter Counts - pending

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

Are there rules about how we must enter information in the "Notes" fields?

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.

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"?

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.)

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.)

Retrieved from "https://wiki.librivox.org/index.php?title=BC%27s:_How_to_update_the_Magic_Window&oldid=32729"