Categories
Uncategorized

Tracking Translations

If you need access to this spreadsheet, contact info@suttafriends.org

link https://docs.google.com/spreadsheets/d/1xbQFSp92Ma05PxtxoPCDofefBg32S0YLoQoEuiSyY2Q/edit?usp=sharing

Categories
Uncategorized

Marking up Suttas

NOTE: Items with a * can be done by any volunteer. The other items will probably need to be done by one of the monks, but suggestions are welcome.

Formatting titles *

It’s very important that title conform to a standard. It should be

{abbreviation} {number} {Pali title} Sutta: {English title} {optional number of repetiton}

If there are several suttas in a row with the same name, just put a number after the name without parentheses or st/nd/rd/etc.

Adding special info *

When uploading suttas in bulk, we can add all the special information easily in our word processor.

Past this immediately after the title of each sutta:

#intro 
#topics 
#similes 
#names 
#furtherReading 
#explanation 
#questionForReflection 

Then you can add any relevant information. For example:

#intro We can understand the Four Noble Truths if we have concentration.
#topics concentration, Four Noble Truths, happiness
#similes mountain
#names Sariputta Arahant
#furtherReading * See also SN 56.11
#explanation
#questionForReflection What do you think it's like to live this way?

Topics, People & Similes

NOTE: If you are not familiar with our tags, you can see a list of all tags:

NOTE: Topics, People and similes are case sensitive! So Meditation and meditation will be two different topics.

Special note for people tags: For all monks and nuns who became Arahants, please put the personal name first followed by “Arahant”. For example: Sāriputta Arahant.
For other people like kings and queens. put their personal name first then king or queen. WHY? Because then they are all listed alphabetically by name. Also, see these guidelines.

Intros *

Intros are a sentence that will draw someone into reading the sutta. Sometimes they are a question that the sutta will answer. Sometimes they say briefly what the sutta is about. Some can start with “The Supreme Buddha teaches about …” but they shouldn’t all start that way. Best thing is to look at the intros as they appear on any of the table of contents pages, for example, DN, MNKhpUdItvSnpVvPv.

For very short suttas it can be difficult to give an intro. Just create something and the bhantes will check.

Further Reading

These are suttas that are related to the sutta you are preparing. Most suttas will not have a further reading section.

If the sutta for further reading actually exists on the website, you can add in the code like this:

<li><ul><a href="https:suttafriends.org/sn56.11">SN 56.11 Dhamma Cakkappavattana Sutta</a></ul></li>

and then it will look like this when imported:

Explanation

Not all suttas need an explaination.

Questions for reflection

Most suttas won’t have any questions for reflection.

Excerpt *

An excerpt is a line from the sutta that gives a good idea what the sutta is about. It should be short. When you find it, put it in [[[triple brackets]]]. Include punctuation.

If you can’t decide, then skip this step.

Verses

Each individual verse must be enclosed with % % symbols like this:

Smart Quotes & Ellipses *

Make sure that the quotation marks are curving towards the text. Also make sure that triple dots are the real elipses character (…)

If you are working in Google Docs, then add the addon “Text Cleaner” in Google Docs. Then select the text to correct and click as follows:

Footnotes *

In general, we want to avoid text in (parentheses). If the sentence can be read without the text in the parentheses, then please turn it into a footnote.

Simplly place, then put footnote tags around it:

This is the text of the sutta.[footnote]This is my footnote.[/footnote]

And it will end up looking like this:

And when they click on the number the footnote pops up:

Categories
Uncategorized

Style Sheet

If you cannot find your issue listed, please contact the bhantes to ask.

In general, we are following the guidelines in the Canadian Government style guide.

  • Avoid using semicolons. Instead, simply break into two sentences. We can use semicolons in complex lists (i.e. lists that contain items that contain comas).
  • Avoid using colons when introducing speech. For example never say
    • Then the Blessed one said to them: “Monks, there are two…”

Please notice there are different sheets (tabs at the bottom) with different types of issues.

Link to the google doc

Categories
Uncategorized

Preparing a Text for Upload

Fixing the Sutta Titles

Sutta titles need to all be contained on a single line. This will require some work to get the file ready.

First, we need to delete the chapter and section titles. We are not using them. You may be able to remove them through search and replace. But BE CAREFUL! Many times the section title is the same as a sutta title and we don’t want to delete those.

Then we need to combine the Pali line and the English line.

Each title needs to start with the letter code for the citation. In the example below, it is SN. For the SN and AN, next will come the chapter number. In this example it is 55. Then we remove the period after the citation, add a colon after the Pali name, remove the number on the English line and then combine the lines together. Presto!

Then this is what we end up with:

