docbook 0.1.0

data/frontend/src/styles.css

@@ -0,0 +1,253 @@
+/* Tailwind-like utility classes and custom styles */
+/* Google Fonts loaded via <link> in HTML for file:// compatibility */
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  font-family: 'Inter', system-ui, sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body.font-serif {
+  font-family: 'Merriweather', Georgia, serif;
+}
+
+body.font-sans {
+  font-family: 'Inter', system-ui, sans-serif;
+}
+
+.font-mono {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+}
+
+/* Dark mode */
+.dark {
+  color-scheme: dark;
+}
+
+/* Print styles */
+@media print {
+  .lg\:translate-x-0, #sidebar, #sidebar-toggle, .sticky {
+    display: none !important;
+  }
+}
+
+/* TOC active highlighting */
+.toc-active {
+  color: #2563eb;
+  background: #dbeafe;
+}
+
+.dark .toc-active {
+  color: #60a5fa;
+  background: #1e3a5f;
+}
+
+/* Bibliography styling */
+.db-bibentry {
+  padding-left: 2em;
+  text-indent: -2em;
+  margin-bottom: 0.5em;
+}
+
+/* Changelog release styling */
+.db-changelog-release {
+  border-left: 3px solid #60a5fa;
+  padding-left: 1rem;
+  margin: 1.5rem 0;
+}
+
+.dark .db-changelog-release {
+  border-left-color: #3b82f6;
+}
+
+/* Appendix styling */
+.db-appendix-wrap {
+  border-left: 4px solid #8b5cf6;
+  padding-left: 1rem;
+  margin-left: -1rem;
+}
+
+.dark .db-appendix-wrap {
+  border-left-color: #a78bfa;
+}
+
+/* Preface styling */
+.db-preface-wrap {
+  border-left: 4px solid #22c55e;
+  padding-left: 1rem;
+  margin-left: -1rem;
+}
+
+.dark .db-preface-wrap {
+  border-left-color: #16a34a;
+}
+
+/* Search highlight */
+mark.bg-yellow-200,
+mark.bg-yellow-600 {
+  padding: 0 2px;
+  border-radius: 2px;
+}
+
+/* Alpine.js cloak */
+[x-cloak] {
+  display: none !important;
+}
+
+/* Scrollbar styling */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: #cbd5e1;
+  border-radius: 4px;
+}
+
+.dark ::-webkit-scrollbar-thumb {
+  background: #4b5563;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: #94a3b8;
+}
+
+.dark ::-webkit-scrollbar-thumb:hover {
+  background: #6b7280;
+}
+
+/* Content typography */
+.db-content h1 {
+  font-size: 1.875rem;
+  font-weight: 700;
+  margin-bottom: 1rem;
+}
+
+.db-content h2 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-top: 2rem;
+  margin-bottom: 0.75rem;
+}
+
+.db-content h3 {
+  font-size: 1.125rem;
+  font-weight: 600;
+  margin-top: 1.5rem;
+  margin-bottom: 0.5rem;
+}
+
+.db-content p {
+  margin-bottom: 1rem;
+  line-height: 1.75;
+}
+
+.db-content ul,
+.db-content ol {
+  margin-bottom: 1rem;
+  padding-left: 1.5rem;
+}
+
+.db-content li {
+  margin-bottom: 0.25rem;
+  line-height: 1.6;
+}
+
+.db-content code {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  font-size: 0.875em;
+  background: #f1f5f9;
+  padding: 0.125rem 0.375rem;
+  border-radius: 0.25rem;
+}
+
+.dark .db-content code {
+  background: #374151;
+}
+
+.db-content pre {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  font-size: 0.875rem;
+  background: #f1f5f9;
+  padding: 1rem;
+  border-radius: 0.5rem;
+  overflow-x: auto;
+  margin-bottom: 1rem;
+}
+
+.dark .db-content pre {
+  background: #1f2937;
+}
+
+.db-content a {
+  color: #2563eb;
+  text-decoration: underline;
+}
+
+.dark .db-content a {
+  color: #60a5fa;
+}
+
+.db-content img {
+  max-width: 100%;
+  height: auto;
+  border-radius: 0.5rem;
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+}
+
+.dark .db-content img {
+  box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.3);
+}
+
+.db-content blockquote {
+  border-left: 4px solid #d1d5db;
+  padding-left: 1rem;
+  margin: 1rem 0;
+  font-style: italic;
+  color: #6b7280;
+}
+
+.dark .db-content blockquote {
+  border-left-color: #4b5563;
+  color: #9ca3af;
+}
+
+.db-content table {
+  width: 100%;
+  border-collapse: collapse;
+  margin-bottom: 1rem;
+}
+
+.db-content th,
+.db-content td {
+  border: 1px solid #e5e7eb;
+  padding: 0.5rem;
+  text-align: left;
+}
+
+.dark .db-content th,
+.dark .db-content td {
+  border-color: #374151;
+}
+
+.db-content th {
+  background: #f9fafb;
+  font-weight: 600;
+}
+
+.dark .db-content th {
+  background: #1f2937;
+}

