eleventy-plugin-asciidoc 1.0.0 → 1.3.0

package/.eleventy.js

@@ -1,13 +1,16 @@
 const eleventyAsciidoc = require("./lib/eleventy-asciidoc.js");
 
+/** @typedef {import('./lib/eleventy-asciidoc.js').ProcessorOptions} ProcessorOptions} */
+
 module.exports = {
   /**
    * Plugin config function
    *
-   * @param      {Object}  eleventy     The eleventy configuration object
+   * @param      {object}            eleventyConfig     The eleventy configuration object
+   * @param      {ProcessorOptions}  converterOptions   Options for Asciidoctor.converter()
    */
-  configFunction(eleventyConfig, userOptions) {
+  configFunction(eleventyConfig, converterOptions) {
     eleventyConfig.addTemplateFormats("adoc");
-    eleventyConfig.addExtension("adoc", eleventyAsciidoc(userOptions));
+    eleventyConfig.addExtension("adoc", eleventyAsciidoc(converterOptions));
   },
 };

package/README.md

@@ -1,8 +1,17 @@
 # eleventy-plugin-asciidoc
 
-Eleventy plugin to add support for AsciiDoc. The plugin uses [Asciidoctor.js](https://docs.asciidoctor.org/asciidoctor.js) under the hood.
+Eleventy plugin to add support for [AsciiDoc](https://asciidoc.org/). You don't need to use to shortcodes. You can directly use AsciiDoc files (`.adoc`), just like Markdown (`.md`).
 
-**Requires Eleventy `1.0.0` or newer.**
+The plugin uses [Asciidoctor.js](https://docs.asciidoctor.org/asciidoctor.js) under the hood.
+
+**Requires Eleventy 1.0.0-beta.10, 1.0.0-canary.50 or newer.**
+
+## Features
+
+- Supports the default [YAML front matter](https://www.11ty.dev/docs/data-frontmatter/).
+- Supports [AsciiDoc document title](https://docs.asciidoctor.org/asciidoc/latest/document/title/#title-syntax)
+- Other attributes in the AsciiDoc files are made available through `page.asciidocAttributes`.
+  - Example `:author: Jane Doe` in the `.adoc` file will be available as `page.asciidocAttrbutes.author`
 
 ## Usage
 
@@ -33,9 +42,8 @@ const eleventyAsciidoc = require("eleventy-plugin-asciidoc");
 
 module.exports = function (eleventyConfig) {
   eleventyConfig.addPlugin(eleventyAsciidoc, {
-    /* Converter options */
-    showtitle: true,
-    safe: "unsafe",
+    showtitle: true /* Default value: true */,
+    safe: "unsafe" /* Default value: undefined */,
   });
 };
 ```

package/lib/eleventy-asciidoc.js

@@ -1,35 +1,61 @@
 // @ts-check
 
 const asciidoctor = require("asciidoctor").default();
-const debug = require("debug")("eleventy-asciidoc");
-
-const nunjucks = require("nunjucks");
+const debug = require("debug")("eleventy-plugin-asciidoc");
 const fs = require("fs");
 const matter = require("gray-matter");
 
-function eleventyAsciidoctor(options = {}) {
-  debug("Options: ", options);
-  const readFileSync = (inputPath) => {
-    return matter(fs.readFileSync(inputPath, "utf8"));
-  };
+/** @typedef {import('asciidoctor').Asciidoctor.ProcessorOptions} ProcessorOptions */
+/** @typedef {import('gray-matter').GrayMatterFile}  GrayMatterFile */
 
-  const getData = (inputPath) => {
-    const { data } = readFileSync(inputPath);
+/**
+ * Reads a file synchronously.
+ *
+ * @param      {string}  inputPath  The input path
+ * @return     {GrayMatterFile}  { description_of_the_return_value }
+ */
+const readFileSync = (inputPath) => {
+  return matter(fs.readFileSync(inputPath, "utf8"));
+};
 
-    return data;
+/**
+ * Gets front-matter data from the file synchronously
+ *
+ * @param      {string}  inputPath  The input path
+ * @return     {{ [key: string]: any }}  The data.
+ */
+const getData = (inputPath) => {
+  const { data, content } = readFileSync(inputPath);
+  const doc = asciidoctor.load(content);
+  const attributes = doc.getAttributes();
+  const title = doc.getDocumentTitle();
+  debug(`Document title ${title}`);
+  debug(`Document attributes: ${attributes}`);
+
+  return {
+    title,
+    asciidocAttributes: attributes,
+    ...data,
   };
+};
 
-  const compile = (str) => (data) => {
-    if (str) {
-      // Since `read: false` is set 11ty doesn't read file contents
-      // so if str has a value, it's a permalink (which can be a string or a function)
-      return typeof str === "function"
-        ? str(data)
-        : nunjucks.renderString(str, data);
-    }
+/**
+ * Generates Eleventy template renderer for AsciiDoctor
+ *
+ * @param      {ProcessorOptions=}  convertOptions Options for Asciidoctor.converter()
+ * @return     {Object}             Eleventy data processor object
+ */
+function eleventyAsciidoctor(convertOptions = {}) {
+  debug("Converter options: ", convertOptions);
+
+  const options = {
+    showtitle: true,
+    ...convertOptions,
+  };
 
-    debug(`Reading ${data.page.inputPath}`);
-    const { content } = readFileSync(data.page.inputPath);
+  const compile = (_, inputPath) => () => {
+    debug(`Reading ${inputPath}`);
+    const { content } = readFileSync(inputPath);
 
     if (content) {
       debug(`Converting:\n ${content}`);

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "eleventy-plugin-asciidoc",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "Adds support for AsciiDoc to Eleventy",
   "main": ".eleventy.js",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com:saneef/eleventy-plugin-asciidoctor.git"
+    "url": "git+https://github.com:saneef/eleventy-plugin-asciidoc.git"
   },
   "scripts": {
     "lint": "eslint lib/**.js tests/**.js",
-    "test": "nyc ava --timeout=1m -v --color",
+    "test": "nyc ava -v --color",
     "prepare": "husky install"
   },
   "keywords": [
-    "responsive-images",
-    "images",
+    "asciidoc",
+    "asciidoctor",
     "eleventy",
     "11ty",
     "eleventy-plugin"