Then finally, we need to mark this line as Heading 1 in the word processing software. This may work differently in different software.

So it is like this:

  • Letter abbreviation
  • Space
  • Chapter number (for SN & AN)
  • Period (for SN & AN)
  • Sutta number
  • Space
  • Pali title
  • Colon
  • Space
  • English title
  • AND mark as heading 1

Fixing Quotation Marks

The SuttaCentral translations use non-standard quotation mark styles, so we need to fix this. The rule that they are breaking is:

If the same speaker continues from paragraph 1 to paragraph 2, do not put a close quote at the end of paragraph 1.

Here is an example where the speaker is different for each paragraph:

Here is an example where the same speaker continues through three paragraphs:

This is extremely common in the suttas, because an entire sutta could involve only the Supreme Buddha speaking.

Here is a page from the Middle Length Discourses where you can see paragraphs starting with an open-quote mark, but none of the paragraphs end with one. That’s because it’s all the Buddha talking.

If you have any doubts, please ask.

Nested quotation marks

As you are fixing the quotation marks according to the above rule, you will notice that sometimes the Buddha is actually quoting someone when a new paragraph starts. You will know this because the paragraph starts with a single open quotation mark. When there is a quotation within a quotation, the quotation inside uses single quote marks:

This can get complicated, because there are times when there is a quotation within a quotation within a quotation. In that case they just alternate between double and single

“… ‘… “… ‘…’ …” …’ …”

Tricky!! When in doubt, ask. As a general rule, there will never be a situation where a paragraph starts with a single open quote. In that situation there will always have been someone reporting this speech, therefore there needs to be a double quote in front of it.

NOTE: Do not put a space between double and single quotation marks. It’s true that it will just look like three single marks. Don’t worry.

Categories
Uncategorized

How to Index Similes

Namo Buddhaya!

Choose the simile to index

Start by going to the Simile Index page, suttafriends.org/simile-index/

Find a simile that has not been indexed.

Click on the word to index:

This will take you to what is called the archive page. For “bubble” the archive page url is suttafriends.org/simile/bubble/

This page will have the simile keyword at the top and a list of the suttas that have been tagged with it. In this case there is only one:

Click on the sutta opening it in a new tab.

Find the simile in that sutta

In this situation, it is the world that is being described by calling it like a bubble. The quality they both share is that they are subject to destruction.

First we need to write the citation. In this situation it is

Dhp v170

Then we need a description. For this, we have to mention the world and that it is unstable. Keep the descriptions short but meaningful. People should know what the simile is about by reading the description.

Dhp v170 The world is unstable

Next we have to find the link to the exact spot of the simile. For numbered verses it simple. We take the url for the page and add #v170 because it is verse 170.

suttafriends.org/sutta/dhp13/#v170

If there is no verse number, then an anchor has to be added to the page.

NOTE: The steps below can only be followed if you have editing access. If you don’t have that, then simply list

  • Keyword (bubble)
  • Citation and description (Dhp v170 The world is unstable)
  • URL (suttafriends.org/sutta/dhp13/#v170)

and send it to be reviewd and entered.


Add an anchor to the page

When you are logged into your account, click on “Edit Sutta” for the page you need to add an anchor to.

Once you are in the editor, find the paragraph you want to link to and click on the + button above it.

Then start to type the name of the anchor block in the search bar. Then pick the block.

Then type in the name of the anchor. It should be the same as the index word for the simile. If it is a two word anchor, put a hyphen between the words.

If there are going to be more than one index item (in the example below we would also index for “gatekeeper”) only put one anchor and use for all.

Then click Update.

So the url for the cat simile in this sutta would be

suttafriends.org/sutta/dn28/#cat

Adding the index item to the archive page

Next we need to edit the tag itself. When you are on the archive page (in the bubble example the url is suttafriends.org/simile/bubble/) click

Now we will add the index item in the description of the simile tag. We style them as unordered lists.

Then select the citation and click the add link icon

Then paste the link, making sure to use the anchor. Click “Apply.”

Then it will look like this:

When you click on a blank space, the citation will be blue and underlined.

Then finally we have to click “Done” at the very bottom of the screen:

What we DO NOT index

We are only indexing similes that illustrate a Dhamma point. For example, we will not tag or index these:

bamboo
https://suttafriends.org/sutta/pv1-11/
Our children are now very happy because they practiced generosity, but we are suffering like withered bamboo reeds.

bird call
https://suttafriends.org/sutta/dn30/
is as sweet as the bird kuraweeka’s call

https://suttafriends.org/sutta/thag21-1/
His voice is sweet like the sound of the myna bird.

The Therigatha verses of Arahant Ambapālī will not be indexed as similes because they are describing physical features, not Dhamma points.