riven 1.1.2 → 1.1.3
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 +4 -4
- data/.gitignore +1 -0
- data/Gemfile.lock +1 -1
- data/README.md +10 -23
- data/lib/riven/markup_file.rb +2 -2
- data/lib/riven/opt_parser.rb +2 -1
- data/lib/riven/version.rb +2 -2
- metadata +1 -9
- data/doc/chapters/1-what-is-riven/index.md +0 -15
- data/doc/chapters/2-setup/index.md +0 -0
- data/doc/chapters/3-basics/index.md +0 -0
- data/doc/chapters/4-advanced-usage/index.md +0 -0
- data/doc/cover.md +0 -39
- data/doc/img/cover.png +0 -0
- data/doc/index.md +0 -4
- data/doc/riven.pdf +0 -0
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: b1fec2b7cfe9006f62d2698662b853c3316b0dad
|
|
4
|
+
data.tar.gz: de862e64da2cd58c5b3c5d6e6c84bff7a633cf06
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ac12bff4693139e89663306b4fce14eb6c3446c560abe2c7bd8503faed9bb5a9e3126729155ad7cc99334b0d744365126bf9f4a53ed963ca2c7ee74ebcdec2da
|
|
7
|
+
data.tar.gz: 7bae00360b4eb869b090e495b9583917ae74ea06c72c771aaa030cbe1f66a37f9b16c46850f5946dc3cf873a0a02c594b8815c68c18465a88e3b56d3e8c2b682
|
data/.gitignore
CHANGED
data/Gemfile.lock
CHANGED
data/README.md
CHANGED
|
@@ -1,13 +1,12 @@
|
|
|
1
1
|
# Riven
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Converts GitHub Flavored Markdown files to PDFs! Write documentations, books, reports and documents with your editor.
|
|
4
4
|
Publish them as PDF! It's that simple and even more powerful.
|
|
5
5
|
|
|
6
6
|
|
|
7
7
|
Feature highlights:
|
|
8
8
|
|
|
9
|
-
- Riven Extended Markdown
|
|
10
|
-
- Includes: Structure you work!
|
|
9
|
+
- Riven Extended Markdown featuring includes: Structure you work!
|
|
11
10
|
- Generates well readable, optimized, beautiful looking PDFs
|
|
12
11
|
- Style your PDF via CSS
|
|
13
12
|
- Define a special and nice looking cover page
|
|
@@ -40,7 +39,7 @@ If it works, everything is nice and you may proceed with the next step. If not,
|
|
|
40
39
|
correctly installed and the executable is within your `PATH`.
|
|
41
40
|
|
|
42
41
|
|
|
43
|
-
##
|
|
42
|
+
## Installation
|
|
44
43
|
|
|
45
44
|
Simple as usual:
|
|
46
45
|
|
|
@@ -49,32 +48,20 @@ $ gem install riven
|
|
|
49
48
|
```
|
|
50
49
|
|
|
51
50
|
|
|
52
|
-
##
|
|
51
|
+
## Usage
|
|
53
52
|
|
|
54
53
|
Riven is designed to create documents out of a bunch of markdown files. So it may take a single markdown file or a
|
|
55
|
-
directory with some markdown files inside.
|
|
56
|
-
|
|
57
|
-
However the basic usage is very simple. This example will take your `example.md` and generate a `example.pdf` in the
|
|
58
|
-
same directory:
|
|
59
|
-
|
|
60
|
-
```bash
|
|
61
|
-
$ riven example.md
|
|
62
|
-
```
|
|
63
|
-
|
|
64
|
-
Couldn't be easier!
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
## Looking for an example?
|
|
68
|
-
|
|
69
|
-
You'll find a considerable example of a markdown based documentation in the doc directory of riven itself. And **here**
|
|
70
|
-
you finde the resulting PDF with the documentation of riven.
|
|
71
|
-
|
|
72
|
-
|
|
54
|
+
directory with some markdown files inside. Consider that the files are merged in alphabetical order if you provide a
|
|
55
|
+
folder. Just take a look at the following examples.
|
|
73
56
|
|
|
74
57
|
|
|
75
58
|
### Single file to PDF
|
|
76
59
|
|
|
60
|
+
This will take your `example.md` and generate a `example.pdf` in the same directory:
|
|
77
61
|
|
|
62
|
+
```bash
|
|
63
|
+
$ riven example.md
|
|
64
|
+
```
|
|
78
65
|
|
|
79
66
|
|
|
80
67
|
### Multiple files
|
data/lib/riven/markup_file.rb
CHANGED
|
@@ -57,11 +57,11 @@ module Riven
|
|
|
57
57
|
#
|
|
58
58
|
|
|
59
59
|
public def rewrite_paths
|
|
60
|
-
@markup.gsub!(/\[([^\]]+)\]\(([^\)]+)\)/) do |
|
|
60
|
+
@markup.gsub!(/\[([^\]]+)\]\(([^\)]+)\)/) do |match|
|
|
61
61
|
label = $1
|
|
62
62
|
ref = $2
|
|
63
63
|
|
|
64
|
-
if
|
|
64
|
+
if ref =~ /^http(s)?/
|
|
65
65
|
"[#{label}](#{ref})"
|
|
66
66
|
else
|
|
67
67
|
puts " - Rewriting ref '#{ref}' to '#{@dirname}/#{ref}'"
|
data/lib/riven/opt_parser.rb
CHANGED
data/lib/riven/version.rb
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
|
|
2
|
-
VERSION = '1.1.
|
|
1
|
+
module Riven
|
|
2
|
+
VERSION = '1.1.3'
|
|
3
3
|
end
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: riven
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.1.
|
|
4
|
+
version: 1.1.3
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Benjamin Kammerl
|
|
@@ -81,14 +81,6 @@ files:
|
|
|
81
81
|
- README.md
|
|
82
82
|
- bin/riven
|
|
83
83
|
- css/style.css
|
|
84
|
-
- doc/chapters/1-what-is-riven/index.md
|
|
85
|
-
- doc/chapters/2-setup/index.md
|
|
86
|
-
- doc/chapters/3-basics/index.md
|
|
87
|
-
- doc/chapters/4-advanced-usage/index.md
|
|
88
|
-
- doc/cover.md
|
|
89
|
-
- doc/img/cover.png
|
|
90
|
-
- doc/index.md
|
|
91
|
-
- doc/riven.pdf
|
|
92
84
|
- lib/riven.rb
|
|
93
85
|
- lib/riven/html_file.rb
|
|
94
86
|
- lib/riven/html_generator.rb
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
## 1. What is Riven?
|
|
2
|
-
|
|
3
|
-
In one sentence: Riven is a command line tool, which converts a bunch of markdown files into a PDF file.
|
|
4
|
-
|
|
5
|
-
**The question is: Why would you do that?**
|
|
6
|
-
|
|
7
|
-
There are several scenarios where the usage off a tool like riven would make a lot of sense for you. Let's take a look
|
|
8
|
-
at some of them:
|
|
9
|
-
|
|
10
|
-
<<[ 1-scenario-a.md ]
|
|
11
|
-
<<[ 2-scenario-b.md ]
|
|
12
|
-
|
|
13
|
-
<<[ 3-what-is-riven-not.md ]
|
|
14
|
-
<<[ 4-why-was-riven-created.md ]
|
|
15
|
-
<<[ 5-how-can-i-support-riven.md ]
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
data/doc/cover.md
DELETED
|
@@ -1,39 +0,0 @@
|
|
|
1
|
-
<br />
|
|
2
|
-
<br />
|
|
3
|
-
<br />
|
|
4
|
-
<br />
|
|
5
|
-
<br />
|
|
6
|
-
<br />
|
|
7
|
-
|
|
8
|
-

|
|
9
|
-
|
|
10
|
-
<br />
|
|
11
|
-
<br />
|
|
12
|
-
<br />
|
|
13
|
-
<br />
|
|
14
|
-
<br />
|
|
15
|
-
<br />
|
|
16
|
-
<br />
|
|
17
|
-
<br />
|
|
18
|
-
|
|
19
|
-
# Official Riven Manual
|
|
20
|
-
## Write Markdown. Get a nice PDF. Have fun.
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
<br />
|
|
24
|
-
<br />
|
|
25
|
-
<br />
|
|
26
|
-
<br />
|
|
27
|
-
<br />
|
|
28
|
-
<br />
|
|
29
|
-
<br />
|
|
30
|
-
<br />
|
|
31
|
-
<br />
|
|
32
|
-
<br />
|
|
33
|
-
<br />
|
|
34
|
-
<br />
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
-----
|
|
38
|
-
|
|
39
|
-
powered by Benjamin Kammerl | visit *[github.com/phortx/riven](https://github.com/phortx/riven)* | MIT license
|
data/doc/img/cover.png
DELETED
|
Binary file
|
data/doc/index.md
DELETED
data/doc/riven.pdf
DELETED
|
Binary file
|