Manual:Vaniquotes compiler guide (2.0)

Concept: working draft for Manual 2.0

The idea is for this to be a technically oriented resource presented in layers of detail, beginning with a 'quick guide' outline format and progressing into the details via links to other sections/pages. The premise is that the Vanitutor will provide the 'hands-on' experience and conceptual background for the compiler through training, and that this manual will serve as a process guide, checklist, reminder, etc rather than a primary tutorial resource.

In other words: this is not designed to replace the previous Manual in full (complete with screen shots, detailed explanations, etc). Compilers with a little experience, however, should be able to consult this manual for instructions pertaining to special cases, troubleshooting, alternate process steps, etc. The focus is technical and practical, with the purpose of serving as an easily approachable companion for the compiler as he/she is actually sitting at the computer and proceeding through creating, compiling and editing pages.

Components:

Compiling pages

• outline
• details

(Creating pages)

Editing completed pages

• outline
• details

Troubleshooting/special issues

• details only - links to the previous two pages - TOC will serve as the index

The various components will be spread over multiple pages and cross-referenced with one another via page/section links.

Material for Manual (2.0) - working notes

Introduction to the Vaniquotes website

Vaniquotes.org is one of seven individual sites that together comprise the Vanipedia web project. 'Vanipedia' refers to the collection of sites as a whole (all the 'petals of Vanipedia') as well as to the individual site vanipedia.org.

Menus

Each site contains a menu to the left of each of its pages for navigation and searching within that site and for easy access to the other sister sites.

