I agree that using a block for this purpose is not in the spirit of the design of AsciiDoc.
Personally, I think this feature should be baked into the native AsciiDoc processor (as it is in Asciidoctor). It's as essential to writers as a sidebar, admonition, or anything else. -Dan On Tue, Jun 18, 2013 at 8:35 PM, Dan Allen <[email protected]> wrote: > This problem has been solved for AsciiDoc (perhaps not in the spirit of > AsciiDoc, but it works). > > http://codeextactor.berlios.de/codeextractor.html > > This is such an important feature for technical writers, that I've > included a way to do this natively in Asciidoctor. Right now, it's part of > the include macro. You can either line lines: > > include::{sourcesdir}/Example.java[lines=1..10;5..20;40..-1] > > (that's lines 1-10, 5-20 and 40 to the end) > > Or tags: > > include::{sourcesdir}Example.java[tags=example1] > > > I'm also planning on having a source macro that behaves like include, > except it wraps the included text in a source listing. > > source::{sourcesdir}/Example.java[tags=example1] > > (the source language can be picked from the extension, other attributes > can be specified in the normal way). > > -Dan > > > > On Tue, Jun 18, 2013 at 12:17 AM, Harry Percival <[email protected] > > wrote: > >> Another alternative might be dexy: >> >> http://www.dexy.it/ >> >> It would have to work as a layer on top of asciidoc, so you'd write dexy >> templates to generate asciidoc, which in turn would generate your final >> doc. that may be too much complexity for you, but dexy did look very >> powerful when i looked at it a few months back... >> >> hp >> >> >> On 18 June 2013 02:36, Eduardo Santana <[email protected]> wrote: >> >>> How Atlas does it: >>> >>> http://chimera.labs.oreilly.com/books/1230000000065/ch04.html#code_snippets_section >>> >>> Em segunda-feira, 11 de abril de 2011 02h21min24s UTC-3, Stuart Rackham >>> escreveu: >>>> >>>> On 09/03/11 06:58, Anders Nawroth wrote: >>>> > Hi! >>>> > >>>> > I wonder how I could integrate something along the lines of >>>> codeextractor into >>>> > asciidoc. I'd really like the inclusion of code snippets to be >>>> handled inside >>>> > the asciidoc execution, and not by pre-parsing the files before >>>> running asciidoc. >>>> > >>>> > Right now I'm using a syntax similar to this one: >>>> > >>>> > ["snippet", source="Source.java", tag="tag1"] >>>> > ---- >>>> > ---- >>>> > >>>> > What annoys me is the empty block, but I couldn't get it to work >>>> without it. Any >>>> > ideas how this could be done in a better way? >>>> > >>>> > I'd prefer a syntax close to the include:: macro, but couldn't find >>>> out if/how >>>> > that could be done. >>>> >>>> AsciiDoc filters are designed to filter paragraph or block elements, >>>> unfortunately macros don't have the ability to execute filter code. >>>> >>>> Cheers, Stuart >>>> >>>> >>>> > >>>> > >>>> > /anders >>>> > >>>> > >>>> > 2010-12-23 14:01, Ed Keith skrev: >>>> >> --- On Thu, 12/23/10, wimalopaan<wilhel...@fh-**kl.de> wrote: >>>> >> >>>> >>> From: wimalopaan<wilhel...@fh-**kl.de> >>>> >>> Subject: Extracting code snippets from source files and include them >>>> >>> To: "asciidoc"<asci...@**googlegroups.com> >>>> >>> Date: Thursday, December 23, 2010, 12:39 AM >>>> >>> Hi, >>>> >>> >>>> >>> is there a possibiliy to extract code snippets from >>>> >>> external source >>>> >>> files and include them in asciidoc documents - perhaps like >>>> >>> the boost >>>> >>> quickbook snippets? >>>> >>> >>>> >>> The following source file >>>> >>> ------- >>>> >>> #include<iostream> >>>> >>> //[main >>>> >>> int main() { >>>> >>> } >>>> >>> //] >>>> >>> ------- >>>> >>> >>>> >>> imported in quickbook and selection of the snippet [main] >>>> >>> will only >>>> >>> render the function main (with the special comments >>>> >>> removed). >>>> >>> >>>> >>> Any hints? Thanks! >>>> >>> >>>> >> >>>> >> I wrote a tool to do this. It can be found at >>>> >> https://developer.berlios.de/**projects/codeextactor/<https://developer.berlios.de/projects/codeextactor/> >>>> >> >>>> >> Hope it helps, >>>> >> >>>> >> -EdK >>>> >> >>>> >> Ed Keith >>>> >> [email protected] >>>> >> >>>> >> Blog: edkeith.blogspot.com >>>> >> >>>> >> >>>> >> >>>> >> >>>> >> >>>> >> >>>> > >>>> >>>> -- >>> 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 http://groups.google.com/group/asciidoc. >>> For more options, visit https://groups.google.com/groups/opt_out. >>> >>> >>> >> >> >> >> -- >> ------------------------------ >> Harry J.W. Percival >> ------------------------------ >> Twitter: @hjwp >> Mobile: +44 (0) 78877 02511 >> Skype: harry.percival >> >> -- >> 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 http://groups.google.com/group/asciidoc. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> >> > > > > -- > Dan Allen | http://google.com/profiles/dan.j.allen > -- Dan Allen | http://google.com/profiles/dan.j.allen -- 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 http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/groups/opt_out.
