yard-markdown 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ff780c12b0efc36b1ba7c766ac4a8645d5fa9c5776e6ac1351a064b797e4fd1
-  data.tar.gz: fb42ed6ee07c97cd22af57267b0aed1570b7fb9fe89a4840a643fe4858d4a2a5
+  metadata.gz: f8bc0dd303b8e3b40e53d55a7b53c339e8d0c8c8f8a44427c12bc6cca9f303f4
+  data.tar.gz: 13159d5918456cbfa5e909679ba2596a52dfecb24ec14bdccac20f51d5552146
 SHA512:
-  metadata.gz: d0ff4417bb45236c042daece82cf8442840d0f9c573a6be70e513c5c603ca813dc07ce8d30a5ddad0707463d95e9ac8a548f3f476bde5b777aaf4a27d16e91dd
-  data.tar.gz: 9687a9283bd08e6b5be2d00f0da4f2c41b997a71ef2875c0090aa15ccc78f0ea77d1710b9aba5b63775f2c34efe58dacc668adf9ded49453cbc9a1e575eb04ed
+  metadata.gz: e2aa7fac3e51b28d2bece0f852da3436d9f9bdb83242af7f78bb25aefde514206f01fe6f9d70f2765b6342cf11b1b40a484454b782565161ec50a72705c41aec
+  data.tar.gz: 37c63aa190abaa091d27c279268a23756f120393a519286983510933e5fd22f9076cc6c8f8b694ba25e27d4b638b5d44587f5528c9a97c61f4db3e2b861cca70

data/.yardopts

@@ -1,4 +1,4 @@
---load ./lib/yard/markdown.rb
+--load ./lib/yard-markdown.rb
 --format markdown
 --markup markdown
 --output-dir example

data/README.md

@@ -1,14 +1,27 @@
 # Yard::Markdown
 
-Yard-markdown produces markdown documents for ruby gems.
+Yard theme plugin that generates markdown documentation for gems
 
-Goals:
+## Goals:
 - Compatible with Github Flavored Markdown
 - Mimick yard html layout in markdown format as much as possible
-- Produce .csv index file alonside markdown documentation
+- Produce .csv index file alonside markdown documentation to act as file index
 
-This is a successor to rdoc-mardown gem, so it will very likely be similar to this [example](https://github.com/skatkov/rdoc-markdown/tree/main/example).
+## Usage
+Add these lines:
+```
+gem 'yard-markdown'
+```
+And run `bundle install`
 
+Run yardoc with `--format=markdown` parameter.
 
-Testing:
-  `yardoc example.rb` -> outputs everything into doc.
+## Backstory
+Successor to rdoc-mardown gem that was authored by me. So there is a lot of similarities between two - [example](https://github.com/skatkov/rdoc-markdown/tree/main/example).
+
+This gem is used by documentation reviewing tool called [POSH TUI](https://poshtui.com)
+
+## Testing
+Unit tests can't really test this gem properly. So it's semi-manual process of making changes and reviewing output.
+
+  `yardoc example.rb` -> outputs everything into example/ folder.

data/example/Bird.md

@@ -34,3 +34,4 @@ Produce some noise.
 --
 FIXME: maybe extract this to a base class +Animal+?
 ++
+

data/example/Duck.md

@@ -5,7 +5,7 @@
 | **Extended by:** | Animal |
 | **Includes:** | Waterfowl |
 | **Defined in:**    | example.rb    |
-|| |
+
 
 A duck is a Waterfowl Bird.
 

data/lib/yard-markdown.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "yard"
+
+module YARD
+  module Markdown
+  end
+end
+
+YARD::Templates::Engine.register_template_path File.dirname(__FILE__) + '/../templates'

data/templates/default/fulldoc/markdown/setup.rb

@@ -2,7 +2,6 @@
 
 # https://github.com/lsegal/yard/blob/2d197a381c5d4cc5c55b2c60fff992b31c986361/docs/CodeObjects.md
 
-require_relative "../../../../lib/yard/serializers/markdown_serializer"
 require "erb"
 
 def init

metadata

@@ -1,16 +1,30 @@
 --- !ruby/object:Gem::Specification
 name: yard-markdown
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Stanislav (Stas) Katkov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-26 00:00:00.000000000 Z
-dependencies: []
-description: yard-markdown is a yard plugin template to generate markdown files
+date: 2023-11-28 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: yard theme plugin that generates markdown documentation for gems
 email:
 - yard-markdown@skatkov.com
 executables: []
@@ -27,11 +41,8 @@ files:
 - example/Bird.md
 - example/Duck.md
 - example/Waterfowl.md
-- lib/yard/markdown.rb
-- lib/yard/markdown/version.rb
-- lib/yard/serializers/markdown_serializer.rb
+- lib/yard-markdown.rb
 - sig/yard/markdown.rbs
-- templates/default/fulldoc/markdown/content.erb
 - templates/default/fulldoc/markdown/setup.rb
 homepage: https://poshtui.com
 licenses:
@@ -54,8 +65,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
+rubygems_version: 3.4.22
 signing_key:
 specification_version: 4
-summary: yard-markdown is a yard plugin template to generate markdown files
+summary: yard theme plugin that generates markdown documentation for gems
 test_files: []

data/lib/yard/markdown/version.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module YARD
-  module Markdown
-    VERSION = "0.1.0"
-  end
-end

data/lib/yard/markdown.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-require "yard"
-require_relative "markdown/version"
-require_relative "serializers/markdown_serializer"
-
-module YARD
-  module Markdown
-    YARD::Templates::Engine.register_template_path "/../../templates"
-  end
-end

data/lib/yard/serializers/markdown_serializer.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-module YARD
-  module Serializers
-    class MarkdownSerializer < YARD::Serializers::FileSystemSerializer
-      def initialize(opts = {})
-        super(opts.merge(extension: "md"))
-      end
-    end
-  end
-end

data/templates/default/fulldoc/markdown/content.erb

@@ -1,2 +0,0 @@
-# Test
-<%= @object.docstring %>