Logo The logo at the head of the menu panel lets you know which of the individual sites you are on. (It's good to note this, as it is sometimes easy to miss where you actually are within the group of sites.)

Navigation This menu contains links to the site you are on, including the Main Page and other informational and support pages for site visitors (e.g. "Contact us").

Interaction If you look on the panel to the left of each page, you will see the seven Vani sites listed on the "interaction" menu. Any of these sites can be accessed from any other by clicking on its respective link under "interaction".

Exploring Vaniquotes

There are two ways to explore the Vaniquotes site starting from the menu panel. One is through browsing the category or page lists, and the other is through a keyword search.

With any of the following search methods, it is good to be open to broadening or narrowing your search to see more pertinent results. (For more detailed information on Vaniquotes searches, click here.)

Vaniquotes "All categories" or "All pages"

Category title search

Clicking on "All categories" will take you to the category namespace, which contains and alphabetical listing of all Vaniquotes category titles.

• To search for your topic of interest: type the first few letters of a key word or phrase into the box marked "display pages starting at". This will prompt a drop-down menu to appear.
• The drop-down menu will list category titles containing matches to the text you typed in. You can select from the items on the drop-down menu.

To browse without doing a key word/phrase search:

• Type in the first few letters of your search and click "go" to be taken to another page of listings starting with those letters. You may also skip the key word/phrase search and just start browsing through the lists.
• To access a particular alphabetical range within the listings, click on one of the category names bounding that segment (either beginning or ending).

Page title search

Clicking on "All pages" will take you to an alphabetical listing of all Vaniquotes page titles.

• The search methods work the same way they do for "all categories" (see above), only the titles will be for individual pages, not categories (which are collections of pages).

"Search"

You can search the site directly from the menu panel under "search". This is the quickest way to get started exploring the site.

• Type a key word or phrase (or the first several letters of one) into the box under "search".
• A drop-down menu will appear with a list of matches within both category titles and page titles.
• You may click a title from the menu to fill you search box, and then select "go" to go to that page or category.

User accounts and access

Anyone may use the Vanipedia websites as a reader. No fee, user name or password is required for visitors to access the content of pages.

Contribution and editing are not open to the general public. Access to creating and editing content is given by permission of a site administrator, who grants compilers and others their own user account for the individual site to which they wish to contribute.

Note to users and contributors: Before you start to search or compile in Vaniquotes, make sure that you are in Vaniquotes (vaniquotes.org) and not one of the other sites! (The same goes for any other of the seven 'petals'.)

Tools

Compiling Application (v2.0)

Vaniquotes pages are compiled using a set of compiling tools developed especially for Vaniquotes.

Getting started

To access the compiling tools:

• Log in to your user account. (For help logging in, click here.)
• Go to the page you want to compile (if you're not there already).
• Click on the tab "compile", located at the far right along the tabs just above the page title. This will take you into what we call 'compile mode'.

You should now see purple and blue colors in your screen along with a tool box in the middle. (If you do not see the tool box, or if you did not see the "compile" option on your page tabs, click here for help.)

For a guide to compiling procedure, please see (Link|Title of the section with step-by-step instructions on compiling).

Features

The following is a quick guide to the features of the Vaniquotes compiling application.

Compiling Tool Box

This is the purple box that appears when you first enter into compile mode. This is where you initially enter content for the page. It is divided into two tabs: "Compile Form" and "Page Facts".

Compile Form (Alt+C)

This text box is where you paste the text you are copying from VedaBase for your quote.

Button	Function
Submit	'Submit' means to send the quote to be initially positioned in the page (before setting a heading, etc, and actually inserting it into the page). This takes place after the Vanisource reference for the quote is found. Normally, quotes will submit automatically as soon as they are pasted (Ctrl+V) into the form. Click this button when you need to submit a quote manually (for instance, when you have had to look up the Vanisource reference manually).
Prabhupada as speaker	The button with Prabhupada's picture. It is used to insert Prabhupada's name as speaker. This button is also available in the edit window (after you submit your quote).
Clear form	The button with the arrows. This is used to refresh/clear all text from the form.

Page Facts (Alt+F)

This is where the expressions list and other page facts are located. This information is generally either entered into the page when it is first created, or updated automatically as the compilation progresses.

To open any of the following sections for review or editing:

• Click on the section heading or press the keyboard shortcut (given in parentheses).

Section	Function	How to edit
Expressions (e)	Opens the expressions list for adding/deleting/changing expressions. (For more information on expressions, click here.)	Click here for information.
Categories (c)	Shows the categories to which the page is linked. (For more information on categories, click here.)	Click here for information.
Completed sections (s)	This is where you tick off which sections you have completed (BG, SB, etc) before saving the page. All compilers will use this section. Whenever you finish a page, you must always tick ALL.	Click in the boxes next to the section names to mark them as 'completed'.
Notes from the compiler (n)	This is where the compiler can enter notes pertaining to the page for the benefit of users and other compilers. For more information about notes, click here.	Click here for information.
Compiler (p)	Shows which compilers have contributed to the page. Compilers are listed in chronological order.	Auto-filled; do not edit
First (f)	Shows the date of first entry to the page (i.e. the date on which the page was created or when first quote was compiled).	Auto-filled; do not edit
Last (l)	Shows the date of last entry to the page. This includes quotes compiled and any editing done in compile mode after the page is marked 'complete'.	Auto-filled; do not edit
Totals by section (b)	Shows the breakdown per section of the number of quotes presently in the page.	Auto-filled; do not edit
Total (t)	Shows the total number of quotes presently in the page.	Auto-filled; do not edit

next section to be covered: quote menus/edit window

This will report the page to the editing pool as 'complete' and remove the "goal number" section from the page's facts section.

Clearing the browser cache

When system updates are made, you need to make sure your browser cache is cleared in order for the latest version (with the updates) to be available to you.

• Go into "Tools" on the Firefox menu (very top of window)
• Select "Clear Recent History"
• Time range to clear can be "Everything"
• Select "Cache" (tick the box next to "Cache")
• "Clear Now"

Compiling process

Logging in to your account

You must be logged in to your user account in order to start compiling pages.

• This can be done from any page in Vaniquotes.
• Click on the small words "log in" at the upper right-hand corner of the page.

If you forget your password, click on "Email new password" for assistance, or contact a Vaniquotes administrator (link to current list of administrators/contact info).

Make sure that you are...

• In Vaniquotes and not another one of the petal sites, like Vanipedia or Vanisource.

(To get to Vaniquotes, use the "interaction" menu to the left side of any page.)

• Using Mozilla Firefox as your browser.

Preparation

Which pages do I compile?

Each Vaniquotes compiler works from a chosen list of pages based on "goal number", or the number of VedaBase "hits" for the page's query. The goal number indicates roughly how many quotes the page will contain upon completion.

Sign up for a goal number on the Compiler Goals sheet.

• Click in the sheet where it says "choose", and that goal number will be yours.
• To deselect a goal number, click on your name and it will be removed.

Note: Pages can vary in complexity. If you come across a page you don't understand - or if you are having technical problems - please ask for assistance or skip over that page and go to another one.

Preparing VedaBase for compiling

Vaniquotes searches a defined set of sources in VedaBase. These must be selected (specified) in VedaBase before you start to compile.

• Click here for the source list.
• Tick the box next to the source name to select the source for your search field.

For further help using VedaBase, click here.

Preparing a page for compiling

Make sure you are using Mozilla Firefox for your web browser.

• Go to the page. (This can be done by clicking on the link in your goal number list or by copying/pasting any page link into your browser.)
• Click on the compile tab. This will open the compiling tools.

Having problems? Click here for troubleshooting information.

Searching VedaBase for quotes

Procedure

• Copy the expressions list (or other query given in "notes from the compiler") into a VedaBase advanced query. (help)
• Check to see that the number of 'hits' agrees with the goal number of the page (help)
• Locate the next quote to compile on the page. (help)
• Remember: not every hit should be compiled! (Click here for the "do not compile" list.)

VedaBase tips

Keyboard shortcuts ('hotkeys')

For a list of default keyboard settings which are particularly useful, click here.

Dealing with long expressions lists

Queries made from long expressions lists can sometimes cause VedaBase to crash.

• If this happens, you can always query part of the expressions list at one time, and then go back and query the rest in a second search.

(For this you can copy the parts of the expressions list from view mode rather than using the compile tool's "copy expressions" feature.)

• If there is a VedaBase query noted in "notes from the compiler", you may try using that instead of copying the list of individual expressions.

This would be what the page creator used to construct the expressions list. It might require a bit more selection and fine tuning to compile from the query, but it will save you from the problem of VedaBase crashing.

For more detailed instruction on using Vedabase...

Copying/pasting quotes

For an overview of the Vaniquotes compiling tools, click here.

Copying quote from VedaBase

• Highlight the text you wish to select for your quote.

Tip: After marking where your quote will begin, press Shift (on your keyboard) and go to mark where you want your quote to end - this will highlight all the text in between.

• Press Ctrl+C (to copy)

Pasting into Vaniquotes

• Go back to the Vaniquotes compile form (the left-side tab in the compile tools/Alt+F). Make sure your cursor is positioned in the main box.
• Press Ctrl+V to paste your selected text into the form. The quote should submit automatically.
• Now your quote should be placed into the page itself, where you can see the quotes as they will appear in the page. Make sure that the Sanskrit font has transferred correctly.

Quote not submitting properly? Click here for help.

Preparing and Inserting Quotes

At this point the quote has been submitted.

• The compiling tools should now be hidden and the quote pasted within a blue frame on the page.
• A menu of commands will be located in the frame on the right-hand side. (Red buttons indicate required actions.)

Preparing the quote for insertion (Click on the links for instructions.)

• Set the section
• Select and set the heading

In addition, you should be aware of:

• Special formatting issues
• Special keys in the compile form

• Insert Prabhupada as speaker
• "Quote of the Day" candidate

When the quote is ready to insert:

• Select "insert" on the quote menu (click "insert" or press r on your keyboard).

Need to make changes?

Most changes can be made at any point.

• Click here for a list of common changes and how to make them.

Saving the page

To save your compilations:

Click on the "save" button (upper right-hand side of the screen, the lower of the two buttons) or press Ctrl+Shift+S on your keyboard.

Session time-outs

Wiki automatically 'times out' a user after 25 minutes pass without saving the page.

If you get a message that your session has ended, do not despair. You can still recover your work.

• If you receive a message prompting you for your password, enter your password and proceed.
• When you see the red message at the top of the page indicating that your session has ended, ignore the message instructions. Instead, do one of the following:
  • Press Alt+Shift+S to save the page.
  • (Alternately, you may scroll down to the bottom of the page to where you see the "Save page" button (left-hand side, below the edit window). Click "Save page".)

Compiling Process Details

place as a subsection under Tools/Compiling application - figure out a better title

Note: We recommend utilizing the keyboard shortcuts (hotkeys) as much as you can. Your compiling will go more quickly and easily! These are indicated by the letters in CAPS in the quote menu (e.g. "inseRt" = r).

Setting the section

You will need to select a section for quotes from many of the books (e.g. Bhagavad-gita, Srimad-Bhagavatam). For Lectures, Conversations, Correspondence and some of the books (e.g. Teachings of Lord Caitanya, Krsna Book), section designation is not required.

The quote menu will indicate whether or not a section must be specified by the presence of the red "set section" key.

To set the section:

1. Click the "set section" button or press s on your keyboard.
2. Select the appropriate section from the following:

• Translation (only) = click "translation" or press t on your keyboard.
• Purport (only) = click "purport" or press p on your keyboard.
• Translation and Purport

• Translation+Purport quotes are automatically recognized and formatted as soon as they are submitted.
• The only time you should need to use this option is when you are editing (changing) a previously assigned section.
• To select: click "trans and purport" or press n on your keyboard.

Selecting and setting the heading

Headings are not required, but are preferred in most cases.

• Click here for some guidelines on when to include (and when not to include) headings.
• For guidelines on choosing text for headings, click here.

To create a heading:

• In the quote text, use your cursor to highlight the portion of text you wish to use for your heading.
• Your menu options (to the right) should change to read, "selected text is a:", with options for "heading" or "verse". Sometimes, however, they simply remain as they are, starting with "set heading".

• If your menu starts with "selected text is...": press e or click "heading".
• If your menu starts with "set heading": press e, a, e, or click on the buttons as follows: "set heading" -> "auto" -> "set".

Your heading should now appear in green font above the quote. The first letter will automatically be capitalized and a period (full stop) will be inserted at the end (if not already present in the text selected).

If you wish to make changes in your heading, you have three options:

• Going into the edit window to make changes

This is useful for making corrections to typographical errors, deleting small portions of text, etc.

• Select "edit quote" (press q or click on "edit quote") to open the edit window.
• For further information on editing quotes, click here.

• Appending the heading (= add more text to the end)

This is good if you wish to add one more sentence, for instance.

• To append:
  • Select "edit heading" (e) -> "auto" (a), highlight the text you wish to add, and then select "append" (d).
  • Note that the system will not provide capital letters/punctuation for appended text. Further editing might thus be required.

• Resetting the heading

You can replace the heading entirely if you wish; in some cases this can be faster than trying to edit the present heading.

• Repeat the process for setting a heading from scratch (as outlined under "create a heading", above).

'Quote of the Day' candidates

The Vaniquotes Main Page "Quote of the Day" will be selected from a pool of quotes suggested by our compilers. Anyone may mark a quote for the "Quote of the Day" pool using the compiling tools.

Criteria: What makes a good "Quote of the Day"?

• Conciseness (suggested length: 6-10 lines on the page, not including heading)
• Clarity
• Good heading (if present - headings are always optional)
• References to sastra (with links into Vanisource) are a plus

To tag a quote for "Quote of the Day":

From compile mode -

• The quote tools include a Star icon (at the right of the quote tools menu). Click on this icon to add the quote to the pool.

Special formatting

Cited verses

When Sanskrit verses are cited within a quote, they should be indented (just like they appear in VedaBase).

NOTE FOR TROUBLESHOOTING: don't begin a quote with a cited verse - code appears, whole quote might indent, etc. - have to work the quote around this somehow

Vaniquotes usually recognizes when a cited verse is present in a quote. When is does, a window will pop up with the question, "Is this a cited verse?", showing the text it is 'seeing' as a cited verse.

• If the text shown is a cited verse, all you need to do is select "yes", and the verse will automatically be formatted.
• If the pop-up shows something that is not a cited verse, select "no".

In some cases, a cited verse is not recognized or not recognized in its entirety. These will need to be indented manually.

Manual indenting

• From the quote menu:
  • Highlight the text you wish to indent.
  • The quote menu will give you the option: "Selected text is a: heading or verse" - choose Verse (v)

• From inside the edit window:
  • Open the edit window of the quote (in compile mode - click "edit quote" or press q).
  • Immediately in front of the line you wish to indent, type a colon [:]. Do not leave any spaces before or after the colon.
  • Update the quote (click "update" or press Shift+Enter).

Special note for quotes from Renunciation Through Wisdom:

This book contains citations from many different sources which are formatted as indented blocks of text. Vaniquotes will not recognize these as 'cited verses' - but they should be indented.

To indent a block of text: Place the colon [:] immediately in front of the beginning of the paragraph to be indented. This will indent the entire paragraph.

Apostrophes within cited verses

Cited verses sometimes contain apostrophes or single quotation marks [']. This is especially true of Bengali verses.

Whenever you insert a quote containing a verse with this punctuation [']:

• You should check to see if it is still showing as a single mark ['] and not a double ["].
• The system sometimes auto-converts the single marks to doubles. If it does, then you will need to edit the quote back to its original punctuation.

For more information and examples, click here.

Prabhupada as speaker

When compiling a quote which involves a dialogue between Srila Prabhupada and another party, you will need to make sure that the speakers are specified. This includes:

• quotes from Lectures which contain lines from Prabhupada and another speaker;
• all quotes from Conversations and Philosophy Discussions, including those in which Prabhupada is the only speaker featured.

Sometimes it is necessary to add Prabhupada's name as speaker, as your quote will not always include Prabhupada's name in front of it.

To insert Prabhupada's name as speaker:

• Go into the edit window ("edit quote").
• Mark the spot in the quote text where Prabhupada's name needs to be inserted (i.e. at the beginning of his first speaking line).
• Click on the Prabhupada picture icon, located at the lower right-hand corner of the edit window.
• Update the quote ("update").

Diacritics

The Vaniquotes tools allow you to type diacritics into quotes and category terms lists as needed.

While compiling

Diacritic characters are available for insertion in compile mode when you're in the edit window

[link to another location for this basic info, text following] of a quote.

To access the edit window:

• If the quote has not yet been inserted: select "edit quote" (press q) from the quote menu.
• If the quote has already been inserted: hover your cursor over the quote in question to reveal the quote menu, and then select "edit quote".

To insert diacritics using the compiling tools:

• Open the edit window.
• Position your cursor at the spot in the quote or heading where you wish to place the diacritic character. Click to mark the location.
• Go to the lower right of the window to where it says "diacritics". Click on the word "diacritics" to open the menu of diacritic characters.
• Click on the character you wish to insert.
• The character will then insert in the place you marked with your cursor. (Note that this will take a second or two to happen, and you might have to try it again if it doesn't insert the first time.)

While creating or editing categories

Diacritic characters are also available in other Vaniquotes wiki pages, such as the Category pages. Sanskrit words appearing in category terms lists frequently involve diacritics - which are sometimes critical to identifying the meaning of the word (or the identity of a person).

To insert diacritics into a category terms list:

• Go into edit mode (click into the "edit" tab, located above the category title).
• Position your cursor at the spot in the term where you wish to place the diacritic character. Click to mark the location.
• Go to the lower right of the window to where it says "diacritics". You will see a list of all the diacritic characters available to use.
• Click on the character you wish to insert.
• The character will then insert in the place you marked with your cursor. (Note that this will take a second or two to happen, and you might have to try it again if it doesn't insert the first time.)

Quotation marks/inverted commas

Special attention must be paid to passages involving quotations or apostrophes. These include:

• Passages of text in which a person is speaking
• 'Quotes within quotes'
• Bengali or Sanskrit verses with apostrophes [']

These kinds of quotes might require editing for correct punctuation (either in the quote or the heading).

Reasons why editing is needed:

• Paragraphs or verses in VedaBase do not always include closing quotation marks.
• The text you select might be part of a larger passage - and thus not include opening and/or closing quotation marks.
• The compiling application may auto-convert single quotation marks/apostrophes ['] into doubles.

So you need to keep an eye out when compiling these kinds of passages. For further information and examples, click here.

All of the following changes may be made in the edit window ("edit quote" => make the change => "update").

Issue	Example	Solution
Beginning or ending quotation marks missing from the text selected	Passages in books which are being spoken - e.g. prayers of the Personified Vedas; Caitanya Mahaprabhu speaking at length to Sanatana Gosvami	Quotes and headings need both opening and closing quotation marks.
Quotes within quotes	Spoken passages in books in which the speaker is quoting another source - e.g. Caitanya Mahaprabhu is speaking to Sanatana Goswami and quoting Srimad Bhagavatam.	Vaniquotes quote needs both opening and closing quotation marks. Outer quote should be enclosed in doubles ["], inner quote enclosed in singles ['].
Bengali or Sanskrit verses with apostrophes or single quotation marks [']	Found in cited verses (especially Bengali verses - songs and quotes from CC). For example: samo 'ham sarva-bhutesu na me dvesyo 'sti na priyah. yei krsna-tattva-vetta, sei 'guru' haya	Check to see if there are double marks ["] in the verse; if so, change them back to the original punctuation (apostrophe or single quotation mark).

Making changes to quotes or pages

You can correct mistakes or make changes in your work at any point while in compile mode, either before or after the quotes are inserted.

If the quote has already been inserted: Return to any quote on the page by hovering your cursor over any part of the quote. The quote will highlight within a frame and the quote menu will appear to the right. Now you can make changes to the quote.

Some typical changes are as follows:

What you want to do	How to do it
Delete a quote	Click on the 'trash can' icon in the upper right-hand corner of the quote menu.
Recover a deleted quote	Go to the colored bar marking where the quote was deleted. Click on the Undo (arrow) icon at the far right of the bar. (Note: this action can only be performed before saving the compilation.)
Add a quote that was missed	Compile the quote into the page as usual. It will automatically be inserted in the proper place, under the proper section heading. (Note: if the added quote is being taken from the same text as one already present in the compilation, it will be place after the previously compiled quote by default, regardless of whether it comes before or after that quote in the original text. If you don't want the added quote to come after the other one, then delete the other quote and recompile it.)
Undo an action	Click on the arrow icon on the right-hand side of the quote menu. This works to undo all kinds of revisions.
Make changes within headings or quote text*	Select "edit quote" [link to basic instructions, before/after insertion] from the quote menu. You can make changes to any portion of the compilation using this edit window. To save changes, click "update" (Shift+Enter). To exit the window or cancel changes, click "cancel" (hotkey).
Add a heading	Select "set heading" and follow through as usual. (Click here for more detail.)
Delete a heading	Select "edit quote" to access the edit window. Delete all the text in the heading, and then click "update" (Shift+Enter).
Format a cited verse manually	Select "edit quote" to access the edit window. To indent a line, type a colon [:] immediately in front of the line you wish to indent. Be sure there are no spaces on the line before the colon! Do this for each line you wish to indent, and then click "update" (Shift+Enter).
Add Prabhupada as speaker	This can be done either before or after the quote is submitted. Mark with your cursor the place where you want Prabhupada's name inserted, and then click on the Prabhupada picture icon. For when you first paste the quote into the compile form: find the Prabhupada icon to the upper right of the form. For after the quote has been submitted (i.e. when you are in the page): go into the edit window ("edit quote"), where the icon will be to the lower right of the window.
Add a speaker's name (other than Prabhupada)	Select "edit quote" to access the edit window. Type in the name of the speaker where it needs to go, and then select "update" (Shift+Enter). (Note: this is one edit that is okay to do within the quote, as it is only specifying a speaker and not altering the content of what is being spoken.) You can insert diacritics if needed; click here for details.
Add more text to a quote*	This must be done through the compile form in order to transfer the Sanskrit characters properly. Thus, rather than trying to copy straight from VedaBase into the edit window of the exisiting quote, you should instead delete the quote and then recompile it.
Delete text from a quote*	Select "edit quote" to access the edit window. Delete the text you wish to remove*, and then click "update" (Shift+Enter).
Add or delete expressions	Go to the page facts tab (Alt+F). Click on "expressions" (or press e) to reveal the expressions list. To add an expression: place your cursor in the text box; type in the new expression; press Enter. To delete an expression: place your cursor over the expression and click three times (this should highlight the entire content of the field). Press Delete to remove the expression.
Add a category	Go to the page facts tab (Alt+F). Click on "categories" (or press c) to reveal the categories list. Adding the category: Place your cursor in the text box; type in the first few letters of the category you wish to add. A drop-down menu will then appear, showing all the existing categories containing the word portion you typed in. Select the desired category by placing your cursor over the category name and pressing Enter. The category will then be added to the list. Note on category order: Categories should appear in the order in which they appear in the page title. Umbrella categories, which do not represent terms but rather topic areas (such as "Prabhupada's Stories"), are placed at the end. To change the order in which the categories are presented: Place your cursor over the category you wish to move. Click and drag the category up or down to where you want it placed in the list, and then release. (If it doesn't work the first time, try again - sometimes it's a little sluggish.)
Delete a category	Go to the page facts tab (Alt+F). Click on "categories" (or press c) to reveal the categories list. Place your cursor over the category name and click three times (this should highlight the entire content of the field). Press Delete to remove the category.
Change the goal number	Go to the page facts tab (Alt+F). Click on "goal" (or press g) to open the goal number field. Place your cursor over the goal number and click three times. Type over the new goal number and press Enter.

*Please note: VedaBase content must not to be edited. You may include more text from the source or you may shorten your quote (by cutting text from the beginning or from the end), but no changes are permitted within the body of the quote itself.

Notes for new compilers

This page is now called Notes for compilers in training

Compiling without a mouse (for Windows)

General notes

• Your compile form can always be accessed by pressing Alt+c.
• When using the keyboard keys on the vaniquotes website make sure the cursor is inside the blue box of your quote.

Process

• Go to the page you want to compile (beginning with vaniquotes.org)=> Log in
• Press Tab until you see: "javascript:load_compile_form()" (you can see this at the bottom of Firefox)=> Enter
• Follow the sequence:
  • Alt+f (Page Facts)=>
  • e (Expressions)=>
  • press Tab twice; now you have to use your mouse: click on the Copy expressions button=>
  • Ctrl+c=>
  • Alt-Tab=> now you will be in VedaBase
• In VedaBase:
  • Select your quote (i.e. highlight that part you would like as your Vaniquote)
  • Shift+Arrow (Either left, right, up or down)=>
  • F9 (This is the recommended 'hotkey' for "Copy With Reference" - click here to see how to fix this)
  • Ctrl+c=>
  • Alt+Tab=> now you are back in Vaniquotes
• In Vaniquotes:
  • Make sure the cursor is in the "Compile Form" (Alt+c)=>
  • Ctrl+v=>
  • If it`s a purport or translation:
    • Set Section by typing "s" (while doing this make sure the cursor is inside the blue box of your quote=>
    • Choose Purport by typing "p" or choose translation by typing "t"=>
    • inseRt by typing "r"=>
    • Save by pressing Ctrl-Shift-s

Assigning hotkeys in VedaBase

To get a keyboard key (or 'hotkey') for "Copy With Reference":

• Go to VedaBase=>Tools=>Customize=>Keyboard=>
• Click on the arrow next to "Edit", then click on "Misc"=>"Copy With Reference"=>
• In "Press new shortcut key", press F9 (or any key you prefer)=>
• Assign=>OK

Editing Completed Pages

Process

Selecting pages to edit

• Go to the page List of Complete Compilations to find the list of pages completed and ready for editing.
• Select a page to edit by clicking on "edit this page" (second column from the right) - your name will then appear as Editor.
• Click on the page link (first column on the left) to go to the page.
• When you have finished editing the page, go back to the List and check the box "edited" (at the far right).

Note: Do not select pages for which you are listed as the compiler (we want another pair of eyes doing the final editing!)

Navigating the List

• To go forward or backward to other pages in the list, use the green arrows ("previous/next") at upper and lower right of the table.
• To view the list of pages that have already been edited, click on the header "Edited" (far right-hand column).

Checklist for self-editing and third-party editors

Standard formatting

Expressions

• Expressions list present
• Expression highlighted in each quote

How to correct errors

Speakers

• Section standards
  • Conversations: always include speaker’s name (even if only Prabhupada speaks)
  • Lectures: include speakers’ names if more than just Prabhupada; otherwise, do not
    • exception - Philosophy Discussions: always include speaker’s name (just like Conversations)

• Layout
  • The first line with the speaker’s name should always begin at the left-hand margin (on the next line after the Vanisource reference)

How to correct these errors

Body of Quote

Some common errors that might occur in the main body of the quote are:

• Initial letter missing from first word
• Letter(s) missing from the end of the last word
• Wiki code appearing with the quote text (in view mode) - [details as to why/how to fix]
• Extra Vanisource reference appearing at the end of the quote - [why/how to fix]
• Diacritics missing

Translation-and-purport quotes

• Translation and purport have 1 blank line space between

How to correct this error

Punctuation in quotations

Note: These must be fixed manually by the compiler. Thus, such errors will likely occur frequently.

• For quotes within quotes: be sure that the inner set of marks are singles, not doubles
• When the text is a quoted segment: be sure that there are quotation marks (inverted commas) at both the beginning and the end of the quote.
• For cited verses: be sure that apostrophes ['] are not showing up as doubles ["].

Examples of errors and how to correct them - use text below in separate section

Headings

• Consistent throughout page ('with headings' or 'without headings')
• Headings may always be omitted from short, translation-only quotes
• Should appear in bold green font

Page content

Notes from the compiler

• Irrelevant notes should be deleted (e.g. a note about a missing quote which has subsequently been inserted)
• Other, relevant notes should remain (e.g. notes regarding VedaBase queries, bad reference links, explanation of page content, etc)

Headings

• should read clearly and reasonably easily
• should have no errors in spacing, punctuation, etc
• should be complete sentences ending with full stop (period)
• should contain the expression
  • Exceptions:
    • when Prabhupada does not use the expression himself
    • when the expression appears only in the translation of a verse which is repeated several times throughout the page

Vanisource references

Vanisource references should be correct and properly inserted.

• The reference given is for the text from which the quote was taken, not for the text immediately following in VedaBase
• Translations are shown as translations and not as purports
• No red error messages showing (e.g. "reference not found", etc)

Vanisource reference errors not always obvious, but many can be detected during editing if you know what to look for. Click here for more information.

Page facts

• Completed sections - should be marked “ALL” (with no goal showing in view mode)

(The rest of the page facts are fully automated, so there should be no need to do a detailed check on the other data.)

Categories

• At least one category link for each page
• No category links should be in red font

Note: there may be scope to update or refine the category linking

link: How to make corrections/updates

Quotes compiled

Quotes should not be compiled from:

• synonyms (word-for-word translation section)
• quotes from an appendix or index
• text segments written by someone other than Srila Prabhupada (e.g. Forewords)
• purports from SB Canto 10.14 through Canto 12
• verse summaries at the beginning of LOB, ISO, MM, NBS
• chapter headings
• quotes in which the expression appears only in a reading being done by a devotee and is not further commented upon by Prabhupada
• quotes in which the expression is used by someone other than Prabhupada and Prabhupada does not offer further commentary in connection with the expression

Conversion issues

There may be errors in older pages stemming from the conversion from our previous 1.0 compiling system to the present 2.0 system.

Issue	Solution
Pages not being accessible for compiling (i.e. compile tools will not open)	Report to the debugging document (sheet: "conversion issues")
Incorrect formatting (line spacing incorrect, headings not in green, etc)	First try refreshing the page (click "refresh" tab, located in view mode above the page title, far right). If this does not fix the problem, try updating the affected quotes. If neither of these options works, report to the debugging document (sheet: "conversion issues").
Translations showing up as purports (this can be tricky - click here for more information)	(Click here for help)

Components for manual 2.0

VedaBase source list

Selecting sources for search in Vedabase

The Contents menu is located on the left-hand side of the VedaBase screen. Tick the boxes next to the source name to select:

02. Bhagavad-gita As It Is

03. Srimad Bhagavatam

04. Sri Caitanya-caritamrta

05. Other Books - select:

Teachings of Lord Caitanya

Nectar of Devotion

Nectar of Instruction

Easy Journey to Other Planets

KRSNA, The Supreme Personality of Godhead

Renunciation Through Wisdom

Message of Godhead

Light of Bhagavata

Sri Isopanisad

Mukunda-mala-stotra

MM mantras 1 through 6 (marked *)

Narada-bhakti-sutra

NBS 1: the Value of Devotion

NBS 1 through 8 (marked *)

07. Lectures

08. Conversations

09. Correspondence

Troubleshooting: Opening the compiling tools

Issue	Reason	Solution
"Compile" option not available	user not logged in user not set up as editor	click on "log in" (on the menu at the upper right-hand corner of the screen); follow through with user name and password contact a Vaniquotes administrator for assistance
"Compile" tab does not open with compiling tools	user preferences need to be changed page not successfully migrated to 2.0 system compiler not using Mozilla Firefox browser	click here for help report to the debugging list - click here for help switch to Firefox and try again

Troubleshooting: Problems submitting quotes

Issue	Solution
Reference not found	Look up reference/select manually (click here for help)
Reference not found in database (following manual look-up)	put note in "notes from the compiler" and report to debugging document (click here for help) exception: SB 10.1 "Additional Notes for this Chapter" - use SB 10.1.69 Purport as reference
Quote not submitting (no error message given)	Make sure the quote has not already been compiled. Click "submit" manually; wait for a few seconds (the system simply might be slow to respond). Note: You might get more than one insertion. If so, simply delete the extras, starting from the bottom.
Quote submits in duplicate (or more)	Delete the extra quote(s) on the bottom. (This happens sometimes when you click "submit" manually.)
Sanskrit font not copying properly Characters look unformatted, like this: Kåñëa, håta-jïänäù, etc Characters are formatted, but look like they belong to another alphabet (e.g. Slavic script)	Re-install the fonts portion of VedaBase (click here for help) Check your computer keyboard settings to make sure the default is to English characters. If you still have problems, try re-installing the VedaBase fonts.

More on quotation marks (inverted commas)

Here are some detailed examples of common issues involving quotation marks (inverted commas) and how to edit them for insertion into Vaniquotes.

Quote within a quote - single marks auto-converted to doubles:

Example 1

""My Lord, the nectar of Your words and the descriptions of Your activities are the life and soul of those who are always aggrieved in this material world. These narrations are transmitted by exalted personalities, and they eradicate all sinful reactions. Whoever hears these narrations attains all good fortune. These narrations are broadcast all over the world and are filled with spiritual power. Those who spread the message of Godhead are certainly the most munificent welfare workers."" (CC Madhya 14.13, Translation)

To correct: Go into the edit window of the quote ("edit quote") and change the inner marks to singles.

"'My Lord, the nectar of Your words and the descriptions of Your activities are the life and soul of those who are always aggrieved in this material world. These narrations are transmitted by exalted personalities, and they eradicate all sinful reactions. Whoever hears these narrations attains all good fortune. These narrations are broadcast all over the world and are filled with spiritual power. Those who spread the message of Godhead are certainly the most munificent welfare workers.'"

Example 2

Corrected version:

"Vallabha replied, 'My dear brothers, how can I disobey your orders? Initiate me into the Kṛṣṇa mantra so that I may perform devotional service to Lord Kṛṣṇa.'" (CC Antya 4.37, Translation)

• Quotation without closing marks:

Example 1

“Śrīla Rāmānanda Rāya is situated on the path of spontaneous love of Godhead. Therefore he is in his spiritual body, and his mind is not materially affected. (CC Antya 5.51, Translation)

To correct: Go into the edit window of the quote ("edit quote") and add closing marks.

“Śrīla Rāmānanda Rāya is situated on the path of spontaneous love of Godhead. Therefore he is in his spiritual body, and his mind is not materially affected."

Example 2

“‘As long as there is not the slightest fragrance of pure love of Krsna, which is the perfect medicinal herb for controlling Lord Krsna within the heart, the opulences of the material perfections known as the siddhis, the brahminical perfections [satya, sama, titiksa and so on], the trance of the yogis and the monistic bliss of Brahman all seem wonderful for men.’ (CC Madhya 19.165 Translation)

Corrected version:

"‘As long as there is not the slightest fragrance of pure love of Krsna, which is the perfect medicinal herb for controlling Lord Krsna within the heart, the opulences of the material perfections known as the siddhis, the brahminical perfections [satya, sama, titiksa and so on], the trance of the yogis and the monistic bliss of Brahman all seem wonderful for men.’"

• Apostrophes in Bengali or Sanskrit verses auto-converted

Vaniquotes debugging report list

This is a Google doc that we share for reporting bugs and other issues with the Vaniquotes compiling applications.

Your Vanitutor will arrange to have you added as a user for this document. We recommend that you bookmark the debugging list for future access. Click here to go to the debugging list.

• Note that there are several sheets (listed across the bottom) within this document.
  • When reporting an issue, you should select the sheet with the title best reflecting the nature of the issue.

For instance, if you cannot submit a quote because the Vanisource reference cannot be found, you would report it to the sheet titled "Vanisource ref errors".

• To scroll through the list of individual sheets across the bottom, place your cursor over the small arrows to the right of the list.

Keyboard shortcuts

Shortcuts for compiling tools (version 2.2.0)

For the Compile Tools box:

• Compile form = Alt+C
• Page facts = Alt+F

For Page Facts:

• use the underlined character (e.g. "expressions" = e, "completed sections" = s)

Quote menus:

• use the characters in capitals (e.g. "edit Quote" = q, "sEt" = e, "inseRt" = r)

To save: Ctrl+Shift+S

Editing: While the cursor is in one of the editing text boxes (quote or heading) -

• Update = Shift+Enter
• Cancel = Esc

To hide menus or tools (except during editing as above): Esc

For a technical introduction and more explanation about these shortcuts, click here.

VedaBase hotkeys

The default settings for VedaBase are as follows:

• open advanced query tool = F2
• next hit = F4
• previous hit = F3
• next partition hit = F8 ('partition' means paragraph or, under Correspondence, record)
• previous partition hit = F7
• copy with reference:

There is no pre-assigned key for this operation. You may assign one if you wish - click here for instructions. (Suggested hotkey: F9)

Compiling tools: Further information

Keyboard shortcuts (notes from the Vanitech team)

We have created a keyboard shortcut system by which most of the tools (compile form, page facts, menu in quotes, etc) are now available by pressing a specific key depending on what action is desired and what tools (buttons)are available while compiling. This will help you navigate through menus without the need to use the mouse.

You do NOT have to use these keys if you don't want to, but we seriously encourage you to use them since we, the Vanitech team, believe that the usage of the keyboard will help you improve you speed and ability to access menus and different tools while compiling. (We also think that they will make you a better computer user, since the most avid and "heavy" computer users rely on keyboard as much or more than the mouse for navigating and performing tasks in the computer, e.g browser menus, word documents menus, etc.)

1. You will see now that the Compile Tools box has in its main tabs: Compile Form and Page Facts have a character (letter) underlined in their titles. This indicates the keys to be used to access these tabs. These two are special shortcuts since they are accessible at any time during compiling, and so they have been programmed with a "modifier key", which in these cases is the Alt key. You will press Alt+C (at the same time) to access the Compile Form and Alt+F to access the Page Facts.

Modifier keys are keys utilized to access certain functions by being pressed at the same time with the specific key. For example you would use Ctrl+C (Apple+C in mac) in order to copy a highlighted text to the clipboard and then paste it with (another modifier+key) Ctrl+V (Apple+V). We also often use the Firefox shortcut to reload a page: Ctrl+R and the infamous Ctrl+Shift+R (Apple+Shift+R) in order to "clear the cache" of the browser to get a fresh updated version of a webpage.

2. We have also implemented another "shortcut" for saving a compilation. This is the combination of Ctrl+Shift+S. This one has 3 keys to make sure you don't save the compilation by accident. (These shortcuts are the same, independent of system - Mac, Linux or Windows.)

So far we talked about the hard ones (because the use a modifier key). Now for the fun and easy ones:

3. Inside the Page Facts you will see that every Fact (expressions, categories, goal, etc) has also a underlined character indicating the key to access it. There is NO need to use a "modifier key" (Alt or Ctrl) for accessing these. In this case you simply need to press the indicated key in order to access the desired Fact. You should see the Facts expanding and collapsing when you press their respective key just as if you were clicking them with the mouse.

Now these are really cool ones for the "fast and fired-up (furious)" compilers:

4. Inside every quote we have a menu in order to "Set" a few important attributes specific to that quote. We call this the quote menu and we set stuff like Section (Translation, Purport, etc), Heading, etc. The great news is that every one of the these menu buttons have a shortcut too! The shortcut key is hinted a bit different than in the Facts, it's the character in caps. (These buttons are a bit different, and that's why we had to code them this way.)

5. The escape key will now work in most events to hide menus, the compile tools, etc, and to cancel editing and to hide quote menus.

If you have any further questions, please consult your vanitutor for an explanation.

Contact information

Vanitutors

• Visnu Murti das
  • Skype:
  • email:
• Matea Zajec
  • Skype:
  • email:
• Madhu Gopal das
  • Skype:
  • email:
• Labangalatika dasi
  • Skype:
  • email:

Administrators

For help with issues related to your user account, contact:

• Visnu Murti das
  • Skype:
  • email:
• Madhu Gopal das
  • Skype:
  • email:
• Labangalatika dasi
  • Skype:
  • email:

Editing manual details

Correcting errors

speakers not formatting correctly-

This is an autoformatting/conversion issue. To correct this: go into compile mode, click “edit quote”, and then “update” , and then save the page. If this does not work, try recompiling the quote – delete the existing quote, save the page, and then enter into compile mode again, compile the quote anew (from Vedabase), and save the page.

Simple formatting errors

Issue	Reason	How to correct
Incorrect spacing between translation and purport	This is an autoformatting/conversion issue. The quote has actually not been converted to the correct section (Trans+Purport).	(Click here)
Cited verse not indented	Compiler error. This can also happen for part of a verse (e.g. two lines of a four-line verse are not indented).	(Click here)

Errors with expressions

Expressions list missing

In a completed page:

• The list will simply have to be recreated. (Click here for instruction on creating an expressions list.)
• When making the list, first try just a few expressions and then save. Make sure that the expressions are saving properly - that they (1) appear on the page in view mode and (2) are highlighting in the quotes. If not, you will need to report it as a bug.

Expressions list does not appear in view mode:

• If your list appears in compile mode/page facts but not in view mode (after you save your work), this should be reported as a bug.

Expression not highlighted in a quote

This usually means that the exact expression that should be highlighted is not actually on the expressions list. This is generally due to one of two reasons:

• Expression not entered when the page was created/compiled
  • To fix this, simply add the expression to the list (click here for instructions on adding expressions).

• Presence of additional punctuation or spacing

The words in the expression may appear on the list, but they contain extra punctuation or spacing (or lack thereof) that is causing Wiki to read them as something other than what is actually present in the quote.

VedaBase does not read punctuation or spaces. For example, a VedaBase query for the expression "self-realization" would return hits for both "self realization" and "self-realization". Wiki, on the other hand, reads everything. It would see "self-realization" and "self realization" as two different expressions.

Troubleshooting:

• Check for punctuation in the expression - commas, hyphens, periods, etc.
  • To fix the problem: add the expression to the expressions list exactly 'as it is'. (For instruction on creating/adding to the expressions list, click here.)
• In some cases, the problem is with extra spaces present in the expression as it has been entered into the expressions list. (This has happened with some of the older, converted pages.)
  • To fix: Check the expressions list in the page facts tab of the compiling tools. If the expression in question contains a space - typically preceding the expression - you will need to delete that expression and re-enter it (without the extra space).

Click here for instruction on adding/deleting expressions.

• Special note regarding question marks [?]:
  • If an expression has been entered with a question mark at the end, it will not highlight.
  • Solution: delete the ending question mark.
  • (Note that question marks inside of expressions are okay; they do not affect highlighting.)

Vanisource reference errors

Be alert for the following:

What to look for	What it means	Example/How to fix it
Reference citation appears immediately following the quote text	Vanisource reference is incorrect	(Click here)
Quotes that read like translations, but are formatted as purports	Conversion error (Click here for more information)	(Click here)
Vanisource reference highlighted in pulsating red	Reference not found with system conversion	(Click here)

For other reference errors, make a note and contact your Vanitutor.

Incorrect reference

This error can occur when copying from the very end of a text in VedaBase. If the compiler highlights too much 'space' beyond the end of the text, the VedaBase 'copy with reference' function will read the reference data for the next text, not the one from which the quote was taken.

What happens in Vaniquotes? The quote will copy correctly, but the Vanisource reference will register as the text immediately following the one intended (e.g. SB 5.23.4 instead of SB 5.23.3).

Recognizing the error

• Fortunately, there is a way you can tell during editing that this has happened. You will see the same reference citation (the Vanisource reference) added at the end of the quote, like this:

SB 5.23.4, Purport: The scientists can falsely, improperly declare that there is no God, but this is not a fact.

SB 5.23.4

How to fix an incorrect reference

• The easiest thing to do is simply to recompile the quote (and get the correct reference). Delete the quote, save the page. Locate the quote again in VedaBase; compile and save.

(For those who are familiar and/or comfortable dealing with code - this can also be fixed via the page's edit tab. All that is required is that the reference be changed to the correct one in all affected areas (i.e. the link text as well as the view text). The stray citation at the end of the quote should be deleted also (along with the code surrounding it).)

Translations incorrectly formatted as purports

This is an error that occurred when some of the older pages (compiled prior to October 2009) were migrated to the new system. For more recent pages, this means in the first one (or few) quotes on the page. For pages completed earlier, it could happen with any and all translation quotes in the page.

This error affects both translation-only quotes and translation-and-purport quotes. Translations will not be bolded and will read "Purport"; translation-purport quotes will read "Purport" and appear as two paragraphs (with no bolding).

Recognizing the error

As you view the quote, you might notice that something seems odd.

• The quote might appear at first glance to be too short for a purport, for instance, or it might contain two paragraphs that don't seem like they belong to one purport.

More particularly,:

• As an experienced compiler who is familiar with Srila Prabhupada's works, you will likely be able to tell whether the quote involves a translation simply by the nature of the wording, even if you are not familiar with many slokas.

For example -

My dear boy, I have already selected the following places for your residence: the heart, the senses, the air of life, the sky, the air, the fire, the water, the earth, the sun, the moon and austerity.

This is a translation (SB 3.12.11).

The following two are from a purports:

A conditioned soul is under the influence of mental speculation. However great one may be in the estimation of mundane education and learning, he cannot be free from the influence of psychic activities. Therefore it is very difficult to give up lust and the desires for low activities until one is in the line of devotional service to the Lord. (SB 3.12.26, Purport)

Although one of the three modes of material nature is always prominent, they are never represented unalloyed by one another. Even in the most prominent existence of the two lower qualities, the modes of passion and ignorance, there is sometimes a tinge of the mode of goodness. (SB 3.12.27, Purport)

This is but one example. Do you get the sense of a difference?

If you suspect that a quote marked "Purport" is actually a translation:

• Go into compile mode and look at the quote.
• If you see one set of double quotation marks (inverted commas) showing up for no reason only at the end of the quote, you will know that the error has occurred.

How to fix the translation formatting error

For translation-only quotes:

Change the section.

• Go to the quote (in compile mode) and select "edit section".

Select the correct section ("translation" or "translation and purport").

• Check for errors involving quotation marks(inverted commas)
  • For texts which are quotations, look for incorrect conversion of singles into doubles. Corrections can be made using the edit window ("edit quote", make the change, and "update").
  • For all texts, look for a set of unnecessary quotation marks at the end of the quote. This is part of the error which will need to be deleted. (Go into the edit window - "edit quote", make the change, and "update".)

For translation-and-purport quotes:

Delete and recompile the quote.

• Locate the quote in VedaBase.
• Go back to the page and delete the incorrectly formatted quote.
• Go back to VedaBase and compile the quote into the page again.

Reference not found/view mode (highlighted in red)

These are quotes for which the Vanisource reference could not be found upon conversion of the page from the old system to the new one. The reference will be highlighted in pulsating red to indicate the error.

To fix the error, recompile the quote.

• Locate the quote in VedaBase.
• Go back to the Vaniquotes and delete the quote with the error.
• Save the page, and then go back into the compile tools.
• Compile the quote again from VedaBase. More than likely, the reference can now be found.

(Please note: each of these steps must be followed in order to successfully recompile the quote.)