asciisourcerer 0.4.0 → 0.6.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciisourcerer
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - DocOps Lab
@@ -107,6 +107,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
 description: AsciiSourcerer provides APIs for specialized use of AsciiDoc (attribute
   extraction, special conversions), YAML (tag handling), and Liquid (Jekyll-based
   rendering, custom tags, etc).
@@ -116,17 +130,21 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- BILL_OF_MATERIALS.adoc
 - LICENSE
 - README.adoc
 - lib/asciidoctor/extensions/source-skim-tree-processor/extension.rb
 - lib/asciisourcerer.rb
 - lib/sourcerer.rb
+- lib/sourcerer/_docs/partials/liquid-filters-by-kind.adoc
+- lib/sourcerer/_docs/partials/liquid-filters-by-source.adoc
 - lib/sourcerer/asciidoc.rb
 - lib/sourcerer/builder.rb
 - lib/sourcerer/jekyll.rb
 - lib/sourcerer/jekyll/bootstrapper.rb
 - lib/sourcerer/jekyll/liquid/file_system.rb
 - lib/sourcerer/jekyll/liquid/filters.rb
+- lib/sourcerer/jekyll/liquid/preserve_missing_variables.rb
 - lib/sourcerer/jekyll/liquid/tags.rb
 - lib/sourcerer/jekyll/monkeypatches.rb
 - lib/sourcerer/mark_down_grade.rb
@@ -135,17 +153,19 @@ files:
 - lib/sourcerer/source_skim.rb
 - lib/sourcerer/source_skim/config.rb
 - lib/sourcerer/source_skim/markdown_skimmer.rb
+- lib/sourcerer/source_skim/ruby_skimmer.rb
 - lib/sourcerer/source_skim/skimmer.rb
 - lib/sourcerer/sync.rb
 - lib/sourcerer/sync/block_parser.rb
 - lib/sourcerer/sync/cast.rb
 - lib/sourcerer/templating.rb
+- lib/sourcerer/util/gem_uri.rb
 - lib/sourcerer/util/list_amend.rb
 - lib/sourcerer/util/pathifier.rb
 - lib/sourcerer/version.rb
 - lib/sourcerer/yaml.rb
 - lib/sourcerer/yaml_frontmatter.rb
-- specs/docs/frontmatter-reader_prd.adoc
+- specs/data/liquid-filters.yml
 homepage: https://github.com/DocOps/asciisourcerer
 licenses:
 - MIT

data/specs/docs/frontmatter-reader_prd.adoc

@@ -1,47 +0,0 @@
-= FrontmatterReader: PRD
-:status: implemented
-:version: 0.3.0
-
-== Overview
-
-`Sourcerer::SourceSkim` needs to incorporate a simpler Skim object that derives data/content from frontmatter YAML and section headings.
-
-`SourceSkim` currently generates structured, semantic metadata and content outline about AsciiDoc source files.
-But many use cases (Jekyll site pipelines, documentation indexers, cross-repo search tools) need to work with Markdown files, as well:
-
-* Frontmatter data (layout, title, navigation hints, etc.)
-* Section headings and their levels:
-** a flat list of section headings and their line numbers, and/or
-** a nested hierarchy of sections and subsections.
-
-== Output Shape
-
-The core operation yields a skim in one of the following configurations:
-
-[source,ruby]
-----
-{
-  title:         'Introduction',                                    # String — from first # heading
-  frontmatter:   { 'layout' => 'docs', 'title' => 'Guide', ... },  # Hash
-  sections_flat: [                                                 # Array
-    { text: 'Getting Started', level: 1, starts_at: 13 },
-    { text: 'Prerequisites',   level: 2, starts_at: 17 },
-    ...
-  ]
-}
-----
-
-[source,ruby]
-----
-{
-  title:       'Introduction',                                    # String
-  frontmatter: { 'layout' => 'docs', 'title' => 'Guide', ... },  # Hash
-  sections_tree: [                                               # Array (same shape as AsciiDoc)
-    { text: 'Getting Started', level: 1, starts_at: 13, sections: [
-      { text: 'Prerequisites', level: 2, starts_at: 17, sections: [] }
-    ] },
-    { text: 'Advanced Usage', level: 1, starts_at: 22, sections: [] },
-    ...
-  ]
-}
-----