xml


Targetted #INCLUDE-like directive in markup languages for documentation purposes


The goal
I'm looking for a markup language for writing documentation that would support a very flexible #INCLUDE-like directive that can target specific elements of an included file or resource. The markup language should also have some LaTeX (and ideally also HTML) exporter.
However, the elements should be included from the file as they are without any additional tagging of the elements.
One additional requirement is to be able to use LaTeX math fragments as this is to be used in academia.
Example usage
For example, I may have several documents about specific components of a device and one day I decide I want to create a report about certain aspects of certain components. Using this #INCLUDE-like directive I would include the paragraphs/resources/nodes from the various documents and then export it to PDF through LaTeX.
Research so far
I've had a look at most of the common markup (and even non-markup) languages and most do have something like and #INCLUDE directive, but usually it's only capable of including whole files or at best a range of lines from a file. However, line ranges are very brittle and may become quickly obsolete if the included document is e.g. extended.
Here I list some of the most promising candidates:
EMACS Org-mode
I've been playing around with the newly extended #INCLUDE directive functionality in Org-mode version 8.3 for extracting parts of files, documented in the manual and an example is in the answer of this question.
#+INCLUDE: "./other-file.org::*Headline text"
LaTeX
The closest alternative I found in LaTeX is catchfilebetweentags, but that requires adding the tags in the file being included.
I've also seen people use \def\resourceID{resource content} to define the nodes in files and then include the files where needed and expand the required macros. This approach requires an even less elegant way of marking the elements.
XML with Xinclude
As discussed in this XML inclusion question, the XInclude extension offers something quite close to what I would want, because on can easily targe ta XML nodes and structures as XML is well designed for that. However, XML is NOT designed to be a markup language for writing documentation AFAIK. Or is there some XML doctype and/or interface that is often used for documentation purposes these days?
I'm aware of DocBook, but editing XML files is certainly not user-friendly. Or is there some good frontend these days? It seems LyX might be even able to use MathML in the result.

Related Links

Add elements of XML using for-each of XSLT, only if tag value is non empty
Can the range of acceptable values in an XML Schema interdepend?
XPath: how to select a subset of children of the current node
Nearest XPath sibling in XML doc with structured tag names?
Can't apply concat function in WSO2 ESB CONFIGURATION with json-eval
DTD to XML Schema
XQuery: How to select unique nodes
Find attribute using another variable value in XSLT
Is there a way to present XML data in google sites
Spell-check in Atom in xml files
Concat in a Loop within XSL file?
How to reduce filesize in TimeBasedRollingPolicy appender
How To Add Maven Dependency (Android Studio)
XML Schema is not considering one of its attribute
How can i go through xml data sorted by date and get a list of a custom class?
Exception while using lateral view in Hive

Categories

HOME
url-redirection
eclipse
gridview
time-complexity
wakanda
rdbms
swt
static
camera
spring-data-redis
shiro
can
alarm
seo
javacc
tail
limit
data-visualization
retrofit2
nstableheaderview
pcl-crypto
heap
gson
mod-security
3nf
http-post
scsi
job-scheduling
articulate-storyline
perlbrew
opentk
gpio
android-things
bringtofront
browser-sync
failover
uitapgesturerecognizer
twiml
magento-1.8
zend-debugger
reverse
watchman
cd
spring-mvc-test
hackintosh
branching-and-merging
postgresql-8.4
softmax
wc
phpdbg
servermanager
jboss-4.2.x
ntvs
term
vugen
convex-optimization
carrot2
pdf-conversion
janus
offline.js
cd-burning
swingworker
bootstrap-tags-input
atlas
omxplayer
iotivity
x-tag
expectations
angular-ui-typeahead
sklearn-pandas
html-to-pdf
nio2
concurrentmodification
xenomai
oracle-spatial
ess
amiga
dronekit-android
skspritenode
dnssec
iso-prolog
cbind
jama
gii
jqmodal
matrix-inverse
ray
draw2d-js
gtm-oauth2
embedded-fonts
mbunit
android-loadermanager
sentestingkit
qtconcurrent
cakephp-1.2
os.system
jquery-address
metaweblog
echo3
build-environment
data-mapping
fail-fast-fail-early
httpcookie
contentpresenter

Resources

Encrypt Message