generate:module creates skeletal mkdocs content

Just generates mkdocs.yml and docs/index.md with a couple of Template
builders in the main InitCommand for now. Alternatively, could create
a Docs builder and/or command. Uses the old markdown_extensions syntax
because that's all the publishing infrastructure supports now.

Fixes #161

Author: ejegg

src/CRM/CivixBundle/Command/InitCommand.php

@@ -108,6 +108,7 @@ protected function execute(InputInterface $input, OutputInterface $output) {
     $basedir = new Path($ctx['basedir']);
     $ext->builders['dirs'] = new Dirs([
       $basedir->string('build'),
+      $basedir->string('docs'),
       $basedir->string('templates'),
       $basedir->string('xml'),
       $basedir->string('images'),
@@ -117,6 +118,8 @@ protected function execute(InputInterface $input, OutputInterface $output) {
     $ext->builders['module'] = new Module(Services::templating());
     $ext->builders['license'] = new License($licenses->get($ctx['license']), $basedir->string('LICENSE.txt'), FALSE);
     $ext->builders['readme'] = new Template('readme.md.php', $basedir->string('README.md'), FALSE, Services::templating());
+    $ext->builders['mkdocs'] = new Template('mkdocs.yml.php', $basedir->string('mkdocs.yml'), FALSE, Services::templating());
+    $ext->builders['docindex'] = new Template('index.md.php', $basedir->string('docs/index.md'), FALSE, Services::templating());
     $ext->builders['screenshot'] = new CopyFile(dirname(dirname(dirname(dirname(__DIR__)))) . '/images/placeholder.png', $basedir->string('images/screenshot.png'), FALSE);
     $ext->loadInit($ctx);
     $ext->save($ctx, $output);

src/CRM/CivixBundle/Resources/views/Code/index.md.php

@@ -0,0 +1,19 @@
+# <?php echo $fullName; ?>
+
+## Overview
+
+FIXME
+
+### Features
+
+* FIXME
+
+## Requirements
+
+* CiviCRM x.y or higher
+
+## Known Issues
+
+* None yet!
+
+## Future plans

src/CRM/CivixBundle/Resources/views/Code/mkdocs.yml.php

@@ -0,0 +1,21 @@
+# Use mkdocs to generate a manual for this extension. For more information about
+# mkdocs, see https://docs.civicrm.org/dev/en/latest/documentation/#mkdocs
+site_name: <?php echo "$fullName\n"; ?>
+repo_url: https://lab.civicrm.org/extensions/FIXME
+theme: material
+
+pages:
+- Home: index.md
+
+markdown_extensions:
+  - attr_list
+  - admonition
+  - def_list
+  - codehilite(guess_lang=false)
+  - toc(permalink=true)
+  - pymdownx.superfences
+  - pymdownx.inlinehilite
+  - pymdownx.tilde
+  - pymdownx.betterem
+  - pymdownx.mark
+  - pymdownx.magiclink