Finding the right datatype name and reference
If you are creating a Personal Book, you will probably need to specify milestones and datatype links. This page is designed to help you find the names of the datatypes you need for this task.
You can create milestones and datatype links for any of the datatypes that exist in Logos, although you can’t create new datatypes. To be able to insert a milestone or datatype link, you need to know both the datatype name and the exact reference. For this you need to own a resource that supports that datatype, or own another resource that points to that datatype.
If you own a resource that supports that datatype
For example, imagine you wanted to create a datatype link to Josephus’ Wars where he mentions Bethel.
First, you obviously need to locate the right place in Wars. If you already know the name of the datatype, then finding the name of the reference is easy because it is displayed in the reference box at the top of the resource (in this case it’s Wars of the Jews 4.551 or Wars IV, ix 9). Most books (including Josephus) support multiple datatypes, and clicking on the reference box will allow you to switch between the different datatypes. Make sure you choose the correct reference for the datatype you are using. If you’re not sure which references matches your datatype, you’ll need to follow the instructions below, which assume you don’t know the datatype.
If you don’t already know the name of the data type, or you don’t know which reference matches your preferred datatype then we need to do a bit more digging. Click on the resource menu (the book cover with the drop-down arrow), and copy the current location to the clipboard. You can use any format except HTML, but for consistency with resource links it’s best to use the Wiki format.
Now, paste the resulting link into your Personal Book. It will look like this: [[Wars of the Jews 4.551 >> logosres:josephus;ref=JosephusLoeb.Wars_4.551]] .
That’s not a datatype link, that’s a resource link. But we can convert it into a datatype link (or a milestone), by extracting the bit after ref= and before the semicolon or two sqaure brackets, and deleting everything else. In this case, we’re left with JosephusLoeb.Wars_4.551. Now, replace any underscores after the period with a space (so Wars_4.551 becomes Wars 4.551). The bit before the first period is the datatype name (in this case JosephusLoeb). The bit after the period is the reference (Wars 4.551).
To construct our datatype link, we use the syntax above: [[label >> datatype:reference]]. If we’ve followed the method above, we’ll have the datatype and reference separated by a period. So to get the syntax we need, we replace this period with a colon, wrap the whole thing in double square brackets, and optionally add a label (if so, we also add two right-angle brackets as a separator). So, in this case we end up with [[Bethel >> JosephusLoeb:Wars 4.551]]
- If you’re struggling to find the exact syntax, you can ask for help in the Community forums.
- Several resources include multiple datatypes, often for the same location. This is to ensure the widest possible support. Josephus and the Qumran scrolls, for example, both have two different reference schemes each with its own datatype. Some books will use one referencing system, other books another, but Logos supports them both. So before you copy your location to the clipboard, make sure the correct datatype shows in the resource location box. For Josephus that gives us a choice between JosephusLoeb.Wars_4.551 or JosephusWhiston.Wars_IV,_ix_9. (If you don’t understand the differences between the datatypes listed, don’t worry – just pick the one that looks right to you, or that is more precise. It’s very likely both will work in a very similar way.)
- Occasionally you can come across links that include a $ character, following by a hexadecimal number (e.g. logosres:diodhist01-05gk;ref=Diodorus$5Fsiculus.D._S.,_Hist._1.2.2). These codes indicate that there is a special character, and you need to replace the code with that special character ($5F is an underscore character). If you’re not sure what character to use, there are instructions here, or just ask in the forums.
If you own a resource that points to that datatype
If you don’t own the resource you want to link to, but you do own another resource that links to the same or a very similar spot, it’s possible to work out the datatype and reference you will need. In this example, imagine that you don’t own a resource that contains the Laws of Hammurabi. But you do own the Anchor Yale Bible Dictionary, and noticed that the article on Law (Biblical and ANE Law) contained a link to laws 1, 3 and 4. You also want to create a link to law 1, in your PB.
First, find the datatype link that you want to replicate in your PB. (Although you can search for these links using Logos’ search facility, you can only use the search if you know the right syntax, and at the moment you don’t!)
Then right click on the link, choose the datatype you’re interested in from the right-hand side of the right click menu (in this example, it’s The Law of Hammurabi) and then choose Search this resource from the left-hand side of the menu.
That will open a search window, and the syntax of the search will tell you all you need to know. In this example, the search syntax is <HammurabiLaws = Hammurabi 1>. We’re interested in what’s inside the angle brackets. The datatype is to the left of the equals sign (HammurabiLaws). The reference is to the right of the equals sign (Hammurabi 1).
If we were creating a datatype link to this location, we would therefore use the syntax [[see the first of Hammurabi’s laws >> HammurabiLaws:Hammurabi 1]].
- Using this method sometimes produces slightly different reference names than the method referred to above. That’s because Logos often has an abbreviated and full version of a reference (just like 1 Corinthians and 1 Cor and abbreviated and full versions of Bible references). The first method extracts the abbreviated version, and this method extracts the full version. Both the abbreviated and full version work in just the same way.
- You can also use this method as an alternative to the first if you own a resource that supports the datatype. Instead of right-clicking on a link, right-click in the text itself, and choose the correct reference from the right-hand side of the right-click menu, and search this resource. Then follow step 3, above.