data/frontend/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "module": "ESNext",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "preserve",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "src/**/*.vue"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

data/frontend/tsconfig.node.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}

data/frontend/vite.config.ts

@@ -0,0 +1,30 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { resolve } from 'path'
+
+export default defineConfig({
+  plugins: [vue()],
+  build: {
+    lib: {
+      entry: resolve(__dirname, 'src/app.ts'),
+      name: 'DocbookSpa',
+      fileName: 'app',
+      formats: ['iife']
+    },
+    rollupOptions: {
+      output: {
+        inlineDynamicImports: true,
+        assetFileNames: 'app.[ext]'
+      }
+    },
+    minify: 'esbuild'
+  },
+  define: {
+    'process.env.NODE_ENV': JSON.stringify('production')
+  },
+  resolve: {
+    alias: {
+      '@': resolve(__dirname, 'src')
+    }
+  }
+})

data/lib/docbook/cli.rb

@@ -0,0 +1,123 @@
+# frozen_string_literal: true
+
+require "thor"
+require "nokogiri"
+require "fileutils"
+
+module Docbook
+  class CLI < Thor
+    desc "format INPUT", "Format/prettify DocBook XML"
+    option :output, aliases: "-o", desc: "Output file (default: stdout)"
+    option :xinclude, type: :boolean, default: false, desc: "Resolve XIncludes before processing"
+    def format(input)
+      xml_string = read_input(input, options[:xinclude])
+      parsed = parse_input(xml_string)
+      output = parsed.to_xml(pretty: true, declaration: true, encoding: "utf-8")
+      write_output(output, options[:output], :single_file)
+    end
+
+    desc "validate INPUT", "Validate DocBook XML well-formedness"
+    def validate(input)
+      xml_string = File.read(input)
+      doc = Nokogiri::XML(xml_string)
+      if doc.errors.empty?
+        puts "#{input}: valid"
+      else
+        doc.errors.each { |e| warn "#{input}: #{e}" }
+        exit 1
+      end
+    end
+
+    desc "to-html INPUT", "Convert DocBook XML to HTML"
+    option :output, aliases: "-o", desc: "Output file or directory"
+    option :xinclude, type: :boolean, default: true, desc: "Resolve XIncludes before processing"
+    option :output_type, default: :single_file, desc: "Output type: single_file or directory"
+    def to_html(input)
+      xml_string = read_input(input, options[:xinclude])
+      parsed = parse_input(xml_string)
+      xref_resolver = Docbook::XrefResolver.new(parsed).resolve!
+      base_path = File.dirname(File.expand_path(input))
+      output_mode = options[:output_type].to_sym
+      output_path = if output_mode == :directory && options[:output]
+                      File.expand_path(options[:output])
+                    elsif output_mode == :single_file && options[:output]
+                      File.dirname(File.expand_path(options[:output]))
+                    end
+
+      html = Docbook::Output::Html.new(
+        parsed,
+        xref_resolver: xref_resolver,
+        output_mode: output_mode,
+        base_path: base_path,
+        output_path: output_path
+      ).to_html
+
+      write_output(html, options[:output], output_mode)
+    end
+
+    desc "roundtrip INPUT...", "Round-trip test DocBook XML files"
+    def roundtrip(*inputs)
+      failures = 0
+      inputs.each do |input|
+        xml_string = File.read(input)
+        begin
+          parsed = parse_input(xml_string)
+          output = parsed.to_xml(declaration: true, encoding: "utf-8")
+          reparsed = parse_input(output)
+          puts "#{input}: OK"
+        rescue StandardError => e
+          warn "#{input}: FAIL - #{e.message}"
+          failures += 1
+        end
+      end
+      warn "#{inputs.size} files, #{failures} failures"
+      exit 1 if failures > 0
+    end
+
+    def self.exit_on_failure?
+      true
+    end
+
+    private
+
+    FRONTEND_ROOT = File.expand_path("../../frontend/dist", __dir__)
+
+    def read_input(input, resolve_xinclude = false)
+      xml_string = File.read(input)
+      if resolve_xinclude
+        resolved = Docbook::XIncludeResolver.resolve_string(xml_string, base_path: input)
+        resolved.to_xml
+      else
+        xml_string
+      end
+    end
+
+    def parse_input(xml_string)
+      Docbook::Document.from_xml(xml_string)
+    end
+
+    def write_output(content, output_path, output_type)
+      if output_type == :directory
+        raise ArgumentError, "Output path required for directory mode" unless output_path
+
+        FileUtils.mkdir_p(output_path)
+        File.write(File.join(output_path, "index.html"), content)
+
+        # Copy frontend assets to output_dir/assets/
+        assets_dir = File.join(output_path, "assets")
+        FileUtils.mkdir_p(assets_dir)
+        FileUtils.cp(File.join(FRONTEND_ROOT, "app.css"), File.join(assets_dir, "app.css"))
+        FileUtils.cp(File.join(FRONTEND_ROOT, "app.iife.js"), File.join(assets_dir, "app.iife.js"))
+
+        puts "Written to #{File.join(output_path, "index.html")} and assets/"
+      else
+        if output_path
+          File.write(output_path, content)
+          puts "Written to #{output_path}"
+        else
+          $stdout.write(content)
+        end
+      end
+    end
+  end
+end

