rdoc-markdown 0.17.2 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +8 -1
  3. data/README.md +19 -82
  4. data/lib/markdown.rb +0 -4
  5. data/lib/rdoc/discover.rb +1 -7
  6. data/lib/rdoc/generator/markdown/conversion.rb +196 -0
  7. data/lib/rdoc/generator/markdown/crossref.rb +13 -5
  8. data/lib/rdoc/generator/markdown/descriptions.rb +163 -0
  9. data/lib/rdoc/generator/markdown/index.rb +47 -0
  10. data/lib/rdoc/generator/markdown/paths.rb +118 -0
  11. data/lib/rdoc/generator/markdown/selection.rb +39 -0
  12. data/lib/rdoc/generator/markdown/signatures.rb +174 -0
  13. data/lib/rdoc/generator/markdown.rb +80 -680
  14. data/lib/rdoc/markdown/version.rb +1 -1
  15. data/lib/templates/classfile.md.erb +14 -11
  16. metadata +19 -43
  17. data/.editorconfig +0 -13
  18. data/.erb_lint.yml +0 -36
  19. data/.erb_linters/no_embedded_assets.rb +0 -29
  20. data/.erb_linters/non_raw_html.rb +0 -29
  21. data/.standard.yml +0 -3
  22. data/.yard-lint.yml +0 -290
  23. data/AGENTS.md +0 -50
  24. data/CODE_OF_CONDUCT.md +0 -84
  25. data/Gemfile +0 -13
  26. data/Gemfile.lock +0 -202
  27. data/Rakefile +0 -296
  28. data/example/Bird.md +0 -21
  29. data/example/Duck.md +0 -56
  30. data/example/Object.md +0 -8
  31. data/example/Waterfowl.md +0 -9
  32. data/example/index.csv +0 -16
  33. data/example/jekyll-seo-tag/Jekyll/SeoTag/AuthorDrop.md +0 -35
  34. data/example/jekyll-seo-tag/Jekyll/SeoTag/Drop.md +0 -108
  35. data/example/jekyll-seo-tag/Jekyll/SeoTag/Filters.md +0 -8
  36. data/example/jekyll-seo-tag/Jekyll/SeoTag/ImageDrop.md +0 -29
  37. data/example/jekyll-seo-tag/Jekyll/SeoTag/JSONLD.md +0 -15
  38. data/example/jekyll-seo-tag/Jekyll/SeoTag/JSONLDDrop.md +0 -34
  39. data/example/jekyll-seo-tag/Jekyll/SeoTag/UrlHelper.md +0 -4
  40. data/example/jekyll-seo-tag/Jekyll/SeoTag.md +0 -48
  41. data/example/jekyll-seo-tag/Jekyll.md +0 -3
  42. data/example/jekyll-seo-tag/Liquid/Tag.md +0 -3
  43. data/example/jekyll-seo-tag/Liquid.md +0 -4
  44. data/example/jekyll-seo-tag/index.csv +0 -60
  45. data/mutant.yml +0 -15
  46. data/rdoc-markdown.gemspec +0 -46
