mojavelinux / asciidoc-bootstrap-docs-backend Goto Github PK

I wanted to try this out since I'd love to write asciidoc with Bootstrap styling.

I followed the instructions, including cloning the current Bootstrap repo. It appears that Bootstrap has rearranged their tree a little bit since you wrote this plugin, and things are broken now. I got:

asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/css/bootstrap.css
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/css/bootstrap-responsive.css
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/css/docs.css
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/js/google-code-prettify/prettify.css
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/js/jquery.js
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/js/google-code-prettify/prettify.js
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/js/bootstrap.min.js
asciidoc: WARNING: manual.txt: line 5: include file not found: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/js/application.js
sh: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/img/glyphicons-halflings.png: No such file or directory
sh: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/img/glyphicons-halflings-white.png: No such file or directory
sh: /Users/haberman/.asciidoc/backends/bootstrap-docs/bootstrap/docs/assets/ico/favicon.ico: No such file or directory

I also noticed that the plugin installed itself into /Users/haberman/.asciidoc/backends/bootstrap for some reason, and I had to manually copy it into /Users/haberman/.asciidoc/backends/bootstrap-docs

I want to have a href link in the footer, supposed to be clickable as show by screenshot [1]

So i've added the :footer: attribute in source code [2], but it does not work.
Is it possible to have such behavior ?

• Laurent

[1] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/pirus_bootstrap_footer.png
[2] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/gh-3.txt

Hi @mojavelinux ,@

I am unable to install asciidoc-bootstrap-docs-backend by the following command and getting an error "asciidoctor: FAILED: missing converter for backend 'install'"

asciidoctor --backend install "D:\asciidoc\bootstrap-4.5.0.zip"

Error Details:

Traceback (most recent call last):
13: from C:/Ruby25-x64/bin/asciidoctor:23:in <main>' 12: from C:/Ruby25-x64/bin/asciidoctor:23:in load'
11: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/bin/asciidoctor:14:in <top (required)>' 10: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor/cli/invoker.rb:112:in invoke!'
9: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor/cli/invoker.rb:112:in each' 8: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor/cli/invoker.rb:129:in block in invoke!'
7: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1595:in convert_file' 6: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1595:in open'
5: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1595:in block in convert_file' 4: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1479:in convert'
3: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1367:in load' 2: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor.rb:1367:in new'
1: from C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor/document.rb:490:in initialize' C:/Users/aftab.hafeez/.gem/ruby/2.5.0/gems/asciidoctor-1.5.8/lib/asciidoctor/document.rb:1083:in update_backend_attributes': asciidoctor: FAILED: missing converter for backend 'install'. Processing aborted. (NotImplementedError)

Could you please advise how to resolve this issue.

Is it possible to add support for sidebar block [1].

Here is a screenshot of my documentation with standard html backend and flask theme [2]
And the version with bootstrap backend [3]

And chunk of source code [4]

• Laurent

[1] http://www.methods.co.nz/asciidoc/userguide.html#_sidebar_blocks
[2] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/pirus_flask.png
[3] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/pirus_bootsrap.png
[4] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/gh-2.txt

I've decided to prepare all my open-source projects websites with a bootstrap layout and with asciidoc contents, so I've begin to use the first version of bootstrap-docs backend and found :

If you use a title named "overwiew" the TOC cannot do the right job with overview entry. See my demo page [1]

The reason came from main title, that already used a overview ID

<header id="overview" class="jumbotron subhead">

So if later the TOC content a overview entry

<ul id="toc" class="nav nav-list bs-docs-sidenav affix-top">
<li>
<a href="#overview">
<i class="icon-chevron-right"></i>
Overview
</a>
</li>

It's impossible the refer to the title expected location.

I know it's not really a related bootstrap-docs backend, but could you think to use perharps a private prefix system or something else. Idea to start [3] ?

At your disposal for any other tests. I keep to continue to investigate for other study/real cases.

• Laurent

[1] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/gh-1.html
[2] http://laurent-laville.org/asciidoc/bootsrap-backend-issues/gh-1.txt (source code)
[3] http://www.methods.co.nz/asciidoc/userguide.html#_section_ids