Good evening Stéphane

Thank you for your question :-), because GitLab makes the AsciiDoc 
integration very bad and hasn't solved reported problems for more than a 
year, I was looking for a way to display AsciiDoc documents in GitLab in a 
halfway usable way.

When I found the Chrome Extension *Asciidoctor.js Live Preview 
<https://chrome.google.com/webstore/detail/asciidoctorjs-live-previe/iaalpfgpbocpdfblpnhhgllgbdbchmia>,*
 I 
tried this workaround:

   1. By default, GitLab opens the blob-Version of an AsciiDoc File - and 
   uses an annoying renderer
   2. If one opens the raw-Version of the File, then Asciidoctor.js Live 
   Preview renders a much more useful view
   3. Therefore I tried to modify the "Table of Content AsciiDoc File" 
   which has links to every other AsciiDoc File so that a click to it opens 
   the raw version.
   
   Because AsciiDoc does not know the absolute path of a referenced File if 
   a relative link is used, I changed my workaround:
   
   4. An AsciiDoc File knows its own absolute path.
   Therefore I created the JavaScript Button which opens the blob or raw 
   file.
   
   This workaround works only in one way (as you probably already know):
      1. If GitLab renders the blob version of the AsciiDoc file, 
      JavaScript disabled :-(
      2. If Asciidoctor.js Live Preview renders the raw File, then I can 
      use the JavaScript button to switch to the blob Version, so that I can 
      start editing the File :-)
      

You're right: it's not very useful, I built on the principle of hope:
Someday, I hope, GitLab will use AsciiDoctor to render the files and create 
a simple design pattern, so that AsciiDoctor can easily be updated, so that 
we don't have to wait years for updates :-)

Kind regards,
Thomas

>

-- 
You received this message because you are subscribed to the Google Groups 
"asciidoc" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/asciidoc.
For more options, visit https://groups.google.com/d/optout.

Reply via email to