fyodor 0.2.6 → 0.2.10
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +23 -4
- data/lib/fyodor/config_getter.rb +2 -2
- data/lib/fyodor/version.rb +1 -1
- metadata +22 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 02a743dcc50a2c528b31aa2d4208cb4f220cb7ee5ee7a1ab19d36ee701c38de5
|
4
|
+
data.tar.gz: 005baf6cf829812dc8f9ab1d9f5d2761ff3a610e607e11abed66e507f6eee649
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: d6b6b7784323ac398eb36a4321d23a558c632246d2a5199dec38a28bd22a60fc77b93b76a31f95586ce27aac34538c74da6332fc96b84d61ad1b8f104eba56de
|
7
|
+
data.tar.gz: 0b6f4ab38b109fc7d64914d8b90ba45d32185b625c66f0099abb95299c38c639d788ff552c6b412c11f6ddf656d7a6cd6e9bb1109d5a6a22b25b7a6ad9021bc5
|
data/README.md
CHANGED
@@ -8,7 +8,7 @@ This application parses `My Clippings.txt` from your Kindle and generates a mark
|
|
8
8
|
|
9
9
|
[For samples of the output, click here.](docs/output_demo)
|
10
10
|
|
11
|
-
To read more about the motivation and what problem it tries to solve, [check this blog post](
|
11
|
+
To read more about the motivation and what problem it tries to solve, [check this blog post](https://rafaelc.org/posts/export-all-your-kindle-highlights-and-notes/).
|
12
12
|
|
13
13
|
## Features
|
14
14
|
|
@@ -22,6 +22,13 @@ To read more about the motivation and what problem it tries to solve, [check thi
|
|
22
22
|
|
23
23
|
This program is based on the clippings file generated by Kindle 2019, but should work with other models.
|
24
24
|
|
25
|
+
## Limitations
|
26
|
+
|
27
|
+
We are limited by the data Kindle makes available through `My Clippings.txt`. This means:
|
28
|
+
|
29
|
+
- We don't have chapter information.
|
30
|
+
- We can’t guess all entries that were deleted.
|
31
|
+
|
25
32
|
## Installation
|
26
33
|
|
27
34
|
Install Ruby and run:
|
@@ -46,10 +53,10 @@ Fyodor has an optional configuration file, which is used for the following.
|
|
46
53
|
|
47
54
|
If your Kindle is not in English, you should tell Fyodor how some things are called by your `My Clippings.txt` (e.g. highlights, pages, etc). _Fyodor should still work without configuration, but you won't take advantage of many features, resulting in a dirtier output._
|
48
55
|
|
49
|
-
1. Download the sample config to `~/.config/fyodor.toml` or `$XDG_CONFIG_HOME/fyodor.toml`:
|
56
|
+
1. Download the sample config to `~/.config/fyodor/fyodor.toml` or `$XDG_CONFIG_HOME/fyodor/fyodor.toml`:
|
50
57
|
|
51
|
-
```
|
52
|
-
$
|
58
|
+
```sh
|
59
|
+
$ curl https://raw.githubusercontent.com/rc2dev/fyodor/master/docs/fyodor.toml.sample --create-dirs -o ~/.config/fyodor/fyodor.toml
|
53
60
|
```
|
54
61
|
|
55
62
|
2. Open both the configuration and your `My Clippings.txt` in your preferred editor. Change the values in the `[parser]` section to mirror what you get in `My Clippings.txt`.
|
@@ -82,6 +89,18 @@ Where:
|
|
82
89
|
- `CLIPPINGS_FILE` is the path for `My Clippings.txt`.
|
83
90
|
- `OUTPUT_DIR` is the directory to write the markdown files. If none is supplied, this will be `fyodor_output` under the current directory.
|
84
91
|
|
92
|
+
## PSA: HTML to markdown
|
93
|
+
|
94
|
+
Did you export your annotations to HTML using the Kindle mobile app?
|
95
|
+
|
96
|
+
You can convert it to markdown with [a script I wrote specifically for it](https://rafaelc.org/k/kindle2md).
|
97
|
+
|
98
|
+
## Buy me a coffee
|
99
|
+
|
100
|
+
If you like Fyodor, you can show your support here:
|
101
|
+
|
102
|
+
<a href="https://rafaelc.org/coffee" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" width="200" ></a>
|
103
|
+
|
85
104
|
## License
|
86
105
|
|
87
106
|
Licensed under [GPLv3](LICENSE)
|
data/lib/fyodor/config_getter.rb
CHANGED
@@ -42,8 +42,8 @@ module Fyodor
|
|
42
42
|
return @paths unless @paths.nil?
|
43
43
|
|
44
44
|
@paths = []
|
45
|
-
@paths << Pathname.new(ENV["XDG_CONFIG_HOME"]) + "fyodor.toml" unless ENV["XDG_CONFIG_HOME"].nil?
|
46
|
-
@paths << Pathname.new("~/.config/fyodor.toml").expand_path
|
45
|
+
@paths << Pathname.new(ENV["XDG_CONFIG_HOME"]) + "fyodor/fyodor.toml" unless ENV["XDG_CONFIG_HOME"].nil?
|
46
|
+
@paths << Pathname.new("~/.config/fyodor/fyodor.toml").expand_path
|
47
47
|
end
|
48
48
|
|
49
49
|
def print_path
|
data/lib/fyodor/version.rb
CHANGED
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: fyodor
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.2.
|
4
|
+
version: 0.2.10
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Rafael Cavalcanti
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2021-11-23 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: toml
|
@@ -24,8 +24,22 @@ dependencies:
|
|
24
24
|
- - "~>"
|
25
25
|
- !ruby/object:Gem::Version
|
26
26
|
version: '0.1'
|
27
|
+
- !ruby/object:Gem::Dependency
|
28
|
+
name: optimist
|
29
|
+
requirement: !ruby/object:Gem::Requirement
|
30
|
+
requirements:
|
31
|
+
- - "~>"
|
32
|
+
- !ruby/object:Gem::Version
|
33
|
+
version: '3.0'
|
34
|
+
type: :runtime
|
35
|
+
prerelease: false
|
36
|
+
version_requirements: !ruby/object:Gem::Requirement
|
37
|
+
requirements:
|
38
|
+
- - "~>"
|
39
|
+
- !ruby/object:Gem::Version
|
40
|
+
version: '3.0'
|
27
41
|
description: Parse Kindle clippings into markdown files
|
28
|
-
email:
|
42
|
+
email: dev@rafaelc.org
|
29
43
|
executables:
|
30
44
|
- fyodor
|
31
45
|
extensions: []
|
@@ -47,11 +61,11 @@ files:
|
|
47
61
|
- lib/fyodor/stats_printer.rb
|
48
62
|
- lib/fyodor/strings.rb
|
49
63
|
- lib/fyodor/version.rb
|
50
|
-
homepage: https://
|
64
|
+
homepage: https://rafaelc.org/fyodor
|
51
65
|
licenses:
|
52
66
|
- GPL-3.0-only
|
53
67
|
metadata:
|
54
|
-
source_code_uri: https://
|
68
|
+
source_code_uri: https://rafaelc.org/fyodor
|
55
69
|
post_install_message:
|
56
70
|
rdoc_options: []
|
57
71
|
require_paths:
|
@@ -61,6 +75,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
61
75
|
- - ">="
|
62
76
|
- !ruby/object:Gem::Version
|
63
77
|
version: '2.5'
|
78
|
+
- - "<"
|
79
|
+
- !ruby/object:Gem::Version
|
80
|
+
version: '3'
|
64
81
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
65
82
|
requirements:
|
66
83
|
- - ">="
|