Personal Book syntax change question (from Logos)
In Personal Books, this syntax produces the following output:
On page [[Page:123]], I discussed [[GreekStrongs:G3056]] in [[Bible:Jn 1:1]].
The words are hyperlinked, but the data type name is still included in the output. I'd like to change this so it simply produces:
The hyperlinks would still be generated, but the data type aliases would be suppressed in the resource text. You can currently achieve this output by using the following syntax, but it seems pointlessly redundant:
On page [[123 >> Page:123]], I discussed [[G3056 >> GreekStrongs:G3056]] in [[Jn 1:1 >> Bible:Jn 1:1]].
This would be a breaking change to the Personal Book Compiler, so I wouldn't make it lightly. On the other hand, it doesn't seem like the current syntax would be getting used much, because its output isn't very useful.
Would this be a welcome change that makes authoring personal books easier and more efficient? (If there have been past threads requesting this, I don't remember them, sorry.)
If there are compelling objections to this change, please let me know.
Comments
-
I think its a good idea.
Orthodox Bishop Alfeyev: "To be a theologian means to have experience of a personal encounter with God through prayer and worship."; Orthodox proverb: "We know where the Church is, we do not know where it is not."
0 -
This makes a lot of sense. It wouldn't affect any of the books I've already created, but it might make future books easier to create.
This is my personal Faithlife account. On 1 March 2022, I started working for Faithlife, and have a new 'official' user account. Posts on this account shouldn't be taken as official Faithlife views!
0 -
In general I like the simplicity of the proposed syntax. But there are times when I have liked linking a quote/phrase instead of just the reference, or the text would only give part of reference... eg. "In his Apology, Justin Martyr discusses Christian worship in chapter 61." With the old tagging system I could easily insert [[chapter 61 >> justinmartyr:1 Apol. 61]]. How would this work with your proposed syntax?
And of course you would need some form of syntax for reference links instead of type ones...
And then there are is the arcane syntax for some datatypes... eg. [[Str. 1 >> Clemens_alexandrinus:Clem. Al., Str. 1]]. How would this work?
The Gospel is not ... a "new law," on the contrary, ... a "new life." - William Julius Mann
L8 Anglican, Lutheran and Orthodox Silver, Reformed Starter, Academic Essentials
L7 Lutheran Gold, Anglican Bronze
0 -
Bradley's only suggesting a change to the default label. If you've specified a label, as in all your examples, then nothing will change.
This is my personal Faithlife account. On 1 March 2022, I started working for Faithlife, and have a new 'official' user account. Posts on this account shouldn't be taken as official Faithlife views!
0 -
If it does not break the syntax for specific labels, then indeed, it will be a convenient shorthand.
The Gospel is not ... a "new law," on the contrary, ... a "new life." - William Julius Mann
L8 Anglican, Lutheran and Orthodox Silver, Reformed Starter, Academic Essentials
L7 Lutheran Gold, Anglican Bronze
0 -
Ken McGuire said:
If it does not break the syntax for specific labels
That should be the case because we can't otherwise reproduce manuscript references accurately. And because we direct users to the label syntax I see no need to introduce any change e.g. [[GreekStrongs:G3056]] -----> [[G3056 >> GreekStrongs:G3056]] or [[Strong's Greek #3056 >> GreekStrongs:G3056]], etc.
Bradley Grainger said:This would be a breaking change to the Personal Book Compiler, so I wouldn't make it lightly.
If it ain't broke, don't fix it !
Dave
===Windows 11 & Android 13
0 -
Ken McGuire said:
With the old tagging system I could easily insert [[chapter 61 >> justinmartyr:1 Apol. 61]]. How would this work with your proposed syntax?
That tag would remain unchanged with my proposed syntax.
However, if your tag happened to be [[1 Apol. 61 >> justinmartyr:1 Apol. 61]], you would be able to simplify it to just [[justinmartyr:1 Apol. 61]] (without repeating the text of the link).
Ken McGuire said:[[Str. 1 >> Clemens_alexandrinus:Clem. Al., Str. 1]]. How would this work?
This would be unchanged.
0 -
Bradley Grainger (Logos) said:
In Personal Books, this syntax produces the following output:
On page [[Page:123]], I discussed [[GreekStrongs:G3056]] in [[Bible:Jn 1:1]].
The words are hyperlinked, but the data type name is still included in the output. (...) it doesn't seem like the current syntax would be getting used much, because its output isn't very useful.
Would this be a welcome change that makes authoring personal books easier and more efficient? (If there have been past threads requesting this, I don't remember them, sorry.)
Actually, I don't recall having seen this syntax used at all and am pretty sure I didn't use it in my self-edited PBs, I've always seen and used the [[label >> reference]] notation, which gives much greater control. I understand that is not to change, nor the milestone syntax [[@page:123]].
On the other hand, I often just build the PBs others (such as Ken) provide, and if they work well I rarely look into the docx to see which syntax was used to achieve that. Do you collect data from the PB compiler or from the files we upload in the forum, such as to be able to tell where this syntax is used at all?
Have joy in the Lord!
0 -
NB.Mick said:
Actually, I don't recall having seen this syntax used at all
It's given as an example here: https://wiki.logos.com/Personal_Books#Datatype_links
NB.Mick said:Do you collect data from the PB compiler or from the files we upload in the forum, such as to be able to tell where this syntax is used at all?
No, not currently, but that would be a good idea. [:)]
0 -
Bradley Grainger (Logos) said:Ken McGuire said:
With the old tagging system I could easily insert [[chapter 61 >> justinmartyr:1 Apol. 61]]. How would this work with your proposed syntax?
That tag would remain unchanged with my proposed syntax.
However, if your tag happened to be [[1 Apol. 61 >> justinmartyr:1 Apol. 61]], you would be able to simplify it to just [[justinmartyr:1 Apol. 61]] (without repeating the text of the link).
Ken McGuire said:[[Str. 1 >> Clemens_alexandrinus:Clem. Al., Str. 1]]. How would this work?
This would be unchanged.
SOUNDS GREAT! [8]
0
