jekyll-scholar 5.14.0 → 5.14.1
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/README.md +21 -13
- data/features/bibtex.feature +47 -0
- data/lib/jekyll/scholar/defaults.rb +2 -0
- data/lib/jekyll/scholar/utilities.rb +3 -3
- data/lib/jekyll/scholar/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: dc3a085adf1accd384777754f269e3d5d367d7bd460c561a381aa5b058cae5d8
|
4
|
+
data.tar.gz: a24a018883dd8eb5d468cfe79d778aa284a21f9c8edcf2fa0eafdeb6c3df2ba3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 9caadbd232a0fccbf5b43e28c8de9d078978ee8a19aea22c774fffce183a3d0b128abae12a68907fbc02b9989186eb98283f050ba2e9ee5d59300f3f98eaa3c0
|
7
|
+
data.tar.gz: 98692f7f538e0dc2082ffdea20f3070538b5182beee571324b558cfd3ee10df31ad28856515682d093859674b7a33bb0e7f38200a2208bb63652085948dfcdf4
|
data/README.md
CHANGED
@@ -8,7 +8,6 @@ and gives your blog posts citation super-powers.
|
|
8
8
|
|
9
9
|
[](https://travis-ci.org/inukshuk/jekyll-scholar)
|
10
10
|
[](https://coveralls.io/r/inukshuk/jekyll-scholar)
|
11
|
-
[](https://gemnasium.com/inukshuk/jekyll-scholar)
|
12
11
|
|
13
12
|
Already using Jekyll-Scholar and interested to help out? Please get in touch with us if you would like to become a maintainer!
|
14
13
|
|
@@ -24,10 +23,10 @@ Or add it to your `Gemfile`:
|
|
24
23
|
### Github Pages
|
25
24
|
|
26
25
|
Note that it is not possible to use this plugin with the
|
27
|
-
[default Github pages workflow](https://help.github.com/articles/using-jekyll-with-pages/).
|
26
|
+
[default Github pages workflow](https://help.github.com/articles/using-jekyll-with-pages/).
|
28
27
|
Github does not allow any but a few select plugins to run for security reasons,
|
29
28
|
and Jekyll-Scholar is not among them.
|
30
|
-
You will have to generate your site locally and push the results to the `master` resp. `gh-pages`
|
29
|
+
You will have to generate your site locally and push the results to the `master` resp. `gh-pages`
|
31
30
|
branch of your site repository.
|
32
31
|
You can keep sources, configuration and plugins in a separate branch; see e.g.
|
33
32
|
[here](http://davidensinger.com/2013/07/automating-jekyll-deployment-to-github-pages-with-rake/)
|
@@ -65,7 +64,7 @@ description of all options and their defaults, see
|
|
65
64
|
|
66
65
|
| Option | Default | Description |
|
67
66
|
|--------|---------|-------------|
|
68
|
-
| `style` | `apa` | Indicates the style used for the bibliography and citations. You can use any style that ships with [CiteProc-Ruby](https://github.com/inukshuk/citeproc-ruby) by name (e.g., apa, mla, chicago-fullnote-bibliography) which is usually the filename as seen [here](https://github.com/citation-style-language/styles) without the `.csl` ending; note that you have to use `dependent/style` if you want to use one from that directory. Alternatively you can add a link to any CSL style (e.g., you could link to any of the styles available at the official [CSL style repository](https://github.com/citation-style-language/styles)). |
|
67
|
+
| `style` | `apa` | Indicates the style used for the bibliography and citations. You can use any style that ships with [CiteProc-Ruby](https://github.com/inukshuk/citeproc-ruby) by name (e.g., apa, mla, chicago-fullnote-bibliography) which is usually the filename as seen [here](https://github.com/citation-style-language/styles) without the `.csl` ending; note that you have to use `dependent/style` if you want to use one from that directory. Alternatively you can add a link to any CSL style (e.g., you could link to any of the styles available at the official [CSL style repository](https://github.com/citation-style-language/styles)). |
|
69
68
|
| `locale` | `en` | Defines what language to use when formatting your references (this typically applies to localized terms, e.g., 'Eds.' for editors in English). |
|
70
69
|
| `source` | `./_bibliography` | Indicates where your bibliographies are stored. |
|
71
70
|
| `bibliography` | `references.bib` | Indicates the name of your default bibliography. For best results, please ensure that your bibliography is encoded as ASCII or UTF-8. A string that contains a `*` will be passed to `Dir::glob`, so `**/*.bib{,tex}` will find all files named `*.bib` and `*.bibtex` under `source`. |
|
@@ -169,9 +168,9 @@ applied). Limiting entries is disabled if grouping is active.
|
|
169
168
|
|
170
169
|
### Return number of publications in bibliography
|
171
170
|
|
172
|
-
The `bibliography_count` returns the number of items that would be
|
173
|
-
rendered in a bibliography. This tag accepts the same parameters as the
|
174
|
-
`bibliography` tag.
|
171
|
+
The `bibliography_count` returns the number of items that would be
|
172
|
+
rendered in a bibliography. This tag accepts the same parameters as the
|
173
|
+
`bibliography` tag.
|
175
174
|
|
176
175
|
{% bibliography_count -f references --query @book[year <=2000] %}
|
177
176
|
|
@@ -302,16 +301,16 @@ of the items you wish to quote separated by spaces. For example,
|
|
302
301
|
|
303
302
|
#### Citations when there's more than one bibliography
|
304
303
|
|
305
|
-
Let's return to the example above where you have two bibliographies stored
|
304
|
+
Let's return to the example above where you have two bibliographies stored
|
306
305
|
in `_bibliography/books.bib` and `_bibliography/papers.bib`. We also must
|
307
306
|
have the main bibliography, e.g., `_bibliography/references.bib`. As we
|
308
307
|
know from above, it's possible to use bibliographies other than the main
|
309
|
-
bibliography by calling `{% bibliography --file books %}` or
|
310
|
-
`{% bibliography --file papers %}`.
|
308
|
+
bibliography by calling `{% bibliography --file books %}` or
|
309
|
+
`{% bibliography --file papers %}`.
|
311
310
|
|
312
|
-
Though what if we want to cite an article that's not in the main bibliography?
|
313
|
-
We use the same approach as above; to cite an article in the `books.bib`
|
314
|
-
bibliography, we simply call `{% cite ruby --file books %}`
|
311
|
+
Though what if we want to cite an article that's not in the main bibliography?
|
312
|
+
We use the same approach as above; to cite an article in the `books.bib`
|
313
|
+
bibliography, we simply call `{% cite ruby --file books %}`
|
315
314
|
|
316
315
|
#### Suppressing author names
|
317
316
|
|
@@ -423,6 +422,15 @@ assigned unique identifiers linking to the respective references
|
|
423
422
|
section, although both posts will be rendered into a single HTML
|
424
423
|
document.
|
425
424
|
|
425
|
+
#### Add a custom class for the citation reference
|
426
|
+
By default Jekyll Scholar generate a link with a class:
|
427
|
+
|
428
|
+
<a href="#ruby" class="citation">(Derrida, 1975)</a>
|
429
|
+
|
430
|
+
You can custom this class in your configuration:
|
431
|
+
|
432
|
+
scholar:
|
433
|
+
cite_class: citation
|
426
434
|
|
427
435
|
### File Repositories
|
428
436
|
|
data/features/bibtex.feature
CHANGED
@@ -364,6 +364,53 @@ Feature: BibTeX
|
|
364
364
|
And I should not see "<i>The Ruby Programming Language</i>" in "_site/scholar.html"
|
365
365
|
And I should see "<i>Smalltalk Best Practice Patterns</i>" in "_site/scholar.html"
|
366
366
|
|
367
|
+
@filter @regex
|
368
|
+
Scenario: Filter using interpolated query variable
|
369
|
+
Given I have a scholar configuration with:
|
370
|
+
| key | value |
|
371
|
+
| source | ./_bibliography |
|
372
|
+
And I have a "_bibliography" directory
|
373
|
+
And I have a file "_bibliography/references.bib":
|
374
|
+
"""
|
375
|
+
@article{testa,
|
376
|
+
title={test1},
|
377
|
+
author={Albert, Alex A and Booth, Brian and Cook, Cathy},
|
378
|
+
journal={Irrelevant},
|
379
|
+
year={2018}
|
380
|
+
}
|
381
|
+
@article{testb,
|
382
|
+
title={test2},
|
383
|
+
author={Booth, Brian and Albert, Alex and Cook, Cathy},
|
384
|
+
journal={Irrelevant},
|
385
|
+
year={2018}
|
386
|
+
}
|
387
|
+
@article{testc,
|
388
|
+
title={test3},
|
389
|
+
author={Cook, Cathy and Booth, Brian and Albert, Alex},
|
390
|
+
journal={Irrelevant},
|
391
|
+
year={2018}
|
392
|
+
}
|
393
|
+
@article{testd,
|
394
|
+
title={test4},
|
395
|
+
author={Done, Daniel},
|
396
|
+
journal={Irrelevant},
|
397
|
+
year={2018}
|
398
|
+
}
|
399
|
+
"""
|
400
|
+
And I have a page "scholar.html":
|
401
|
+
"""
|
402
|
+
---
|
403
|
+
---
|
404
|
+
{% bibliography --query @*[author ~= \bAlbert\b] %}
|
405
|
+
"""
|
406
|
+
When I run jekyll
|
407
|
+
Then the _site directory should exist
|
408
|
+
And the "_site/scholar.html" file should exist
|
409
|
+
And I should see "test1" in "_site/scholar.html"
|
410
|
+
And I should see "test2" in "_site/scholar.html"
|
411
|
+
And I should see "test3" in "_site/scholar.html"
|
412
|
+
And I should not see "test4" in "_site/scholar.html"
|
413
|
+
|
367
414
|
@tags @bibliography @prefix
|
368
415
|
Scenario: A Prefixed Bibliography
|
369
416
|
Given I have a scholar configuration with:
|
@@ -147,7 +147,7 @@ module Jekyll
|
|
147
147
|
def bibtex_paths
|
148
148
|
@bibtex_paths ||= bibtex_files.map { |file|
|
149
149
|
interpolated_file = interpolate file
|
150
|
-
extend_path interpolated_file
|
150
|
+
extend_path interpolated_file
|
151
151
|
}
|
152
152
|
end
|
153
153
|
|
@@ -488,7 +488,7 @@ module Jekyll
|
|
488
488
|
:filters => [Jekyll::Filters]
|
489
489
|
}
|
490
490
|
)
|
491
|
-
# process the generated reference with Liquid, to get the same behaviour as
|
491
|
+
# process the generated reference with Liquid, to get the same behaviour as
|
492
492
|
# when it is used on a page
|
493
493
|
Liquid::Template.parse(tmp).render(
|
494
494
|
site.site_payload,
|
@@ -656,7 +656,7 @@ module Jekyll
|
|
656
656
|
end
|
657
657
|
end
|
658
658
|
|
659
|
-
link_to link_target_for(keys[0]), render_citation(items)
|
659
|
+
link_to link_target_for(keys[0]), render_citation(items), {class: config['cite_class']}
|
660
660
|
end
|
661
661
|
|
662
662
|
def cite_details(key, text)
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: jekyll-scholar
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 5.14.
|
4
|
+
version: 5.14.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Sylvester Keil
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2019-03-25 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: jekyll
|