data/example/index.csv DELETED
@@ -1,16 +0,0 @@
1
- name,type,path
2
- Bird,Class,Bird.md
3
- Bird.speak,Method,Bird.md#method-i-speak
4
- Bird.fly,Method,Bird.md#method-i-fly
5
- Duck,Class,Duck.md
6
- Duck.speak,Method,Duck.md#method-i-speak
7
- Duck.rubber_ducks,Method,Duck.md#method-c-rubber_ducks
8
- Duck.new,Method,Duck.md#method-c-new
9
- Duck.useful?,Method,Duck.md#method-i-useful-3F
10
- Duck.MAX_VELOCITY,Constant,Duck.md#MAX_VELOCITY
11
- Duck.domestic,Attribute,Duck.md#attribute-i-domestic
12
- Duck.rubber,Attribute,Duck.md#attribute-i-rubber
13
- Object,Class,Object.md
14
- Object.DEFAULT_DUCK_VELOCITY,Constant,Object.md#DEFAULT_DUCK_VELOCITY
15
- Waterfowl,Module,Waterfowl.md
16
- Waterfowl.swim,Method,Waterfowl.md#method-i-swim
@@ -1,35 +0,0 @@
1
- <a id="class-jekyll-seotag-authordrop"></a>
2
- # Class Jekyll::SeoTag::AuthorDrop
3
- A drop representing the current page’s author
4
-
5
- Author name will be pulled from:
6
-
7
- 1. The page’s `author` key
8
-
9
- 2. The first author in the page’s `authors` key
10
-
11
- 3. The `author` key in the site config
12
-
13
- If the result from the name search is a string, we’ll also check for additional author metadata in `site.data.authors`
14
-
15
- ### Public Class Methods
16
-
17
- <a id="method-c-new"></a>
18
- #### `new(page: nil, site: nil)`
19
- Initialize a new [`AuthorDrop`](AuthorDrop.md)
20
-
21
- page - The page hash (e.g., Page#to\_liquid) site - The Jekyll::Drops::SiteDrop
22
-
23
- ### Public Instance Methods
24
-
25
- <a id="method-i-name"></a>
26
- #### `name()`
27
- [`AuthorDrop#to_s`](AuthorDrop.md#method-i-to_s) should return name, allowing the author drop to safely replace `page.author`, if necessary, and remain backwards compatible
28
-
29
- <a id="method-i-to_s"></a>
30
- #### `to_s()`
31
- Alias for: [`name`](#method-i-name)
32
-
33
- <a id="method-i-twitter"></a>
34
- #### `twitter()`
35
- Not documented.
@@ -1,108 +0,0 @@
1
- <a id="class-jekyll-seotag-drop"></a>
2
- # Class Jekyll::SeoTag::Drop
3
-
4
- ### Constants
5
-
6
- <a id="FORMAT_STRING_METHODS"></a>
7
- #### `FORMAT_STRING_METHODS`
8
- Not documented.
9
-
10
- <a id="HOMEPAGE_OR_ABOUT_REGEX"></a>
11
- #### `HOMEPAGE_OR_ABOUT_REGEX`
12
- Not documented.
13
-
14
- <a id="TITLE_SEPARATOR"></a>
15
- #### `TITLE_SEPARATOR`
16
- Not documented.
17
-
18
- ### Public Class Methods
19
-
20
- <a id="method-c-new"></a>
21
- #### `new(text, context)`
22
- Not documented.
23
-
24
- ### Public Instance Methods
25
-
26
- <a id="method-i-author"></a>
27
- #### `author()`
28
- A drop representing the page author
29
-
30
- <a id="method-i-canonical_url"></a>
31
- #### `canonical_url()`
32
- Not documented.
33
-
34
- <a id="method-i-date_modified"></a>
35
- #### `date_modified()`
36
- Not documented.
37
-
38
- <a id="method-i-date_published"></a>
39
- #### `date_published()`
40
- Not documented.
41
-
42
- <a id="method-i-description"></a>
43
- #### `description()`
44
- Not documented.
45
-
46
- <a id="method-i-image"></a>
47
- #### `image()`
48
- Returns a [`Drop`](Drop.md) representing the page’s image Returns nil if the image has no path, to preserve backwards compatability
49
-
50
- <a id="method-i-json_ld"></a>
51
- #### `json_ld()`
52
- A drop representing the JSON-LD output
53
-
54
- <a id="method-i-links"></a>
55
- #### `links()`
56
- Not documented.
57
-
58
- <a id="method-i-logo"></a>
59
- #### `logo()`
60
- Not documented.
61
-
62
- <a id="method-i-name"></a>
63
- #### `name()`
64
- rubocop:enable Metrics/CyclomaticComplexity
65
-
66
- <a id="method-i-page_lang"></a>
67
- #### `page_lang()`
68
- Not documented.
69
-
70
- <a id="method-i-page_locale"></a>
71
- #### `page_locale()`
72
- Not documented.
73
-
74
- <a id="method-i-page_title"></a>
75
- #### `page_title()`
76
- Page title without site title or description appended
77
-
78
- <a id="method-i-site_description"></a>
79
- #### `site_description()`
80
- Not documented.
81
-
82
- <a id="method-i-site_tagline"></a>
83
- #### `site_tagline()`
84
- Not documented.
85
-
86
- <a id="method-i-site_tagline_or_description"></a>
87
- #### `site_tagline_or_description()`
88
- Not documented.
89
-
90
- <a id="method-i-site_title"></a>
91
- #### `site_title()`
92
- Not documented.
93
-
94
- <a id="method-i-title"></a>
95
- #### `title()`
96
- Page title with site title or description appended rubocop:disable Metrics/CyclomaticComplexity
97
-
98
- <a id="method-i-title-3F"></a>
99
- #### `title?()`
100
- Should the ‘\<title\>` tag be generated for this page?
101
-
102
- <a id="method-i-type"></a>
103
- #### `type()`
104
- Not documented.
105
-
106
- <a id="method-i-version"></a>
107
- #### `version()`
108
- Not documented.
@@ -1,8 +0,0 @@
1
- <a id="class-jekyll-seotag-filters"></a>
2
- # Class Jekyll::SeoTag::Filters
3
-
4
- ### Public Class Methods
5
-
6
- <a id="method-c-new"></a>
7
- #### `new(context)`
8
- Not documented.
@@ -1,29 +0,0 @@
1
- <a id="class-jekyll-seotag-imagedrop"></a>
2
- # Class Jekyll::SeoTag::ImageDrop
3
- A drop representing the page image The image path will be pulled from:
4
-
5
- 1. The `image` key if it’s a string
6
-
7
- 2. The `image.path` key if it’s a hash
8
-
9
- 3. The `image.facebook` key
10
-
11
- 4. The `image.twitter` key
12
-
13
- ### Public Class Methods
14
-
15
- <a id="method-c-new"></a>
16
- #### `new(page: nil, context: nil)`
17
- Initialize a new [`ImageDrop`](ImageDrop.md)
18
-
19
- page - The page hash (e.g., Page#to\_liquid) context - the Liquid::Context
20
-
21
- ### Public Instance Methods
22
-
23
- <a id="method-i-path"></a>
24
- #### `path()`
25
- Called path for backwards compatability, this is really the escaped, absolute URL representing the page’s image Returns nil if no image path can be determined
26
-
27
- <a id="method-i-to_s"></a>
28
- #### `to_s()`
29
- Alias for: [`path`](#method-i-path)
@@ -1,15 +0,0 @@
1
- <a id="module-jekyll-seotag-jsonld"></a>
2
- # Module Jekyll::SeoTag::JSONLD
3
- This module is deprecated, but is included in the Gem to avoid a breaking change and should be removed at the next major version bump
4
-
5
- ### Constants
6
-
7
- <a id="METHODS_KEYS"></a>
8
- #### `METHODS_KEYS`
9
- Not documented.
10
-
11
- ### Public Instance Methods
12
-
13
- <a id="method-i-json_ld"></a>
14
- #### `json_ld()`
15
- Self should be a [`Jekyll::SeoTag::Drop`](Drop.md) instance (when extending the module)
@@ -1,34 +0,0 @@
1
- <a id="class-jekyll-seotag-jsonlddrop"></a>
2
- # Class Jekyll::SeoTag::JSONLDDrop
3
-
4
- ### Public Class Methods
5
-
6
- <a id="method-c-new"></a>
7
- #### `new(page_drop)`
8
- page\_drop should be an instance of [`Jekyll::SeoTag::Drop`](Drop.md)
9
-
10
- ### Public Instance Methods
11
-
12
- <a id="method-i-author"></a>
13
- #### `author()`
14
- Not documented.
15
-
16
- <a id="method-i-fallback_data"></a>
17
- #### `fallback_data()`
18
- Not documented.
19
-
20
- <a id="method-i-image"></a>
21
- #### `image()`
22
- Not documented.
23
-
24
- <a id="method-i-mainEntityOfPage"></a>
25
- #### `mainEntityOfPage()`
26
- Alias for: [`main_entity`](#method-i-main_entity)
27
-
28
- <a id="method-i-publisher"></a>
29
- #### `publisher()`
30
- Not documented.
31
-
32
- <a id="method-i-to_json"></a>
33
- #### `to_json(state = nil)`
34
- Returns a JSON-encoded object containing the JSON-LD data. Keys are sorted.
@@ -1,4 +0,0 @@
1
- <a id="module-jekyll-seotag-urlhelper"></a>
2
- # Module Jekyll::SeoTag::UrlHelper
3
- Mixin to share common URL-related methods between class
4
-
@@ -1,48 +0,0 @@
1
- <a id="class-jekyll-seotag"></a>
2
- # Class Jekyll::SeoTag
3
-
4
- ### Constants
5
-
6
- <a id="MINIFY_REGEX"></a>
7
- #### `MINIFY_REGEX`
8
- Matches all whitespace that follows either
9
-
10
- ```
11
- 1. A '}', which closes a Liquid tag
12
- 2. A '{', which opens a JSON block
13
- 3. A '>' followed by a newline, which closes an XML tag or
14
- 4. A ',' followed by a newline, which ends a JSON line
15
- ```
16
-
17
- We will strip all of this whitespace to minify the template We will not strip any whitespace if the next character is a ‘-’
18
-
19
- ```
20
- so that we do not interfere with the HTML comment at the
21
- very begining
22
- ```
23
-
24
- <a id="VERSION"></a>
25
- #### `VERSION`
26
- Not documented.
27
-
28
- ### Attributes
29
-
30
- <a id="attribute-i-context"></a>
31
- #### `context` [RW]
32
- Not documented.
33
-
34
- ### Public Class Methods
35
-
36
- <a id="method-c-new"></a>
37
- #### `new(_tag_name, text, _tokens)`
38
- Not documented.
39
-
40
- <a id="method-c-template"></a>
41
- #### `template()`
42
- Not documented.
43
-
44
- ### Public Instance Methods
45
-
46
- <a id="method-i-render"></a>
47
- #### `render(context)`
48
- Not documented.
@@ -1,3 +0,0 @@
1
- <a id="module-jekyll"></a>
2
- # Module Jekyll
3
-
@@ -1,3 +0,0 @@
1
- <a id="class-liquid-tag"></a>
2
- # Class Liquid::Tag
3
-
@@ -1,4 +0,0 @@
1
- <a id="module-liquid"></a>
2
- # Module Liquid
3
- Prevent bundler errors
4
-
@@ -1,60 +0,0 @@
1
- name,type,path
2
- Jekyll,Module,Jekyll.md
3
- Jekyll::SeoTag,Class,Jekyll/SeoTag.md
4
- Jekyll::SeoTag.new,Method,Jekyll/SeoTag.md#method-c-new
5
- Jekyll::SeoTag.render,Method,Jekyll/SeoTag.md#method-i-render
6
- Jekyll::SeoTag.template,Method,Jekyll/SeoTag.md#method-c-template
7
- Jekyll::SeoTag.MINIFY_REGEX,Constant,Jekyll/SeoTag.md#MINIFY_REGEX
8
- Jekyll::SeoTag.VERSION,Constant,Jekyll/SeoTag.md#VERSION
9
- Jekyll::SeoTag.context,Attribute,Jekyll/SeoTag.md#attribute-i-context
10
- Jekyll::SeoTag::AuthorDrop,Class,Jekyll/SeoTag/AuthorDrop.md
11
- Jekyll::SeoTag::AuthorDrop.new,Method,Jekyll/SeoTag/AuthorDrop.md#method-c-new
12
- Jekyll::SeoTag::AuthorDrop.name,Method,Jekyll/SeoTag/AuthorDrop.md#method-i-name
13
- Jekyll::SeoTag::AuthorDrop.to_s,Method,Jekyll/SeoTag/AuthorDrop.md#method-i-to_s
14
- Jekyll::SeoTag::AuthorDrop.twitter,Method,Jekyll/SeoTag/AuthorDrop.md#method-i-twitter
15
- Jekyll::SeoTag::Drop,Class,Jekyll/SeoTag/Drop.md
16
- Jekyll::SeoTag::Drop.new,Method,Jekyll/SeoTag/Drop.md#method-c-new
17
- Jekyll::SeoTag::Drop.version,Method,Jekyll/SeoTag/Drop.md#method-i-version
18
- Jekyll::SeoTag::Drop.title?,Method,Jekyll/SeoTag/Drop.md#method-i-title-3F
19
- Jekyll::SeoTag::Drop.site_title,Method,Jekyll/SeoTag/Drop.md#method-i-site_title
20
- Jekyll::SeoTag::Drop.site_tagline,Method,Jekyll/SeoTag/Drop.md#method-i-site_tagline
21
- Jekyll::SeoTag::Drop.site_description,Method,Jekyll/SeoTag/Drop.md#method-i-site_description
22
- Jekyll::SeoTag::Drop.page_title,Method,Jekyll/SeoTag/Drop.md#method-i-page_title
23
- Jekyll::SeoTag::Drop.site_tagline_or_description,Method,Jekyll/SeoTag/Drop.md#method-i-site_tagline_or_description
24
- Jekyll::SeoTag::Drop.title,Method,Jekyll/SeoTag/Drop.md#method-i-title
25
- Jekyll::SeoTag::Drop.name,Method,Jekyll/SeoTag/Drop.md#method-i-name
26
- Jekyll::SeoTag::Drop.description,Method,Jekyll/SeoTag/Drop.md#method-i-description
27
- Jekyll::SeoTag::Drop.author,Method,Jekyll/SeoTag/Drop.md#method-i-author
28
- Jekyll::SeoTag::Drop.json_ld,Method,Jekyll/SeoTag/Drop.md#method-i-json_ld
29
- Jekyll::SeoTag::Drop.image,Method,Jekyll/SeoTag/Drop.md#method-i-image
30
- Jekyll::SeoTag::Drop.date_modified,Method,Jekyll/SeoTag/Drop.md#method-i-date_modified
31
- Jekyll::SeoTag::Drop.date_published,Method,Jekyll/SeoTag/Drop.md#method-i-date_published
32
- Jekyll::SeoTag::Drop.type,Method,Jekyll/SeoTag/Drop.md#method-i-type
33
- Jekyll::SeoTag::Drop.links,Method,Jekyll/SeoTag/Drop.md#method-i-links
34
- Jekyll::SeoTag::Drop.logo,Method,Jekyll/SeoTag/Drop.md#method-i-logo
35
- Jekyll::SeoTag::Drop.page_lang,Method,Jekyll/SeoTag/Drop.md#method-i-page_lang
36
- Jekyll::SeoTag::Drop.page_locale,Method,Jekyll/SeoTag/Drop.md#method-i-page_locale
37
- Jekyll::SeoTag::Drop.canonical_url,Method,Jekyll/SeoTag/Drop.md#method-i-canonical_url
38
- Jekyll::SeoTag::Drop.FORMAT_STRING_METHODS,Constant,Jekyll/SeoTag/Drop.md#FORMAT_STRING_METHODS
39
- Jekyll::SeoTag::Drop.HOMEPAGE_OR_ABOUT_REGEX,Constant,Jekyll/SeoTag/Drop.md#HOMEPAGE_OR_ABOUT_REGEX
40
- Jekyll::SeoTag::Drop.TITLE_SEPARATOR,Constant,Jekyll/SeoTag/Drop.md#TITLE_SEPARATOR
41
- Jekyll::SeoTag::Filters,Class,Jekyll/SeoTag/Filters.md
42
- Jekyll::SeoTag::Filters.new,Method,Jekyll/SeoTag/Filters.md#method-c-new
43
- Jekyll::SeoTag::ImageDrop,Class,Jekyll/SeoTag/ImageDrop.md
44
- Jekyll::SeoTag::ImageDrop.new,Method,Jekyll/SeoTag/ImageDrop.md#method-c-new
45
- Jekyll::SeoTag::ImageDrop.path,Method,Jekyll/SeoTag/ImageDrop.md#method-i-path
46
- Jekyll::SeoTag::ImageDrop.to_s,Method,Jekyll/SeoTag/ImageDrop.md#method-i-to_s
47
- Jekyll::SeoTag::JSONLD,Module,Jekyll/SeoTag/JSONLD.md
48
- Jekyll::SeoTag::JSONLD.json_ld,Method,Jekyll/SeoTag/JSONLD.md#method-i-json_ld
49
- Jekyll::SeoTag::JSONLD.METHODS_KEYS,Constant,Jekyll/SeoTag/JSONLD.md#METHODS_KEYS
50
- Jekyll::SeoTag::JSONLDDrop,Class,Jekyll/SeoTag/JSONLDDrop.md
51
- Jekyll::SeoTag::JSONLDDrop.new,Method,Jekyll/SeoTag/JSONLDDrop.md#method-c-new
52
- Jekyll::SeoTag::JSONLDDrop.fallback_data,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-fallback_data
53
- Jekyll::SeoTag::JSONLDDrop.author,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-author
54
- Jekyll::SeoTag::JSONLDDrop.image,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-image
55
- Jekyll::SeoTag::JSONLDDrop.publisher,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-publisher
56
- Jekyll::SeoTag::JSONLDDrop.mainEntityOfPage,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-mainEntityOfPage
57
- Jekyll::SeoTag::JSONLDDrop.to_json,Method,Jekyll/SeoTag/JSONLDDrop.md#method-i-to_json
58
- Jekyll::SeoTag::UrlHelper,Module,Jekyll/SeoTag/UrlHelper.md
59
- Liquid,Module,Liquid.md
60
- Liquid::Tag,Class,Liquid/Tag.md
data/mutant.yml DELETED
@@ -1,15 +0,0 @@
1
- usage: opensource
2
-
3
- integration:
4
- name: minitest
5
-
6
- includes:
7
- - lib
8
- - test
9
-
10
- requires:
11
- - ./test/support/mutant.rb
12
-
13
- matcher:
14
- subjects:
15
- - RDoc::Generator::Markdown*
@@ -1,46 +0,0 @@
1
- # frozen_string_literal: true
2
-
3
- require_relative "lib/rdoc/markdown/version"
4
-
5
- Gem::Specification.new do |spec|
6
- spec.name = "rdoc-markdown"
7
- spec.version = Rdoc::Markdown::VERSION
8
- spec.authors = ["Stanislav (Stas) Katkov"]
9
- spec.email = ["github@skatkov.com"]
10
- spec.license = "GPL-3.0-or-later"
11
-
12
- spec.summary = "RDoc plugin to generate markdown documentation "
13
- spec.description = "RDoc plugin to generate markdown documentation and search index as sqlite database for entire content."
14
- spec.homepage = "https://poshtui.com"
15
- spec.required_ruby_version = ">= 3.3.0"
16
-
17
- # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
18
-
19
- spec.metadata["homepage_uri"] = spec.homepage
20
- spec.metadata["source_code_uri"] = "https://github.com/skatkov/rdoc-markdown"
21
- spec.metadata["changelog_uri"] = "https://github.com/skatkov/rdoc-markdown"
22
-
23
- # Specify which files should be added to the gem when it is released.
24
- # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
25
- spec.files = Dir.chdir(__dir__) do
26
- `git ls-files -z`.split("\x0").reject do |f|
27
- (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
28
- end
29
- end
30
- spec.bindir = "exe"
31
- spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
32
- spec.require_paths = ["lib"]
33
-
34
- spec.add_dependency "csv"
35
- spec.add_dependency "erb"
36
- spec.add_dependency "rdoc", ">= 8.0"
37
- spec.add_dependency "reverse_markdown"
38
-
39
- spec.add_development_dependency "bundler", ">= 2.0"
40
- spec.add_development_dependency "commonmarker"
41
- spec.add_development_dependency "minitest", "~> 5.0"
42
- spec.add_development_dependency "minitest-strict", "~> 1.0"
43
- spec.add_development_dependency "rake", "~> 13.0"
44
- spec.add_development_dependency "rdiscount", "~> 2.0"
45
- spec.add_development_dependency "simplecov", "~> 0.22"
46
- end