@antora/html-single-extension 1.0.0-beta.18

package/README.md

@@ -0,0 +1,29 @@
+# Antora HTML Single Extension
+
+The Antora HTML Single extension is an Antora extension and exporter for Assembler.
+It configures and invokes Assembler and provides the converter function and metadata Assembler uses to export content to standalone HTML documents.
+
+This extension first delegates to Assembler, passing in the converter metadata, to construct assembly files from pages per component version using the navigation as a model.
+Assembler then iterates over those assembly files and, using the converter provided by this extension, converts them to standalone HTML documents using Asciidoctor.js (or the specified command).
+Finally, Assembler adds those HTML documents to the content catalog as exports, which Antora publishes alongside the other files in the site.
+
+## Usage
+
+Once this package is installed in the playbook project, register it in the Antora playbook as follows:
+
+**antora-playbook.yml**
+
+```yaml
+antora:
+  extensions:
+  - '@antora/html-single-extension'
+# ...
+```
+
+You can configure the behavior of the extension using the optional _antora-assembler.yml_ file.
+
+## Copyright and License
+
+Copyright (C) 2022-present by OpenDevise Inc. and the individual contributors of this project.
+
+Use of this software is granted under the terms of the [Mozilla Public License Version 2.0](https://www.mozilla.org/en-US/MPL/2.0/) (MPL-2.0).

package/lib/converter.js

@@ -0,0 +1,57 @@
+'use strict'
+
+const fsp = require('node:fs/promises')
+const ospath = require('node:path')
+
+const DEFAULT_COMMAND = 'asciidoctor'
+
+async function convert (runCommand, file, convertAttributes, buildConfig) {
+  const { command } = buildConfig
+  if (command === false) {
+    const Asciidoctor = this.require('@asciidoctor/core')()
+    const Extensions = Asciidoctor.Extensions
+    const exts = this.getVariables().siteAsciiDocConfig?.extensions || []
+    let extRegistry, extDslTypes
+    try {
+      if (exts.length) {
+        const contentCatalog = this.getVariables().contentCatalog
+        extDslTypes = Extensions.$constants(false).filter((name) => name.endsWith('Dsl'))
+        extRegistry = Extensions.create()
+        exts.forEach((ext) => ext.register(extRegistry, { file, contentCatalog }))
+      }
+      Asciidoctor.convert(file.contents, {
+        attributes: convertAttributes,
+        extension_registry: extRegistry,
+        mkdirs: true,
+        safe: 'safe',
+        sourcemap: true,
+        to_file: convertAttributes.outfile,
+      })
+    } finally {
+      if (exts.length) extDslTypes.forEach((type) => (Opal.const_get_local(Extensions, type).$$iclasses.length = 0))
+    }
+  } else {
+    const { cwd = process.cwd(), stderr = 'print' } = buildConfig
+    const args = convertAttributes.toArgs('-a', command).concat('-o', convertAttributes.outfile, '-')
+    return await runCommand(command, args, { parse: true, cwd, stdin: file.contents, stdout: 'print', stderr })
+  }
+}
+
+function getDefaultCommand (cwd) {
+  return fsp.access(ospath.join(cwd, 'Gemfile.lock')).then(
+    () => `bundle exec ${DEFAULT_COMMAND}`,
+    () => DEFAULT_COMMAND
+  )
+}
+
+module.exports = {
+  bind (thisArg, runCommand) {
+    return Object.assign({}, this, { convert: convert.bind(thisArg, runCommand) })
+  },
+  convert,
+  backend: 'html',
+  getDefaultCommand,
+  extname: '.html',
+  mediaType: 'text/html',
+  loggerName: require('../package.json').name,
+}

package/lib/index.js

@@ -0,0 +1,15 @@
+'use strict'
+
+const converter = require('./converter')
+const runCommand = require('@antora/run-command-helper')
+
+module.exports.register = function ({ config }, providers) {
+  requireAssembler(this).configure(this, converter.bind(this, runCommand), config, providers)
+}
+
+function requireAssembler (context, packageName = '@antora/assembler') {
+  try {
+    return context.require(packageName) // when installed with Antora
+  } catch {}
+  return require(packageName) // when installed separate from Antora, perhaps in project
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@antora/html-single-extension",
+  "version": "1.0.0-beta.18",
+  "description": "An Antora extension that uses Assembler to merge pages into assembly files, export them to standalone HTML documents, and publish them with the site.",
+  "license": "MPL-2.0",
+  "author": "OpenDevise Inc. (https://opendevise.com)",
+  "contributors": [
+    "Dan Allen <dan@opendevise.com>",
+    "Sarah White <sarah@opendevise.com>"
+  ],
+  "homepage": "https://antora.org",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/antora/antora-assembler.git",
+    "directory": "packages/html-single-extension"
+  },
+  "bugs": {
+    "url": "https://gitlab.com/antora/antora-assembler/issues"
+  },
+  "scripts": {
+    "test": "node --test test/*-test.js",
+    "prepublishOnly": "npx -y downdoc --prepublish",
+    "postpublish": "npx -y downdoc --postpublish"
+  },
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./converter": "./lib/converter.js",
+    "./package.json": "./package.json"
+  },
+  "imports": {
+    "#package": "./package.json"
+  },
+  "dependencies": {
+    "@antora/assembler": "1.0.0-beta.18",
+    "@antora/run-command-helper": "~1.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "lib/"
+  ],
+  "keywords": [
+    "antora",
+    "antora-extension",
+    "asciidoc",
+    "asciidoctor",
+    "html",
+    "generator",
+    "documentation"
+  ]
+}