Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
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 |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
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). |
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
You could also consider the asciidoctor-bibliography gem which separates citations from cross-references.
|
Loading... |
Reply to author |
Edit post |
Move post |
Delete this post |
Delete this post and replies |
Change post date |
Print post |
Permalink |
Raw mail |
![]() ![]() ![]() ![]() ![]() ![]() ![]() |
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. -- Dan Allen | @mojavelinux | https://twitter.com/mojavelinux |
Free forum by Nabble | Edit this page |