A definitive list of labels?

Page 1 of 3 (55 items) 1 2 3 Next >
This post has 54 Replies | 9 Followers

Posts 13307
Forum MVP
Mark Barnes | Forum Activity | Posted: Fri, Oct 2 2015 7:19 AM

The search extensions are great, as they allow us to search much more data than we used to be able to. However, it's really hard to keep track of all the labels that Logos is using. I'm attempting to compile a complete list.

  1. Where can I find a list of official labels?
  2. Where can I find a list of attributes for each label?
  3. Where can I find a list of possible values for each attribute (where applicable)?

<edit>The list below is not up-to-date. A definitive list of official labels can now be found in the Logos 6 Help documentation.</edit>

So far I'm aware of:

  1. {Label Additional Information} — Populates the "See Also" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  2. {Label Background}  — Populates the "Background" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  3. {Label Bible Outline}   — I think this populates the "Outline" section of the Passage Guide
    • Reference
  4. {Label Book Guide} — I found this label in several resources, but it doesn't seem to be indexed. It appears to be a placeholder to point to other labels.
    • Comment
    • Reference
  5. {Label Canon} — Populates the "Canon" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  6. {Label Content}  — Populates the "Content" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  7. {Label Figure of Speech} — Documented and explained here
    • Description
    • Name
  8. {Label Form} — Populates the "Form" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  9. {Label Intertext} — Exposes the data behind the New Testament Use of the Old Testament interactive. Documentation here.
    1. Corpus
    2. Relationship
    3. Source
    4. Target
  10. {Label Journal Article} — Populates the "Journals" sections of Passage and Topic Guides
    • Title
    • Author
    • Topics
    • References
    • Date
    • Editor [not documented]
  11. {Label Lectionary Reading} — Presumably powers Lectionary functionality in various places
    • References
    • Title
  12. {Label Meaning} — Populates the "Meaning" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  13. {Label Objects} — Populates the "Objects" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  14. {Label Origin} — Populates the "Origins" section of Bible Book Guides in the Factbook
    • Reference
    • Subcategory
  15. {Label Personal Letter} — Populates the "Personal Letters" section of the Passage Guide in 6.8 beta 3 and above.
    • Author
    • Date
    • Recipient
  16. {Label Psalm} — Used in the Psalm Explorer
    • Attribution
    • Genre
    • Structure
  17. {Label Semantic Feature} — Populates the Propositional Outlines.
    • Category
  18. {Label Sermon} — Populates the "Sermons" section of Passage Guides
    • Creator
    • Title
    • Subtitle
    • Series
    • References
    • Date
    • Liturgical Date

Few of these are documented in the Logos 6 Help File. Most have never even been documented on these forums, so far as I can tell.

Posts 702
JH | Forum Activity | Replied: Fri, Oct 2 2015 7:36 AM

Great question! I have to keep a "cheat sheet" on my desk as reference whenever I run across a new label or attribute so I can keep track of them. It would be great to have them all documented in one place (Help File?) for easy reference.

Posts 1557
John Kight | Forum Activity | Replied: Fri, Oct 2 2015 7:51 AM

It would be helpful if Logos would keep a public list of all the labels.

For book reviews and more visit sojotheo.com 

Posts 1886
Donnie Hale | Forum Activity | Replied: Fri, Oct 2 2015 8:26 AM

John Kight:
It would be helpful if Logos would keep a public list of all the labels.

With 3-5 example searches of increasing complexity using each.

-Donnie

Posts 9050
Forum MVP
Mark Smith | Forum Activity | Replied: Fri, Oct 2 2015 8:55 AM

Mark, I was thinking the same thing when I was looking at Rick's example for searching Figures of Speech.

We need a simple resource in Logos that functions like a glossary for search terms. It should be in Logos not online somewhere, like the wiki. Searching is one of Logos' strong points, but it has become impossible for me to keep up with.

Pastor, North Park Baptist Church

Bridgeport, CT USA

Posts 928
Matthew | Forum Activity | Replied: Fri, Oct 2 2015 8:59 AM

Mark Smith:
It should be in Logos not online somewhere, like the wiki. Searching is one of Logos' strong points, but it has become impossible for me to keep up with.

Yes My preference would be within Help, as this is where most people would look first.

Posts 13307
Forum MVP
Mark Barnes | Forum Activity | Replied: Fri, Oct 2 2015 9:08 AM

I've reverse-engineered my datatype index, and discovered dozens more labels. I'm going to update my initial post, but it will take me a while to type it all up...

My list is as complete as I can make it now.

Posts 1264
LogosEmployee
Rick Brannan (Faithlife) | Forum Activity | Replied: Fri, Oct 2 2015 9:28 AM

Mark Barnes:
Several of these are not documented in the Logos 6 Help File.

EDIT: Keeping the below for posterity, but Eli has since corrected me that yes, we do document labels in the general help file. For interactives, the "About" page may document further searching capabilities as well. Apologies for the confusion.