data/lib/docbook/document.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+require "nokogiri"
+
+module Docbook
+  class Document
+    ROOT_ELEMENT_MAP = {
+      "article" => Elements::Article,
+      "book" => Elements::Book,
+      "chapter" => Elements::Chapter,
+      "appendix" => Elements::Appendix,
+      "preface" => Elements::Preface,
+      "part" => Elements::Part,
+      "section" => Elements::Section,
+      "refentry" => Elements::RefEntry,
+      "bibliography" => Elements::Bibliography,
+      "glossary" => Elements::Glossary,
+      "set" => Elements::Set,
+      "reference" => Elements::Reference,
+      "topic" => Elements::Topic,
+      "dedication" => Elements::Dedication,
+      "acknowledgements" => Elements::Acknowledgements,
+      "colophon" => Elements::Colophon,
+      "index" => Elements::Index,
+      "toc" => Elements::Toc,
+      "sect1" => Elements::Sect1,
+      "sect2" => Elements::Sect2,
+      "sect3" => Elements::Sect3,
+      "sect4" => Elements::Sect4,
+      "sect5" => Elements::Sect5,
+      "refsection" => Elements::RefSection,
+      "refsect1" => Elements::RefSect1,
+      "refsect2" => Elements::RefSect2,
+      "refsect3" => Elements::RefSect3,
+      "setindex" => Elements::SetIndex,
+      "para" => Elements::Para,
+      "simplesect" => Elements::Simplesect,
+    }.freeze
+
+    class << self
+      def from_xml(xml_string)
+        doc = Nokogiri::XML(xml_string)
+        root = doc.root
+        raise Docbook::Error, "Empty or invalid XML document" unless root
+
+        root_name = root.name
+        klass = ROOT_ELEMENT_MAP[root_name]
+
+        if klass.nil?
+          raise Docbook::Error, "Unsupported DocBook root element: #{root_name}"
+        end
+
+        klass.from_xml(xml_string)
+      end
+
+      def supports?(root_name)
+        klass = ROOT_ELEMENT_MAP[root_name]
+        !klass.nil?
+      end
+
+      def supported_root_elements
+        ROOT_ELEMENT_MAP.select { |_, v| v }.keys
+      end
+    end
+  end
+end

