not even mentionning that with backrefs I would like to see lineinfile doing the changes for all the matching lines in the target file and not just the latest
That would be terrific when used in remediation context.
"not even mentionning that with backrefs I would like to see
lineinfile doing the changes for all the matching lines in the target
file and not just the latest :-)"
At this point, it seems like you should just run sed against the file.
Ok, so absolute requirements for this is it must run from ‘make webdocs’.
It’s not acceptable for them to be hosted on an external site because then they can’t be accessed offline, nor is it easy to contribute to changes to the way the docs are presented.
"not even mentionning that with backrefs I would like to see
lineinfile doing the changes for all the matching lines in the target
file and not just the latest :-)"
At this point, it seems like you should just run sed against the file.
As an excercise I started writing a simple plugin in Bash, here as a
wrapper to "sed -e 's/regexp/replace/':
I think the next thing to do is probably to make a ‘category’ field in the DOCUMENTATION string such that it can sort or filter by category, and also (if not already to support the EXAMPLES documentation string).
Maybe this is not the best solution, web spider do not find data in
page, and don't execute HTML. I'm also working on a HTML page
generation (separate html fragment for each module) to make possibile
ajax crowlong ¹, this is partially working (on my local machine,
sorry) but I need to find some days to refactor Ansible interface
before make it public.
I think the next thing to do is probably to make a 'category' field in the
DOCUMENTATION string such that it can sort or filter by category, and also
(if not already to support the EXAMPLES documentation string).
Add support to EXAMPLES can be easy to add, but I'm not sure if it can
add in UI (parser can just consider all text as code, so have a wrong
impact on page presentation).
Filter by category will add ASAP (when all module have category), in
Issue #2194 I suggest to use "tags" inside "category" to have multiple
tagging capabilities (eg: user, database, mysql) and make possible
have "faceted search" on content... if you are agree i will work on
this feature in the next weeks (category/tag + module tagging).
Now I'm working on coding standard in documentation fragment (as
descrbed in a old mail).
Tags instead of category seems great, as for examples could we not
just turn a new line into a BR tag?
What? Have all examples without <pre>/<code> tag? Having code without
monospace font I think make docs inusable, have all text with
monospace font mate text less readable. Having not separation in
examples make (in my opinion) documentation a mess of text.