----------------

Thanks, Mark. I'm sure Eli will respond to some of this, but one issue is that not all labels are available to all Logos 6 users.

Several of these are dependent on datasets that are licensed either by Logos 6 base packages or through Logos Now. For example, the label Psalm is only licensed through the dataset delivered with Logos Now; it also mirrors the book-level categories available in the Psalm Explorer interactive, in the "Overview". (Note the Proverbs label [6.7 beta], which isn't listed in the current incarnation of your post, is also reflective of the Proverbs Explorer interactive). The Figures of Speech label is also delivered with Logos Now (6.7 beta as well). So documenting them in the general Logos 6 help file isn't the best place; it would be confusing because the labels simply aren't available to everyone who would be reading that documentation.

For labels that are tied to interactives (Psalms, Proverbs, and some upcoming stuff) the interactive will be the place where they are mentioned, in the "About" dialog (note: I think Psalms needs to be updated to reflect this, and Proverbs will hopefully be updated during the 6.7 beta cycle). Generally, faceted interactives like Proverbs Explorer allow for faceting/display of interesting information associated with the text, and many times this information could provide further utility by exposing it to search. Labels are the way to do this, and as interactives develop and continue, we will, where it makes sense, pair a label with an interactive (like Psalms and Proverbs Explorers) to expose categorization data for searching.

You are correct that there is a larger issue, and it is one that I know Eli is actively considering (because he and I have talked about it).

Rick Brannan
Data Wrangler, Faithlife
My books in print

Posts 8848
Forum MVP
Bruce Dunning | Forum Activity | Replied: Fri, Oct 2 2015 9:39 AM

Mark Barnes:

The search extensions are great, as they allow us to search much more data than we used to be able to. However, it's really hard to keep track of all the labels that Logos is using.

  1. Where can I find a list of official labels?
  2. Where can I find a list of attributes for each label?
  3. Where can I find a list of possible values for each attribute (where applicable)?

Great questions Mark. Thanks for bringing this up as a topic.

Using adventure and community to challenge young people to continually say "yes" to God

Posts 791
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Fri, Oct 2 2015 9:49 AM

Rick Brannan (Faithlife):
Thanks, Mark. I'm sure Eli will respond to some of this, but one issue is that not all labels are available to all Logos 6 users.

Our strategy thus far has been to document search capabilities of a dataset within the dataset documentation resource for the dataset. It's not a perfect solution, of course, especially since we are still way behind on the backlog of documentation. We are making progress, slowly but steadily.

In the meantime, I've asked the Help team to add a quick and dirty listing of labels that can be searched in the Help resource.

Mark, don't waste time reverse-engineering your milestone indexes and posting the results, except as curiosity. You will find many labels that are used only for making certain features work (for example Propositional Outlines, which has no user-readable content in the labels) or are not yet fully implemented in such a way that they can be searched -- for example, all of the Bible Background labels, such as "Origin" and "Content", which encode their values using the BGC datatype, which isn't searchable yet.

Posts 2060
Forum MVP
Randy W. Sims | Forum Activity | Replied: Fri, Oct 2 2015 10:03 AM

Rick Brannan (Faithlife):
So documenting them in the general Logos 6 help file isn't the best place; it would be confusing because the labels simply aren't available to everyone who would be reading that documentation.

It would be much easier if they were in one place. Just tag them in the help file as Logos Now Only feature, etc. This is another way to create interest; when people browse the help and see very specifically what can be accomplished by upgrading. A central list is better for everyone as long as it's labeled.

Posts 13307
Forum MVP
Mark Barnes | Forum Activity | Replied: Fri, Oct 2 2015 10:04 AM

Thanks for the prompt response, Eli and Rick. That's really appreciated.

Eli Evans:
You will find many labels that are used only for making certain features work (for example Propositional Outlines, which has no user-readable content in the labels) or are not yet fully implemented in such a way that they can be searched -- for example, all of the Bible Background labels, such as "Origin" and "Content", which encode their values using the BGC datatype, which isn't searchable yet.

Actually, because I'm looking at my index, I can't see the things that aren't searchable yet, so apart from "Book Guide" (which I think is what you're referring to, and I stumbled across in the info panel), everything in my list is usable at the moment.

But that at least explains why it's not searchable!

Posts 13307
Forum MVP
Mark Barnes | Forum Activity | Replied: Fri, Oct 2 2015 10:10 AM

Rick Brannan (Faithlife):
The Figures of Speech label is also delivered with Logos Now (6.7 beta as well). So documenting them in the general Logos 6 help file isn't the best place; it would be confusing because the labels simply aren't available to everyone who would be reading that documentation.

I don't agree with this. You already document features that are only available to people with certain base packages, such as syntax searching. As Randy says, it's much easier for us if it's all in one place. If you really don't want to do that, please considering at least having links in the help file to the Logos Now dataset documentation.