data/lib/docbook/elements/abbrev.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Abbrev < Lutaml::Model::Serializable
+      attribute :content, :string
+
+      xml do
+        element "abbrev"
+        mixed_content
+        map_content to: :content
+      end
+    end
+  end
+end

data/lib/docbook/elements/acknowledgements.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Acknowledgements < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :xml_id, Lutaml::Xml::W3c::XmlIdType
+      attribute :title, Title
+      attribute :para, Para, collection: true
+
+      xml do
+        element "acknowledgements"
+        mixed_content
+        map_content to: :content
+        map_attribute "xml:id", to: :xml_id
+        map_element "title", to: :title
+        map_element "para", to: :para
+      end
+    end
+  end
+end

data/lib/docbook/elements/address.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Address < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :xml_id, Lutaml::Xml::W3c::XmlIdType
+
+      xml do
+        element "address"
+        mixed_content
+        map_content to: :content
+        map_attribute "xml:id", to: :xml_id
+      end
+    end
+  end
+end

data/lib/docbook/elements/alt.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Alt < Lutaml::Model::Serializable
+      attribute :content, :string
+
+      xml do
+        element "alt"
+        mixed_content
+        map_content to: :content
+      end
+    end
+  end
+end

data/lib/docbook/elements/annotation.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Annotation < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :xml_id, Lutaml::Xml::W3c::XmlIdType
+
+      xml do
+        element "annotation"
+        mixed_content
+        map_content to: :content
+        map_attribute "xml:id", to: :xml_id
+      end
+    end
+  end
+end

data/lib/docbook/elements/appendix.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Appendix < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :xml_id, Lutaml::Xml::W3c::XmlIdType
+      attribute :version, :string
+      attribute :info, Info
+      attribute :title, Title
+      attribute :para, Para, collection: true
+      attribute :section, Section, collection: true
+      attribute :literallayout, LiteralLayout, collection: true
+      attribute :simplesect, Simplesect, collection: true
+      attribute :indexterm, IndexTerm, collection: true
+
+      xml do
+        element "appendix"
+        mixed_content
+        map_content to: :content
+        map_attribute "xml:id", to: :xml_id
+        map_attribute "version", to: :version
+        map_element "info", to: :info
+        map_element "title", to: :title
+        map_element "para", to: :para
+        map_element "section", to: :section
+        map_element "literallayout", to: :literallayout
+        map_element "simplesect", to: :simplesect
+        map_element "indexterm", to: :indexterm
+      end
+    end
+  end
+end

data/lib/docbook/elements/article.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+
+module Docbook
+  module Elements
+    class Article < Lutaml::Model::Serializable
+      attribute :content, :string
+      attribute :version, :string
+      attribute :xml_id, Lutaml::Xml::W3c::XmlIdType
+      attribute :lang, Lutaml::Xml::W3c::XmlLangType
+      attribute :info, Info
+      attribute :para, Para, collection: true
+      attribute :simplesect, Simplesect, collection: true
+      attribute :section, Section, collection: true
+
+      xml do
+        element "article"
+        mixed_content
+
+        map_content to: :content
+        map_attribute "version", to: :version
+        map_attribute "xml:id", to: :xml_id
+        map_attribute "lang", to: :lang
+        map_element "info", to: :info
+        map_element "para", to: :para
+        map_element "simplesect", to: :simplesect
+        map_element "section", to: :section
+      end
+    end
+  end
+end

data/lib/docbook/elements/att.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Docbook
+  module Elements
+    class Att < Lutaml::Model::Serializable
+      attribute :content, :string
+
+      xml do
+        element "att"
+        mixed_content
+        map_content to: :content
+      end
+    end
+  end
+end