markdown_helper 0.2.3 → 0.2.4

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.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: f09669b50665a49012e58c114423d8cadbabdd78
4
- data.tar.gz: 5e7efd7f10b45d9e55800be245016d8c221451ba
3
+ metadata.gz: 128fe00dd89389615391ceb4cc69127317a7249b
4
+ data.tar.gz: bc50bd8214659764a83503c2a02f36a8c5795ec7
5
5
  SHA512:
6
- metadata.gz: 97c756477a554d5b64800c58154a329512817134004a72ea8daa458190ca13332b93844b4810fcbf41b77f85ac5af3991a03d39b39b7053d6aa723aa6ff2217c
7
- data.tar.gz: 5ddf37cb2ab123d4cc24d6aa60f1a45fea125774cb608e06cb2e8a8138b3e9a923d95c2f953586130ac8ecc971ca525de449c8a3088b0959d2c701d3791ab598
6
+ metadata.gz: 6b11b8fc50ede26c160679b2fa750653e8f1b78e84b824052c233a53a35d2672812b322e76aab382e3476fa5c0ba1c21935fecc154cefd7bd22c54cc38cb11eb
7
+ data.tar.gz: efe58d2174a05141b743346b0a9fe043681fcd30f13111400d67c25b5015e5bbdfd771116d9cc64c4db3724061130af82ecaee2817f39a2de6c85e4ffd6ef203
data/Gemfile.lock CHANGED
@@ -1,7 +1,7 @@
1
1
  PATH
2
2
  remote: .
3
3
  specs:
4
- markdown_helper (0.2.3)
4
+ markdown_helper (0.2.4)
5
5
 
6
6
  GEM
7
7
  remote: https://rubygems.org/
data/README.md CHANGED
@@ -2,17 +2,15 @@
2
2
  <!-- >>>>>> BEGIN GENERATED FILE (resolve): SOURCE readme_files/README.template.md -->
3
3
  # MarkdownHelper
4
4
 
