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.

Find more posts tagged with

Comments

MJ. Smith

I think its a good idea.

Mark Barnes

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.

Ken McGuire

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?

Mark Barnes

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.

Ken McGuire

If it does not break the syntax for specific labels, then indeed, it will be a convenient shorthand.

Dave Hooton

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.

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 !

Bradley Grainger (Logos)

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).

[[Str. 1 >> Clemens_alexandrinus:Clem. Al., Str. 1]]. How would this work?

This would be unchanged.

NB.Mick

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?

Bradley Grainger (Logos)

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

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. [:)]

L.A.

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).

[[Str. 1 >> Clemens_alexandrinus:Clem. Al., Str. 1]]. How would this work?

This would be unchanged.

SOUNDS GREAT! [8]