rdf-sak 0.1.5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.gitignore +16 -0
- data/.rspec +2 -0
- data/.travis.yml +4 -0
- data/Gemfile +4 -0
- data/LICENSE +202 -0
- data/README.md +268 -0
- data/Rakefile +13 -0
- data/bin/console +14 -0
- data/bin/setup +8 -0
- data/example/cleanup.xsl +14 -0
- data/example/matches.xhtml +11 -0
- data/example/transforms.ttl +58 -0
- data/lib/rdf-sak.rb +1 -0
- data/lib/rdf/sak.rb +2506 -0
- data/lib/rdf/sak/ci.rb +827 -0
- data/lib/rdf/sak/cli.rb +35 -0
- data/lib/rdf/sak/docstats.rb +188 -0
- data/lib/rdf/sak/document.rb +772 -0
- data/lib/rdf/sak/ibis.rb +248 -0
- data/lib/rdf/sak/mimemagic.rb +73 -0
- data/lib/rdf/sak/pav.rb +479 -0
- data/lib/rdf/sak/qb.rb +280 -0
- data/lib/rdf/sak/scovo.rb +51 -0
- data/lib/rdf/sak/tfo.rb +301 -0
- data/lib/rdf/sak/transform.rb +1172 -0
- data/lib/rdf/sak/urlrunner.rb +602 -0
- data/lib/rdf/sak/util.rb +2081 -0
- data/lib/rdf/sak/version.rb +5 -0
- data/rdf-sak.gemspec +60 -0
- metadata +366 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 22c5b1146b7e9f8a8faadf0879004710b851215b3cb2ec66e034a76176168eca
|
4
|
+
data.tar.gz: db752c349d0a7ef006f751237a3051a3a78f65346a503e671f737f5d34698ad7
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 7e1a4253e9c51f61a7c5a12ab6967423aaaef3d2ec903cc52e816cadc0732fbffe6e4ac31cb2ebecdde0d77314fb489015f73da8e3f62aaf02c725f85ea752ff
|
7
|
+
data.tar.gz: 2b8a17e57555be58d93d7774daad0c020140e609f93d9b6180b567d647e650d443c48e54f0622eee73fab9683e0d9158ed866a44322d27548fc15abb2e96571e
|
data/.gitignore
ADDED
data/.rspec
ADDED
data/.travis.yml
ADDED
data/Gemfile
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,202 @@
|
|
1
|
+
|
2
|
+
Apache License
|
3
|
+
Version 2.0, January 2004
|
4
|
+
http://www.apache.org/licenses/
|
5
|
+
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
7
|
+
|
8
|
+
1. Definitions.
|
9
|
+
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
12
|
+
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
14
|
+
the copyright owner that is granting the License.
|
15
|
+
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
17
|
+
other entities that control, are controlled by, or are under common
|
18
|
+
control with that entity. For the purposes of this definition,
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
20
|
+
direction or management of such entity, whether by contract or
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
23
|
+
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
25
|
+
exercising permissions granted by this License.
|
26
|
+
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
28
|
+
including but not limited to software source code, documentation
|
29
|
+
source, and configuration files.
|
30
|
+
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
32
|
+
transformation or translation of a Source form, including but
|
33
|
+
not limited to compiled object code, generated documentation,
|
34
|
+
and conversions to other media types.
|
35
|
+
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
37
|
+
Object form, made available under the License, as indicated by a
|
38
|
+
copyright notice that is included in or attached to the work
|
39
|
+
(an example is provided in the Appendix below).
|
40
|
+
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
47
|
+
the Work and Derivative Works thereof.
|
48
|
+
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
50
|
+
the original version of the Work and any modifications or additions
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
62
|
+
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
65
|
+
subsequently incorporated within the Work.
|
66
|
+
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
73
|
+
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
79
|
+
where such license applies only to those patent claims licensable
|
80
|
+
by such Contributor that are necessarily infringed by their
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
83
|
+
institute patent litigation against any entity (including a
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
86
|
+
or contributory patent infringement, then any patent licenses
|
87
|
+
granted to You under this License for that Work shall terminate
|
88
|
+
as of the date such litigation is filed.
|
89
|
+
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
92
|
+
modifications, and in Source or Object form, provided that You
|
93
|
+
meet the following conditions:
|
94
|
+
|
95
|
+
(a) You must give any other recipients of the Work or
|
96
|
+
Derivative Works a copy of this License; and
|
97
|
+
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
99
|
+
stating that You changed the files; and
|
100
|
+
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
103
|
+
attribution notices from the Source form of the Work,
|
104
|
+
excluding those notices that do not pertain to any part of
|
105
|
+
the Derivative Works; and
|
106
|
+
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
109
|
+
include a readable copy of the attribution notices contained
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
112
|
+
of the following places: within a NOTICE text file distributed
|
113
|
+
as part of the Derivative Works; within the Source form or
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
115
|
+
within a display generated by the Derivative Works, if and
|
116
|
+
wherever such third-party notices normally appear. The contents
|
117
|
+
of the NOTICE file are for informational purposes only and
|
118
|
+
do not modify the License. You may add Your own attribution
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
121
|
+
that such additional attribution notices cannot be construed
|
122
|
+
as modifying the License.
|
123
|
+
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
125
|
+
may provide additional or different license terms and conditions
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
129
|
+
the conditions stated in this License.
|
130
|
+
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
134
|
+
this License, without any additional terms or conditions.
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
136
|
+
the terms of any separate license agreement you may have executed
|
137
|
+
with Licensor regarding such Contributions.
|
138
|
+
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
141
|
+
except as required for reasonable and customary use in describing the
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
143
|
+
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
153
|
+
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
159
|
+
incidental, or consequential damages of any character arising as a
|
160
|
+
result of this License or out of the use or inability to use the
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
163
|
+
other commercial damages or losses), even if such Contributor
|
164
|
+
has been advised of the possibility of such damages.
|
165
|
+
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
169
|
+
or other liability obligations and/or rights consistent with this
|
170
|
+
License. However, in accepting such obligations, You may act only
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
175
|
+
of your accepting any such warranty or additional liability.
|
176
|
+
|
177
|
+
END OF TERMS AND CONDITIONS
|
178
|
+
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
180
|
+
|
181
|
+
To apply the Apache License to your work, attach the following
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
183
|
+
replaced with your own identifying information. (Don't include
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
185
|
+
comment syntax for the file format. We also recommend that a
|
186
|
+
file or class name and description of purpose be included on the
|
187
|
+
same "printed page" as the copyright notice for easier
|
188
|
+
identification within third-party archives.
|
189
|
+
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
191
|
+
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
193
|
+
you may not use this file except in compliance with the License.
|
194
|
+
You may obtain a copy of the License at
|
195
|
+
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
197
|
+
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
201
|
+
See the License for the specific language governing permissions and
|
202
|
+
limitations under the License.
|
data/README.md
ADDED
@@ -0,0 +1,268 @@
|
|
1
|
+
# RDF::SAK — Swiss Army Knife for Semantic Web Content
|
2
|
+
|
3
|
+
This library can be understood as something of a workbench for the
|
4
|
+
development of a set of patterns and protocols for Web content—a
|
5
|
+
[content management
|
6
|
+
_meta-system_](https://doriantaylor.com/content-management-meta-system).
|
7
|
+
The proximate goals of this implementation are as follows:
|
8
|
+
|
9
|
+
* Durable addresses with fine-grained addressability of content,
|
10
|
+
* Adherence to declarative content models mediated by open standards,
|
11
|
+
* Easy content re-use, i.e., _transclusion_,
|
12
|
+
* Rich embedded metadata for search, social media, and other purposes.
|
13
|
+
|
14
|
+
`RDF::SAK` is also intended to serve as a substrate for:
|
15
|
+
|
16
|
+
* The maturation of a [content inventory
|
17
|
+
ontology](https://privatealpha.com/ontology/content-inventory/1#),
|
18
|
+
* The use of semantic metadata [for manipulating content
|
19
|
+
presentation](https://github.com/doriantaylor/rdfa-xslt),
|
20
|
+
* Development of a deterministic, standards-compliant, [client-side
|
21
|
+
transclusion mechanism](https://github.com/doriantaylor/xslt-transclusion).
|
22
|
+
|
23
|
+
Finally, this library is also intended to establish a set of hard
|
24
|
+
requirements for the kind of RDF and Linked Data infrastructure that
|
25
|
+
would be necessary to replicate its behaviour in a more comprehensive
|
26
|
+
content management system.
|
27
|
+
|
28
|
+
The only public website currently generated by `RDF::SAK` is [my own
|
29
|
+
personal site](https://doriantaylor.com/), which I use as a test
|
30
|
+
corpus. However, this library draws together a number of techniques
|
31
|
+
which have been in use with employers and clients for well over a decade.
|
32
|
+
|
33
|
+
## Future Directions
|
34
|
+
|
35
|
+
Ultimately, this implementation is disposable. What matter are the
|
36
|
+
patterns laid down in the program output. If these patterns can be
|
37
|
+
sufficiently normalized, then the behaviour ought to at least be
|
38
|
+
replicable in other content management systems. Failing that, the
|
39
|
+
patterns will serve as a set of requirements for future systems. The
|
40
|
+
ideal is that adherence to existing open standards plus a modest set
|
41
|
+
of additional constraints could, at least from the perspective of the
|
42
|
+
audience, make the CMS infrastructure disappear.
|
43
|
+
|
44
|
+
As for the texture and topology of the content itself, squaring away
|
45
|
+
the mundane problems of stable addressing, transclusion, and the
|
46
|
+
product-agnostic separation of content from presentation, the emphasis
|
47
|
+
on the _page_ as the basic unit of content can be subjected to further
|
48
|
+
scrutiny. The long-term goal of this project is a structure with
|
49
|
+
smaller nodes and many more links between them, something I am calling
|
50
|
+
_dense hypermedia_.
|
51
|
+
|
52
|
+
## How it Works
|
53
|
+
|
54
|
+
Because the focus of `RDF::SAK` is a corpus of interrelated Web
|
55
|
+
resources marked up just so, rather than presenting as an on-line Web
|
56
|
+
application, it instead both consumes and emits a set of static
|
57
|
+
files. It currently expects a directory of (X)HTML and/or Markdown as
|
58
|
+
its document source, along with one or more serialized RDF graphs
|
59
|
+
which house the metadata.
|
60
|
+
|
61
|
+
### Inputs
|
62
|
+
|
63
|
+
The files in the source tree can be named in any way, however, in the
|
64
|
+
metadata, they are expected to be primarily associated with UUIDs,
|
65
|
+
like the following (complete) entry:
|
66
|
+
|
67
|
+
```turtle
|
68
|
+
@prefix owl: <http://www.w3.org/2002/07/owl#> .
|
69
|
+
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
|
70
|
+
@prefix xhv: <http://www.w3.org/1999/xhtml/vocab#> .
|
71
|
+
@prefix dct: <http://purl.org/dc/terms/> .
|
72
|
+
@prefix foaf: <http://xmlns.com/foaf/0.1/> .
|
73
|
+
@prefix bibo: <http://purl.org/ontology/bibo/> .
|
74
|
+
@prefix bs: <http://purl.org/ontology/bibo/status/> .
|
75
|
+
@prefix ci: <https://privatealpha.com/ontology/content-inventory/1#> .
|
76
|
+
|
77
|
+
<urn:uuid:b5c16511-6904-4130-b4e4-dd553f31bdd8>
|
78
|
+
dct:abstract "Yet another slapdash about-me page."@en ;
|
79
|
+
dct:created "2019-03-11T08:14:10+00:00"^^xsd:dateTime ;
|
80
|
+
dct:creator <urn:uuid:ca637d4b-c11b-4152-be98-bde602e7abd4> ;
|
81
|
+
dct:hasPart <https://www.youtube.com/embed/eV84dXJUvY8> ;
|
82
|
+
dct:modified "2019-05-17T05:08:42+00:00"^^xsd:dateTime,
|
83
|
+
"2019-05-17T18:37:37+00:00"^^xsd:dateTime ;
|
84
|
+
dct:references <urn:uuid:01a1ad7d-8af0-4ad7-a8ec-ffaaa06bb6f1>,
|
85
|
+
<urn:uuid:0d97c820-8929-42a1-8aca-f9e165d8085e>,
|
86
|
+
<urn:uuid:1ae2942f-4ba6-4552-818d-0e6b91a4abee>,
|
87
|
+
<urn:uuid:97bd312d-267d-433b-afc7-c0e9ab3311ed>,
|
88
|
+
<urn:uuid:99cc7d73-4779-4a7c-82de-b9f08af85cf8>,
|
89
|
+
<urn:uuid:a03bf9b5-56e6-42c7-bcd9-37ea6ad6a3d1>,
|
90
|
+
<urn:uuid:afe5a68a-a224-4be9-9fec-071ab55aa70d>,
|
91
|
+
<urn:uuid:d74d7e24-a6d6-4f49-94e8-e905d317c988>,
|
92
|
+
<urn:uuid:ef4587cd-d8c6-4b3d-aa01-d07ab49eda4f> ;
|
93
|
+
dct:replaces <urn:uuid:1944f86f-cafb-42f7-bca3-ad518f9b6ec7>,
|
94
|
+
<urn:uuid:d30a49d7-71ed-4355-bc44-4bbe3d90e000> ;
|
95
|
+
dct:title "Hello, Internet"@en ;
|
96
|
+
bibo:status bs:published ;
|
97
|
+
a bibo:Note ;
|
98
|
+
xhv:alternate <urn:uuid:4a13ab5a-67a5-4e1a-970f-3425df7035bb>,
|
99
|
+
<urn:uuid:c2f57107-9f79-4f13-a83c-4c73448c1c0b> ;
|
100
|
+
xhv:bookmark <urn:uuid:c2f57107-9f79-4f13-a83c-4c73448c1c0b> ;
|
101
|
+
xhv:index <urn:uuid:4a13ab5a-67a5-4e1a-970f-3425df7035bb> ;
|
102
|
+
xhv:meta <urn:uuid:47d52b80-50df-4ac4-a3f3-941c95c1aa14> ;
|
103
|
+
owl:sameAs <https://doriantaylor.com/breaking-my-silence-on-twitter>,
|
104
|
+
<https://doriantaylor.com/person/dorian-taylor>,
|
105
|
+
<https://doriantaylor.com/what-i-do>,
|
106
|
+
<https://doriantaylor.com/what-i-do-for-money> ;
|
107
|
+
foaf:depiction <https://doriantaylor.com/file/form-content-masked;desaturate;scale=800,700> ;
|
108
|
+
ci:canonical <https://doriantaylor.com/hello-internet> ;
|
109
|
+
ci:canonical-slug "hello-internet"^^xsd:token ;
|
110
|
+
ci:indexed false .
|
111
|
+
```
|
112
|
+
|
113
|
+
> Another program generates these entries from version-controlled
|
114
|
+
> source trees. It was written over a decade ago in Python, intended
|
115
|
+
> to handle the Mercurial version control system. Eventually it will
|
116
|
+
> be switched to Git, rewritten in Ruby, and made part of `RDF::SAK`.
|
117
|
+
|
118
|
+
### Outputs
|
119
|
+
|
120
|
+
The library has methods to generate the following kinds of file:
|
121
|
+
|
122
|
+
* (X)HTML documents, where file inputs are married with metadata
|
123
|
+
* Special indexes, generated completely from metadata
|
124
|
+
* Atom feeds, with various partitioning criteria
|
125
|
+
* Google site maps,
|
126
|
+
* Apache rewrite maps.
|
127
|
+
|
128
|
+
All files are generated in the target directory as their canonical
|
129
|
+
UUID and a representative extension,
|
130
|
+
e.g. `b5c16511-6904-4130-b4e4-dd553f31bdd8.xml`. Human-readable URIs
|
131
|
+
are then overlaid onto these canonical addresses using rewrite
|
132
|
+
maps. This enables the system to retain a memory of address-to-UUID
|
133
|
+
assignments over time, with the eventual goal to eliminate 404 errors.
|
134
|
+
|
135
|
+
Documents themselves are traversed and embedded with metadata.
|
136
|
+
Wherever possible, links are given titles and semantic relations, and
|
137
|
+
a list of backlinks from all other resources is constructed. There are
|
138
|
+
modules for generating various elements in the `<head>` to accommodate
|
139
|
+
the various search and social media platforms. The strategy is to hold
|
140
|
+
the master data in the most appropriate RDF vocabularies, and then
|
141
|
+
subsequently map those properties to their proprietary counterparts,
|
142
|
+
e.g., Facebook OGP, Schema.org (Google), and Twitter Cards.
|
143
|
+
|
144
|
+
> The latter representations tend to cut corners with various
|
145
|
+
> datatypes and properties; it's much easier to go from strict RDF to
|
146
|
+
> a platform-specific schema than it is to go the other way around.
|
147
|
+
|
148
|
+
#### Private content
|
149
|
+
|
150
|
+
While a fine-grained access control subsystem is decidedly out of
|
151
|
+
scope, `RDF::SAK` has a rudimentary concept of _private_ resources. A
|
152
|
+
resource is assumed to be "private" unless its `bibo:status` is set to
|
153
|
+
`bibo:status/published`. A document may therefore have both a public
|
154
|
+
and private version, as the private version may have links to and from
|
155
|
+
other documents which themselves are not published. Links to private
|
156
|
+
documents get pruned from published ones, so as not to leak their
|
157
|
+
existence.
|
158
|
+
|
159
|
+
### Running
|
160
|
+
|
161
|
+
I endeavour to create a command-line interface but the _library_
|
162
|
+
interface is currently not stable enough to warrant it. The best way
|
163
|
+
to use `RDF::SAK` for now is within an interactive `pry` session:
|
164
|
+
|
165
|
+
```bash
|
166
|
+
~$ cd rdf-sak
|
167
|
+
~/rdf-sak$ pry -Ilib
|
168
|
+
[1] pry(main)> require 'rdf/sak'
|
169
|
+
=> true
|
170
|
+
[2] pry(main)> ctx = RDF::SAK::Context.new config: '~/my.conf'
|
171
|
+
=> <RDF::SAK::Context ...>
|
172
|
+
[3] pry(main)> doc = ctx.visit 'some-uri'
|
173
|
+
=> <RDF::SAK::Context::Document ...>
|
174
|
+
[4] pry(main)> doc.write_to_target
|
175
|
+
```
|
176
|
+
|
177
|
+
A YAML configuration file can be supplied in lieu of individual
|
178
|
+
parameters to the constructor:
|
179
|
+
|
180
|
+
```yaml
|
181
|
+
base: https://doriantaylor.com/
|
182
|
+
graph: # RDF graphs
|
183
|
+
- ~/projects/active/doriantaylor.com/content-inventory.ttl
|
184
|
+
- ~/projects/active/doriantaylor.com/concept-scheme.ttl
|
185
|
+
source: ~/projects/active/doriantaylor.com/source
|
186
|
+
target: ~/projects/active/doriantaylor.com/target
|
187
|
+
private: .private # private content, relative to target
|
188
|
+
transform: /transform # XSLT stylesheet attached to all documents
|
189
|
+
```
|
190
|
+
|
191
|
+
### Deployment
|
192
|
+
|
193
|
+
Deploying the content can be done with `rsync`, although it requires
|
194
|
+
certain configuration changes on the server in order to work properly.
|
195
|
+
|
196
|
+
In Apache in particular, rewrite maps need to be defined in the main
|
197
|
+
server configuration:
|
198
|
+
|
199
|
+
```apache
|
200
|
+
# one need not place these in the document root but it's handy for rsync
|
201
|
+
RewriteEngine On
|
202
|
+
RewriteMap rewrite ${DOCUMENT_ROOT}/.rewrite.map
|
203
|
+
RewriteMap redirect ${DOCUMENT_ROOT}/.redirect.map
|
204
|
+
RewriteMap gone ${DOCUMENT_ROOT}/.gone.map
|
205
|
+
|
206
|
+
# then we just add something like this to prevent access to them
|
207
|
+
<Files ".*.map">
|
208
|
+
Require all denied
|
209
|
+
</Files>
|
210
|
+
```
|
211
|
+
|
212
|
+
The rest of the configuration can go in an `.htaccess`:
|
213
|
+
|
214
|
+
```apache
|
215
|
+
# this redirects to canonical slugs
|
216
|
+
RewriteCond "%{ENV:REDIRECT_SCRIPT_URL}" ^$
|
217
|
+
RewriteCond %{REQUEST_URI} "^/*(.*?)(\.xml)?$"
|
218
|
+
RewriteCond ${redirect:%1} ^.+$
|
219
|
+
RewriteRule ^/*(.*?)(\.xml)?$ ${redirect:$1} [L,NS,R=308]
|
220
|
+
|
221
|
+
# this takes care of terminated URIs
|
222
|
+
RewriteCond %{REQUEST_URI} ^/*(.*?)(\..+?)?$
|
223
|
+
RewriteCond ${gone:%1} ^.+$
|
224
|
+
RewriteRule .* - [L,NS,G]
|
225
|
+
|
226
|
+
# this internally rewrites slugs to UUIDs
|
227
|
+
RewriteCond "%{ENV:REDIRECT_SCRIPT_URL}" ^$
|
228
|
+
RewriteCond %{REQUEST_URI} ^/*(.*?)(\..+?)?$
|
229
|
+
RewriteCond ${rewrite:%1} ^.+$
|
230
|
+
RewriteRule ^/*(.*?)(\..+?)?$ /${rewrite:$1} [NS,PT]
|
231
|
+
|
232
|
+
# we can do something perhaps more elaborate to route private content
|
233
|
+
SetEnvIf Remote_Addr "31\.3\.3\.7" PRIVATE
|
234
|
+
|
235
|
+
# this splices in the private content if it is present
|
236
|
+
RewriteCond %{ENV:PRIVATE} !^$
|
237
|
+
RewriteCond %{DOCUMENT_ROOT}/.private%{REQUEST_URI} -F
|
238
|
+
RewriteRule ^/*(.*) /.private/$1 [NS,PT]
|
239
|
+
```
|
240
|
+
|
241
|
+
Configurations for other platforms can be figured out on request.
|
242
|
+
|
243
|
+
## Documentation
|
244
|
+
|
245
|
+
API documentation, for what it's worth at the moment, can be found [in
|
246
|
+
the usual place](https://rubydoc.info/github/doriantaylor/rb-rdf-sak/master).
|
247
|
+
|
248
|
+
## Installation
|
249
|
+
|
250
|
+
For now I recommend just running the library out of its source tree:
|
251
|
+
|
252
|
+
```bash
|
253
|
+
~$ git clone git@github.com/doriantaylor/rb-rdf-sak.git
|
254
|
+
~$ cd rb-rdf-sak
|
255
|
+
~/rb-rdf-sak$ bundle install
|
256
|
+
```
|
257
|
+
|
258
|
+
## Contributing
|
259
|
+
|
260
|
+
Bug reports and pull requests are welcome at
|
261
|
+
[the GitHub repository](https://github.com/doriantaylor/rb-rdf-sak).
|
262
|
+
|
263
|
+
## Copyright & License
|
264
|
+
|
265
|
+
©2018 [Dorian Taylor](https://doriantaylor.com/)
|
266
|
+
|
267
|
+
This software is provided under
|
268
|
+
the [Apache License, 2.0](https://www.apache.org/licenses/LICENSE-2.0).
|