ddclassify/ddclassify.1 at master · phua/ddclassify · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
./" $ man ./ddclassify.1
./" $ groff -Tascii -man ./ddclassify.1
./" $ groff -Tps -man ./ddclassify.1
./"

.TH DDCLASSIFY 1 2019-08-01 1.0 "ddclassify Manual"

.SH NAME

ddclassify \- Dewey Decimal Classifier

.SH SYNOPSIS

.B ddclassify
.I [-h|--help]

.B ddclassify
.I [-t title [-a author]]
.I [-i isbn]

.B ddclassify
.I [-d path [-p pattern] [-r] [-e directories] [-c /path/to/library [-m 1|2|4|8|17|18|20|24]] [-misfile]]

.B ddclassify
.I [-x /path/to/ddc.xml]
.I [-depth 1..3]
.I [-g]
.I [-v]

.SH DESCRIPTION

Classify library using the Dewey Decimal Classification.

.SH EXAMPLES

Search by title and author.

.B ddclassify -t \*(lqAlice's Adventures in Wonderland\*(rq -a \*(lqLewis Carroll\*(rq

Search by title and author using the Google Books API to lookup the ISBN.

.B ddclassify -t \*(lqAlice's Adventures in Wonderland\*(rq -a \*(lqLewis Carroll\*(rq -g

Search by ISBN.

.B ddclassify -i 9780060081393

Search filename (Title - Author.ext).

.B ddclassify -d \*(lq/path/to/Alice's Adventures in Wonderland - Lewis Carroll.epub\*(rq

Search filename (Title - Author.ext) and move to library.

.B ddclassify -d \*(lq/path/to/Alice's Adventures in Wonderland - Lewis Carroll.epub\*(rq -c /path/to/library -m 8

Specify regular expression pattern for parsing title and author from filenames.

.B ddclassify -d \&... -p \*(lq^(?P<title>.+?)(?:(_|,).*)? - (?P<author>.+)\.([A-Za-z]+)$\*(rq

Search directory recursively and exclude search directories.

.B ddclassify -d /path/to/library -r -e music,movies

Create empty DDC directory structure
.I /tmp/eBooks
without transferring files.

.B ddclassify -d /path/to/library -r -c /tmp/eBooks

Create DDC directory structure
.I /tmp/eBooks
and transfer files.

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 1
.I # copy

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 2
.I # link

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 4
.I # symlink

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 8
.I # move

Create DDC directory structure
.I /tmp/eBooks
transfer and rename files.

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 17
.I # 1 + 16, copy and rename

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 18
.I # 2 + 16, link and rename

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 20
.I # 4 + 16, symlink and rename

.B ddclassify -d /path/to/library -r -c /tmp/eBooks -m 24
.I # 8 + 16, move and rename

Find misfiled entries in search directory.

.B ddclassify -d /path/to/library -r -misfile

Specify DDC structure XML file mapping Dewey Decimal numbers to descriptions.

.B ddclassify \&... -x /path/to/ddc.xml

Specify classification
.B depth
.I [1..3]
indicating class, division, or section.

.B ddclassify \&... -depth 1

.SH FILES

.I ddc.xml

.SH BUGS

No known bugs.

.SH SEE ALSO
.UR
https://en.wikipedia.org/wiki/List_of_Dewey_Decimal_classes
.UE

.UR
https://www.oclc.org/developer/develop/web-services/classify/classification.en.html
.UE

.UR
https://developers.google.com/books/docs/v1/using
.UE