jedelman8 / ansible-webdocs Goto Github PK
View Code? Open in Web Editor NEWAuto generate markdown docs for documented Ansible modules
Auto generate markdown docs for documented Ansible modules
Hi ,
I am trying to generate the markdown for a custom module that i wrote, the module follows the Ansible standards in documentation and i do not suspect anything wrong here. It is creating a markdown with empty content ( just the header and the sub-header). The module path etc is set correctly in my playbook used to generate the markdown.
I am using ansible 1.8.4
Please help
vagrant@vagrant-ubuntu-trusty-64:~/ansible-webdocs/ansible-webdocs$ ansible-playbook create-ansible-webdoc.yml -i /home/vagrant/playbooks/inventory
PLAY [create local markdown doc] **********************************************
TASK: [get docs and examples for modules] *************************************
ok: [localhost]
TASK: [build web/markdown ansible docs] ***************************************
changed: [localhost]
PLAY RECAP ********************************************************************
localhost : ok=2 changed=1 unreachable=0 failed=0
vagrant@vagrant-ubuntu-trusty-64:/ansible-webdocs/ansible-webdocs$ cd web//ansible-webdocs/ansible-webdocs/web$ vi ansiblefilesdoc.md
vagrant@vagrant-ubuntu-trusty-64:
vagrant@vagrant-ubuntu-trusty-64:~/ansible-webdocs/ansible-webdocs/web$
Below is the markdown that got generated
Created by Jason Edelman. February 2015.
Hello,
What is the license of this project?
We would like to use your module and template in our project.
Currently we are using Apache 2.
There seems to have be some issues with this module using later releases of Ansible. I'm able to create documentation using Ansible 1.8.4, but not with Ansible 1.9.1.
I'm able to create a task looking like this with Ansible 1.8.4
In 1.9.1 I can only do this:
Basically the "register: modules" returns a different structure in different versions of Ansible.
I haven't done any more troubleshooting but wanted to let you know.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.