Eloquent - Revision history

N Reid: re-order

2013-01-06T16:02:15Z

re-order

← Older revision		Revision as of 16:02, 6 January 2013
Line 218:		Line 218:

	Now, you may ask if there is a keyboard shortcut. I don't remember if Nisus Writer Pro comes with one by default, but my copy uses Shift-Command-H. This is easy to add. First open Nisus' Preferences, and find the Menu Keys Preference Pane. Navigate to the "Insert" menu, and find the "Hyperlinks" sub-menu, and then the "Add link..." menu item, and add the keyboard shortcut you prefer.		Now, you may ask if there is a keyboard shortcut. I don't remember if Nisus Writer Pro comes with one by default, but my copy uses Shift-Command-H. This is easy to add. First open Nisus' Preferences, and find the Menu Keys Preference Pane. Navigate to the "Insert" menu, and find the "Hyperlinks" sub-menu, and then the "Add link..." menu item, and add the keyboard shortcut you prefer.

	~~=Credits=~~
	~~This page was written by CATUG Board member [[Jon Glass]] in February–April 2011.~~

	= External Links =		= External Links =
Line 226:		Line 223:

	*[http://www.eloquent-bible-study.eu/ New Eloquent Home]		*[http://www.eloquent-bible-study.eu/ New Eloquent Home]

			=Credits=
			This page was written by CATUG Board member [[Jon Glass]] in February–April 2011.

	[[Category:Bible Software]]		[[Category:Bible Software]]

N Reid: /* Digging deeper */ sp

2011-11-16T21:42:19Z

Digging deeper: sp

← Older revision		Revision as of 21:42, 16 November 2011
Line 171:		Line 171:

	==== Hot links within Personal commentary modules ====		==== Hot links within Personal commentary modules ====
	We have already discussed how you create hot-links from within the Notes editor. But you can also create them from ~~withing~~ the personal commentary module. However, the method for creating personal links while editing commentary modules is much different than from within Notes. The method for creating links within a personal commentary is done using Sword's url syntax. That's right, url syntax. In other words, you create a link, just like you would for a web page within html code. This may scare you at first, but honestly, it is very simple once you learn the syntax. The syntax, while simple, does need to be exact. A seemingly minor error (like forgetting to end a url with the quotation marks) can spell disaster, with further notes not appearing at all, in a worst-case scenario.		We have already discussed how you create hot-links from within the Notes editor. But you can also create them from within the personal commentary module. However, the method for creating personal links while editing commentary modules is much different than from within Notes. The method for creating links within a personal commentary is done using Sword's url syntax. That's right, url syntax. In other words, you create a link, just like you would for a web page within html code. This may scare you at first, but honestly, it is very simple once you learn the syntax. The syntax, while simple, does need to be exact. A seemingly minor error (like forgetting to end a url with the quotation marks) can spell disaster, with further notes not appearing at all, in a worst-case scenario.

	Here is the syntax:		Here is the syntax:
Line 178:		Line 178:
	Here is the breakdown of what you see:		Here is the breakdown of what you see:

	"a href" means that the following text is a url link. You will notice that this begins with an open caret. Next, you will see the equal sign and a quote mark. After those two, you will see the actual link. It has to start with the "sword://" part. Next, you would need to replace the "[Bible version short name]" with the short name for the version you want to use. You can find this in the Bible texts section in the left sidebar. The text you see there is what you will want to use. Some that I have are ESV, KJV, WEB, NET, WHNU and Tyndale. Next, after the "/" character, is the [reference], which you replace with the scripture reference you want. Unfortunately, in the personal commentary section, I have been unable to enter more than one verse or verse range (eg. John 1:1-18) in a reference at a time. So it seems you will need to enter each chapter and verse separately. However, it is worth experimenting and seeing what you can squeeze out. After the verse reference, is a closing quote and closing caret. These are '''essential'''. Do not forget them! After that, you enter your title, which should be the reference again, but you can give it another title if you wish. I have had mixed results with this. If I have to go back and edit later, sometimes the title I've given a reference has been replaced with the default verse reference. At the very end, you need to also ad the "/a" surrounded by the carets. This closes the "a href" code, and makes the link work. Again, DO NOT forget to add this!		"a href" means that the following text is a url link. You will notice that this begins with an open caret. Next, you will see the equal sign and a quote mark. After those two, you will see the actual link. It has to start with the "sword://" part. Next, you would need to replace the "[Bible version short name]" with the short name for the version you want to use. You can find this in the Bible texts section in the left sidebar. The text you see there is what you will want to use. Some that I have are ESV, KJV, WEB, NET, WHNU and Tyndale. Next, after the "/" character, is the [reference], which you replace with the scripture reference you want. Unfortunately, in the personal commentary section, I have been unable to enter more than one verse or verse range (e.g. John 1:1-18) in a reference at a time. So it seems you will need to enter each chapter and verse separately. However, it is worth experimenting and seeing what you can squeeze out. After the verse reference, is a closing quote and closing caret. These are '''essential'''. Do not forget them! After that, you enter your title, which should be the reference again, but you can give it another title if you wish. I have had mixed results with this. If I have to go back and edit later, sometimes the title I've given a reference has been replaced with the default verse reference. At the very end, you need to also ad the "/a" surrounded by the carets. This closes the "a href" code, and makes the link work. Again, DO NOT forget to add this!

	Here is are some examples:		Here is are some examples:
Line 188:		Line 188:
	<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>		<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>

	A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" and the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for ~~you--adding~~ in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.		A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" and the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you–adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.

	==== Summary ====		==== Summary ====

N Reid: /* Credits */ take out "work in progress"

2011-11-16T21:38:15Z

Credits: take out "work in progress"

← Older revision		Revision as of 21:38, 16 November 2011
Line 220:		Line 220:

	=Credits=		=Credits=
	This page ~~is a work in progress~~ written by ~~CMUG~~ Board member [[Jon Glass]] in February–April 2011.		This page was written by CATUG Board member [[Jon Glass]] in February–April 2011.

	= External Links =		= External Links =

N Reid: /* Hot links within Personal commentary modules */ sp

2011-11-16T21:36:11Z

Hot links within Personal commentary modules: sp

← Older revision		Revision as of 21:36, 16 November 2011
Line 188:		Line 188:
	<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>		<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>

	A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" ~~nad~~ the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.		A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" and the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.

	==== Summary ====		==== Summary ====

Krakowian: /* Using hot links in Nisus */

2011-04-15T19:44:58Z

Using hot links in Nisus

← Older revision		Revision as of 19:44, 15 April 2011
Line 203:		Line 203:

	==== Using hot links in Nisus ====		==== Using hot links in Nisus ====
			First of all, we need to remember the syntax necessary for creating the hyperlinks that will open Eloquent. The syntax is typical html code:<code>

			<a href="sword://[BibleVersionShortName]/[Reference 1:1">Link Title</a></code>

			And an example:

			<code> <a href="sword://KJV/John 1:1">John 1:1</a></code>

			Now, let's create this link in Nisus Writer.

			The first step is to write what will be your link title: John 1:1.

			Next, we will select this reference. Once the text is selected, we go to the "Insert" menu. At the bottom of this menu, you will see the "Hyperlinks" sub menu. The very first item in the sub-menu is "Add Link..." Choosing that pops up an drop-down pane where you can enter the actual link, and its link title. (The nomenclature in Nisus Writer Pro is "Link destination" and "Display text" Into the top field is where we enter the html code, and the bottom field is where you enter the link title (reference, or whatever you want). Now, when you've highlighted the text before invoking the "Insert Link" menu item, the bottom field will already be filled out for you. Enter your link, and click on the "Insert" button, and your hot link is now inserted into your text.

			Now, you may ask if there is a keyboard shortcut. I don't remember if Nisus Writer Pro comes with one by default, but my copy uses Shift-Command-H. This is easy to add. First open Nisus' Preferences, and find the Menu Keys Preference Pane. Navigate to the "Insert" menu, and find the "Hyperlinks" sub-menu, and then the "Add link..." menu item, and add the keyboard shortcut you prefer.

	=Credits=		=Credits=

Krakowian: /* Hot links from other programs */

2011-04-13T06:44:25Z

Hot links from other programs

← Older revision		Revision as of 06:44, 13 April 2011
Line 197:		Line 197:

	Since my main word processor application is Nisus Writer Pro, I have found this feature to be an essential tool for when I am writing. I can enter Scripture references as I go, and quickly look up a verse reference as I need it. What makes Nisus especially powerful, however, is that while on-screen the hyperlinks are colored and underlined, when I print, these are not visible. The Scripture reference looks just like the surrounding text, so for my own use, I have the hot links, but for printing, I have perfect and normal printout.		Since my main word processor application is Nisus Writer Pro, I have found this feature to be an essential tool for when I am writing. I can enter Scripture references as I go, and quickly look up a verse reference as I need it. What makes Nisus especially powerful, however, is that while on-screen the hyperlinks are colored and underlined, when I print, these are not visible. The Scripture reference looks just like the surrounding text, so for my own use, I have the hot links, but for printing, I have perfect and normal printout.

			I have also had success with the sword url working in DevonThink products, TextEdit, and pdfs in Preview. If you are able to get this to work in other applications, we would encourage you to add your contribution to this section of the page, or at least contact the editors so they can add in your contribution. Some other word processors that immediately come to mind that are worth learning about are Mellel, Mariner Write and Microsoft Office. We would appreciate contributions regarding these programs.

			Unfortunately, it seems that Pages has a very limited ability to enter hyperlinks, allowing only web pages, emails, bookmarks within a document or to other Pages documents. There does not seem to be any ability to link to other resources (even such as ftp urls!). If you figure out a way to get the sword:// url to work in Pages, please edit this page to share how you get it to work.

	==== Using hot links in Nisus ====		==== Using hot links in Nisus ====

Krakowian: /* Hot links from other programs */

2011-04-12T09:51:33Z

Hot links from other programs

← Older revision		Revision as of 09:51, 12 April 2011
Line 194:		Line 194:

	=== Hot links from other programs ===		=== Hot links from other programs ===
			This feature is one feature that really sets Eloquent apart from all the competition in the Mac market. As far as I know, no other Bible software offers this option. To summarize, this feature allows you to add a url hyperlink into just about any application that allows hot links, and then be able to click on that link to open up Eloquent to the desired location in just about any Sword module that you have in Eloquent (certainly any that uses Scripture references). More useful is that if someone else has a Sword Project application installed, and the same module, they can also open the link.

			Since my main word processor application is Nisus Writer Pro, I have found this feature to be an essential tool for when I am writing. I can enter Scripture references as I go, and quickly look up a verse reference as I need it. What makes Nisus especially powerful, however, is that while on-screen the hyperlinks are colored and underlined, when I print, these are not visible. The Scripture reference looks just like the surrounding text, so for my own use, I have the hot links, but for printing, I have perfect and normal printout.

			==== Using hot links in Nisus ====

	=Credits=		=Credits=

Krakowian: /* Hot links within Personal commentary modules */

2011-04-12T09:36:06Z

Hot links within Personal commentary modules

← Older revision		Revision as of 09:36, 12 April 2011
Line 178:		Line 178:
	Here is the breakdown of what you see:		Here is the breakdown of what you see:

	"a href" means that the following text is a url link. You will notice that this begins with an open caret. Next, you will see the equal sign and a quote mark. After those two, you will see the actual link. It has to start with the "sword://" part. Next, you would need to replace the "[Bible version short name]" with the short name for the version you want to use. You can find this in the Bible texts section in the left sidebar. The text you see there is what you will want to use. Some that I have are ESV, KJV, WEB, NET, WHNU and Tyndale. Next, after the "/" character, is the [reference], which you replace with the scripture reference you want. Unfortunately, in the personal commentary section, I have been unable to enter more than one verse or verse range (eg. John 1:1-18) in a reference at a time. So it seems you will need to enter each chapter and verse separately. However, it is worth experimenting and seeing what you can squeeze out. After the verse reference, is a closing quote and closing caret. These are ~~_essential_~~. Do not forget them! After that, you enter your title, which should be the reference again, but you can give it another title if you wish. I have had mixed results with this. If I have to go back and edit later, sometimes the title I've given a reference has been replaced with the default verse reference. At the very end, you need to also ad the "/a" surrounded by the carets. This closes the "a href" code, and makes the link work. Again, DO NOT forget to add this!		"a href" means that the following text is a url link. You will notice that this begins with an open caret. Next, you will see the equal sign and a quote mark. After those two, you will see the actual link. It has to start with the "sword://" part. Next, you would need to replace the "[Bible version short name]" with the short name for the version you want to use. You can find this in the Bible texts section in the left sidebar. The text you see there is what you will want to use. Some that I have are ESV, KJV, WEB, NET, WHNU and Tyndale. Next, after the "/" character, is the [reference], which you replace with the scripture reference you want. Unfortunately, in the personal commentary section, I have been unable to enter more than one verse or verse range (eg. John 1:1-18) in a reference at a time. So it seems you will need to enter each chapter and verse separately. However, it is worth experimenting and seeing what you can squeeze out. After the verse reference, is a closing quote and closing caret. These are '''essential'''. Do not forget them! After that, you enter your title, which should be the reference again, but you can give it another title if you wish. I have had mixed results with this. If I have to go back and edit later, sometimes the title I've given a reference has been replaced with the default verse reference. At the very end, you need to also ad the "/a" surrounded by the carets. This closes the "a href" code, and makes the link work. Again, DO NOT forget to add this!

	Here is are some examples:		Here is are some examples:
Line 188:		Line 188:
	<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>		<code><a href="sword://PL_BW/Mat 6:33">Ewangelia Mateusza 6, 33</a></code>

	A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" nad the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.		A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" nad the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.

	==== Summary ====		==== Summary ====

Krakowian: /* Summary */

2011-04-12T09:35:18Z

Summary

← Older revision		Revision as of 09:35, 12 April 2011
Line 191:		Line 191:

	==== Summary ====		==== Summary ====
	The personal commentary feature is quite useful and powerful, once you learn how to enter Scripture references. Do this a few times, and the html code necessary to use will become second nature. But the best part about learning to use the "a href" code stems from the fact that you can use this in ~~_any_~~ program that allows entering url hotlinks! But we will discuss that in the next section.		The personal commentary feature is quite useful and powerful, once you learn how to enter Scripture references. Do this a few times, and the html code necessary to use will become second nature. But the best part about learning to use the "a href" code stems from the fact that you can use this in ''any'' program that allows entering url hotlinks! But we will discuss that in the next section.

	=== Hot links from other programs ===		=== Hot links from other programs ===

Krakowian: /* Personal Commentary */

2011-04-12T09:32:19Z

Personal Commentary

← Older revision		Revision as of 09:32, 12 April 2011
Line 190:		Line 190:
	A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" nad the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.		A couple notes about the references above: In the second reference, you will see an odd bit of text added between the "Rom" nad the verse numbers. ("%20"). This is html code and represents the space character. url links are not allowed to contain a space character, so this is necessary for the link to work. However, Eloquent will actually perform this service for you--adding in this code, so you don't have to. I added it here so you can see what your link will look like properly formatted. In the third link, I have referenced a Polish Bible, and in the title wrote my verse reference in Polish, with Polish verse notation. This is to show that one need not write the title in English, or even write the reference. That said, as I mentioned above, this feature is a bit buggy, and I have found my titles changed back to English verse notation for a reference on occasion.

	===== Summary =====		==== Summary ====
	The personal commentary feature is quite useful and powerful, once you learn how to enter Scripture references. Do this a few times, and the html code necessary to use will become second nature. But the best part about learning to use the "a href" code stems from the fact that you can use this in _any_ program that allows entering url hotlinks! But we will discuss that in the next section.		The personal commentary feature is quite useful and powerful, once you learn how to enter Scripture references. Do this a few times, and the html code necessary to use will become second nature. But the best part about learning to use the "a href" code stems from the fact that you can use this in _any_ program that allows entering url hotlinks! But we will discuss that in the next section.