how to bypass use of [bibliography] ?

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

how to bypass use of [bibliography] ?

jvdh
while it is nice to have integrated support for special document sections such as a bibliography I would prefer to bypass it (just as with the original asciidoc) since the available functionality seems rather constraining.

here's my problem:
The original asciidoc does linking/formatting of bibliography entries independently of whether they appear in a "true" [bibliography] or an ordinary section ("== MyBibliography", say). so the example from the manual:

_The Pragmatic Programmer_ <<prag>> should be required reading for
all developers.

[bibliography]
- [[[prag]]] Andy Hunt & Dave Thomas. The Pragmatic Programmer:
  From Journeyman to Master. Addison-Wesley. 1999.
- [[[seam]]] Dan Allen. Seam in Action. Manning Publications.
  2008.

works of course but

_The Pragmatic Programmer_ <<prag>> should be required reading for
all developers.

== References
- [[[prag]]] Andy Hunt & Dave Thomas. The Pragmatic Programmer:
  From Journeyman to Master. Addison-Wesley. 1999.
- [[[seam]]] Dan Allen. Seam in Action. Manning Publications.
  2008.

does not (it shows empty pairs of brackets "[]" rather than "[prag]").

question: is there any principal reason, why asciidoctor could not handle stuff in triple brackets [[[stuff]]] and <<stuff>> references always the same, i.e. independently of whether they belong to a dedicated [bibliography] section (and also not enforcing that it happens only in list entries)?

another observation: modifying the example above to:

_The Pragmatic Programmer_ <<1>> should be required reading for
all developers.

[bibliography]
- [[[1]]] Andy Hunt & Dave Thomas. The Pragmatic Programmer:
  From Journeyman to Master. Addison-Wesley. 1999.
- [[[2]]] Dan Allen. Seam in Action. Manning Publications.
  2008.

i.e. using numerical rather than text labels seemingly breaks formatting in the bibliography (the entries are labeled verbatim with [[[1]]] rather than with single brackets). what am I missing here?

any advice on these issues would be appreciated.

thx, joerg




Reply | Threaded
Open this post in threaded view
|

Re: how to bypass use of [bibliography] ?

rockyallen
I struggled with this too, as I wanted:

See [5].

== References
[5] Pragmatic programmer.

and in the current implementation I couldn't suppress the bullet.

My (ugly) work around is to use inline anchors and hard code the numbers:

== Intro
_The Pragmatic Programmer_ [<<prag>>] should be required reading for all developers.

== References
[3] [[prag,3]]Andy Hunt & Dave Thomas. The Pragmatic Programmer:  From Journeyman to Master. Addison-Wesley. 1999

Asciidoctor-bibtex looks promising, but  I couldn't get it to work with Asciidoctorj. If you manage it, please let me know how.

Re your second question, [[[3]]] probably fails because "3" is not a valid id name (allows lower case letters, digits, periods, hyphens, underscores, but must not start with a digit).
Reply | Threaded
Open this post in threaded view
|

Re: how to bypass use of [bibliography] ?

rhtse
You could also consider the asciidoctor-bibliography gem which separates citations from cross-references.
Reply | Threaded
Open this post in threaded view
|

Re: how to bypass use of [bibliography] ?

mojavelinux
Administrator
If you don't like the built-in HTML and/or styling, you should consider the following alternatives:

* modify the CSS (for example, to hide the bullets)
* modify the HTML template (to produce different HTML); see https://github.com/asciidoctor/asciidoctor.org/issues/80
* use an extension, such as asciidoctor-bibliography

What I encourage you not to do is create non-semantic AsciiDoc that mixes content and presentation. We made Asciidoctor extensible so you didn't have to resort to those measures.

> [[[3]]] probably fails because "3" is not a valid id name (allows lower case letters, digits, periods, hyphens, underscores, but must not start with a digit).

This is now covered in the docs. See https://asciidoctor.org/docs/user-manual/#user-biblio

Cheers,

-Dan

On Tue, Sep 26, 2017 at 11:51 PM rhtse [via Asciidoctor :: Discussion] <[hidden email]> wrote:
You could also consider the asciidoctor-bibliography gem which separates citations from cross-references.


If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/how-to-bypass-use-of-bibliography-tp5764p5947.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML


--
Dan Allen | @mojavelinux | https://twitter.com/mojavelinux