Rick Brannan (Faithlife):
(Note the Proverbs label [6.7 beta], which isn't listed in the current incarnation of your post, is also reflective of the Proverbs Explorer interactive)

This doesn't appear to be available in beta 1. I can't see it either in the info panel, or in search.

Posts 791
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Fri, Oct 2 2015 10:16 AM

Mark Barnes:
Actually, because I'm looking at my index, I can't see the things that aren't searchable yet, so apart from "Book Guide" (which I think is what you're referring to, and I stumbled across in the info panel), everything in my list is usable at the moment.

#facepalm ... nevermind, yes. Still, just because they're in the index doesn't mean they have (or are supposed to have) all the UI necessary to be searchable. We ferret away all kinds of data in the fulltext index to make various parts of the application work, sometimes with the intention of eventually making it visible to the search UI, and sometimes not.

For example, the fact that the Bible Book Guide labels appear in the information panel now as opposed to some point in the future is an unintended consequence of the recent overhaul of the Information tool. But now that they're exposed, we should take care to bring them up to functional parity.

Mark Barnes:
But that at least explains why it's not searchable!

Quite. 

Posts 1264
LogosEmployee
Rick Brannan (Faithlife) | Forum Activity | Replied: Fri, Oct 2 2015 10:23 AM

Mark Barnes:

Rick Brannan (Faithlife):
The Figures of Speech label is also delivered with Logos Now (6.7 beta as well). So documenting them in the general Logos 6 help file isn't the best place; it would be confusing because the labels simply aren't available to everyone who would be reading that documentation.

I don't agree with this. You already document features that are only available to people with certain base packages, such as syntax searching.

Thanks, Mark. This was my own misunderstanding, you are correct. I've since edited my post above.

Mark Barnes:

Rick Brannan (Faithlife):
(Note the Proverbs label [6.7 beta], which isn't listed in the current incarnation of your post, is also reflective of the Proverbs Explorer interactive)

This doesn't appear to be available in beta 1. I can't see it either in the info panel, or in search.

It may not have been delivered yet; but it should be delivered in the 6.7 beta cycle.

Rick Brannan
Data Wrangler, Faithlife
My books in print

Posts 9050
Forum MVP
Mark Smith | Forum Activity | Replied: Fri, Oct 2 2015 11:52 AM

What I hope FL is agreeing to in this thread is to provide documentation for all the new search types. Put it in the help file or in a separate glossary type resource, but we do need it.

Pastor, North Park Baptist Church

Bridgeport, CT USA

Posts 791
LogosEmployee
Eli Evans (Faithlife) | Forum Activity | Replied: Fri, Oct 2 2015 1:49 PM

Mark Smith:

What I hope FL is agreeing to in this thread is to provide documentation for all the new search types. Put it in the help file or in a separate glossary type resource, but we do need it.

We are in 100% agreement -- so much in fact that Rick and I are doing what we can right now. 

That is to say: What I'm doing right now is re-writing all of the Advanced Searching documentation that's currently in the help resource from scratch, with a list of searchable labels as part of that. (Plus more!)

Posts 8848
Forum MVP
Bruce Dunning | Forum Activity | Replied: Fri, Oct 2 2015 1:59 PM

Eli Evans:

Mark Smith:

What I hope FL is agreeing to in this thread is to provide documentation for all the new search types. Put it in the help file or in a separate glossary type resource, but we do need it.

We are in 100% agreement -- so much in fact that Rick and I are doing what we can right now. 

That is to say: What I'm doing right now is re-writing all of the Advanced Searching documentation that's currently in the help resource from scratch, with a list of searchable labels as part of that. (Plus more!)

Great to hear! Yes

Using adventure and community to challenge young people to continually say "yes" to God

Posts 9050
Forum MVP
Mark Smith | Forum Activity | Replied: Fri, Oct 2 2015 3:48 PM

Eli Evans:

We are in 100% agreement -- so much in fact that Rick and I are doing what we can right now. 

That is to say: What I'm doing right now is re-writing all of the Advanced Searching documentation that's currently in the help resource from scratch, with a list of searchable labels as part of that. (Plus more!)

Give that man a raise!

Pastor, North Park Baptist Church

Bridgeport, CT USA

Posts 570
HansK | Forum Activity | Replied: Fri, Oct 2 2015 4:06 PM

Thanks for all the work!

"Were are not all programmers", knowing all possible codes by heart. Except Mark Barnes Big Smile

Sometimes I need a search "quickly", when in a study and I do not want get distracted by all this "programming".

Suggestion: create a visible add and click search editor (something like Syntax searching) where all the options (strings) for a search can be found. And links to help on the various strings. So that all is in one place.

Hans

MacOS Sierra / Logos 7 Collector's Edition & All Base Packages / Logos Now

Page 1 of 3 (55 items) 1 2 3 Next > | RSS