Hello Dan, On Monday, 3 March 2014 00:59:46 UTC+2, Dan Allen wrote: > > ... > > - the document has to be parsed, which is not appropriate at this point in > the processor (we have to consider comment lines, attribute entries, etc) > both above & below > - the document may not have level 0 as its starting section title, but > could still be a subdocument > - we might be in a literal context, for which the preprocessor is not aware > - we break compatibility with AsciiDoc Python severely, with no way to > emulate the behavior there > - ... > Yes very good arguments. You convinced me: there should be a second command besides "include".
> I definitely agree there is a need for the subdocuments feature. I also > believe that it should be implemented as a block macro. > > As for the name, includedocument is far too verbose. I think subdocument > or just subdoc is sufficient. > I would like to avoid the term "subdocument" at all. The term was established with MSWord. There master- and subdocuments have special characteristics, which make them distinguishable. To take plain advantage of the new feature there should be no special requirements to our subdocuments. At my point view the most important design goal is: *Every asciidoc document can be stand alone and subdocument at the same time. *It enables us inter alia to generate automatically collections of individual reports, collections of student exercises etc. >From this it follows that documents and subdocumets do not differ at all. This is why I prefer to avoid the term "subdocument" here and rather would liked to use "included document". The concept differs from what had been introduced with MSWord many years ago. If "includedocument" is too long for you, what about "includedoc" ? > I want to emphasize that it's possible to start prototyping this feature > today using a block macro extension. I'd like it to live as an extension > while we flesh it out and bring it into core once we've got an > implementation we like. > Good idea. -- 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/d/optout.