5
+ ## What's This?
6
+
5
7
  [![Gem Version](https://badge.fury.io/rb/markdown_helper.svg)](https://badge.fury.io/rb/markdown_helper)
6
8
 
7
9
  Class <code>MarkdownHelper</code> supports:
8
10
 
9
11
  * [File inclusion](#file-inclusion): to include text from other files, as code-block or markdown.
10
12
  * [Image path resolution](#image-path-resolution): to resolve relative image paths to absolute URL paths (so they work even in gem documentation).
11
- * [Image attributes](#image-attrubutes): image attributes are passed through to an HTML <code>img</code> tag.
12
-
13
- Next feature:
14
-
15
- * "Slide deck": to chain markdown pages into a series with next/prev navigation links.
13
+ * [Image attributes](#image-attributes): image attributes are passed through to an HTML <code>img</code> tag.
16
14
 
17
15
  ## How It Works
18
16
 
@@ -20,6 +18,8 @@ The markdown helper reads a markdown document (template) and writes another mark
20
18
 
21
19
  The template can contain certain instructions that call for file inclusions and image resolutions.
22
20
 
21
+ ## Commented or Pristine?
22
+
23
23
  By default, the output markdown has added comments that show:
24
24
 
25
25
  * The path to the template file.
@@ -27,6 +27,7 @@ By default, the output markdown has added comments that show:
27
27
  * The image description (original) for each resolved image file path.
28
28
 
29
29
  You can suppress those comments using the <code>pristine</code> option.
30
+
30
31
  ## File Inclusion
31
32
 
32
33
  <!-- >>>>>> BEGIN RESOLVED IMAGE: DESCRIPTION '![include_icon](images/include.png | width=50)
@@ -315,5 +316,16 @@ where:
315
316
  ```
316
317
  <!-- <<<<<< END INCLUDED FILE (code_block): SOURCE readme_files/resolve.md -->
317
318
 
319
+ ## What Should Be Next?
320
+
321
+ I have opened some enhancement Issues in the GitHub [MarkdownHelper](https://github.com/BurdetteLamar/MarkdownHelper) project:
322
+
323
+ * [Pagination](https://github.com/BurdetteLamar/MarkdownHelper/issues/40): series of markdown pages connected by prev/next navigation links.
324
+ * [Partial file inclusion](https://github.com/BurdetteLamar/MarkdownHelper/issues/38): including only specified lines from a file (instead of the whole file).
325
+ * [Ruby-entity inclusion](https://github.com/BurdetteLamar/MarkdownHelper/issues/39): like file inclusion, but including a Ruby class, module, or method.
326
+ * [File TOC](https://github.com/BurdetteLamar/MarkdownHelper/issues/36): table of contents of all headers in a markdown page.
327
+ * [Project TOC](https://github.com/BurdetteLamar/MarkdownHelper/issues/37): table of contents of all markdown pages in project.
328
+
329
+ Feel free to comment on any of these, or to add more Issues (enhancement or otherwise).
318
330
  <!-- <<<<<< END GENERATED FILE (resolve): SOURCE readme_files/README.template.md -->
319
331
  <!-- <<<<<< END GENERATED FILE (include): SOURCE readme_files/temp_resolved.md -->
@@ -1,3 +1,3 @@
1
1
  class MarkdownHelper
2
- VERSION = '0.2.3'
2
+ VERSION = '0.2.4'
3
3
  end
@@ -1,16 +1,14 @@
1
1
  # MarkdownHelper
2
2
 
3
+ ## What's This?
4
+
3
5
  [![Gem Version](https://badge.fury.io/rb/markdown_helper.svg)](https://badge.fury.io/rb/markdown_helper)
4
6
 
5
7
  Class <code>MarkdownHelper</code> supports:
6
8
 
7
9
  * [File inclusion](#file-inclusion): to include text from other files, as code-block or markdown.
8
10
  * [Image path resolution](#image-path-resolution): to resolve relative image paths to absolute URL paths (so they work even in gem documentation).
9
- * [Image attributes](#image-attrubutes): image attributes are passed through to an HTML <code>img</code> tag.
10
-
11
- Next feature:
12
-
13
- * "Slide deck": to chain markdown pages into a series with next/prev navigation links.
11
+ * [Image attributes](#image-attributes): image attributes are passed through to an HTML <code>img</code> tag.
14
12
 
15
13
  ## How It Works
16
14
 
@@ -18,6 +16,8 @@ The markdown helper reads a markdown document (template) and writes another mark
18
16
 
19
17
  The template can contain certain instructions that call for file inclusions and image resolutions.
20
18
 
19
+ ## Commented or Pristine?
20
+
21
21
  By default, the output markdown has added comments that show:
22
22
 
23
23
  * The path to the template file.
@@ -25,6 +25,7 @@ By default, the output markdown has added comments that show:
25
25
  * The image description (original) for each resolved image file path.
26
26
 
27
27
  You can suppress those comments using the <code>pristine</code> option.
28
+
28
29
  ## File Inclusion
29
30
 
30
31
  ![include_icon](images/include.png | width=50)
@@ -157,3 +158,14 @@ where:
157
158
 
158
159
  @[code_block](resolve.md)
159
160
 
161
+ ## What Should Be Next?
162
+
163
+ I have opened some enhancement Issues in the GitHub [MarkdownHelper](https://github.com/BurdetteLamar/MarkdownHelper) project:
164
+
165
+ * [Pagination](https://github.com/BurdetteLamar/MarkdownHelper/issues/40): series of markdown pages connected by prev/next navigation links.
166
+ * [Partial file inclusion](https://github.com/BurdetteLamar/MarkdownHelper/issues/38): including only specified lines from a file (instead of the whole file).
167
+ * [Ruby-entity inclusion](https://github.com/BurdetteLamar/MarkdownHelper/issues/39): like file inclusion, but including a Ruby class, module, or method.
168
+ * [File TOC](https://github.com/BurdetteLamar/MarkdownHelper/issues/36): table of contents of all headers in a markdown page.
169
+ * [Project TOC](https://github.com/BurdetteLamar/MarkdownHelper/issues/37): table of contents of all markdown pages in project.
170
+
171
+ Feel free to comment on any of these, or to add more Issues (enhancement or otherwise).
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: markdown_helper
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.2.3
4
+ version: 0.2.4
5
5
  platform: ruby
6
6
  authors:
7
7
  - burdettelamar
8
8
  autorequire:
9
9
  bindir: exe
10
10
  cert_chain: []
11
- date: 2018-03-14 00:00:00.000000000 Z
11
+ date: 2018-03-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: bundler