Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Sign in
Toggle navigation
Open sidebar
caesr-pub
jekyll-scholar
Commits
e7108207
Commit
e7108207
authored
Apr 06, 2013
by
Sylvester Keil
Browse files
update readme
parent
648f5e98
Changes
1
Show whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
11 additions
and
9 deletions
+11
-9
README.md
README.md
+11
-9
No files found.
README.md
View file @
e7108207
...
...
@@ -227,14 +227,14 @@ a specific page. As an example, the tag
will attempt to read the key
`ruby`
from file
`/home/foo/bar.bib`
. It will not
fallback to the default BibTeX file.
####
Citations to m
ultiple bibliographies within one document (like [multibib.sty](http://www.ctan.org/pkg/multibib))
####
M
ultiple bibliographies within one document (like [multibib.sty](http://www.ctan.org/pkg/multibib))
When you have multiple
`{% bibliography %}`
sections in one file,
Jekyll-Scholar will generate se
r
veral lists containing the same
Jekyll-Scholar will generate several lists containing the same
publications that have the same
`id`
attributes. As a result, when you
cite a reference the link to an
`id`
attribute cannot be resolved
uniquely. Your browser will always take you take you to the first
occurence of the
`id`
. Moreover, valid HTML requires unique
`id`
occur
r
ence of the
`id`
. Moreover, valid HTML requires unique
`id`
attributes. This scenario may happen, for example, if you cite the
same reference in different blog posts, and all of these posts are
shown in one html document.
...
...
@@ -276,9 +276,9 @@ For the second blog post you would cite as follows:
{% bibliography --cited --prefix post2 %}
Even though both posts cite rabinowitz, both citations will be
assigned unique identifiers linking to the respective
R
eferences
section
.
,
even if
both posts will be rendered into a single HTML
Even though both posts cite
'
rabinowitz
'
, both citations will be
assigned unique identifiers linking to the respective
r
eferences
section,
although
both posts will be rendered into a single HTML
document.
...
...
@@ -340,8 +340,9 @@ configuration option. For example:
query: "@*[url]" #=> includes all entries with a url field
query: "@*[status!=review]" #=> includes all entries whose status field is not set to 'review'
query: "@book[year <= 1900 && author ^= Poe]" #=> Books published before 1900 where the author matches /Poe/
query: "!@book" #=> includes all entries with a type other than book
Please note that some of these queries require
b
ib
tex-r
uby 2.
0.7
or
Please note that some of these queries require
B
ib
TeX-R
uby 2.
3.0
or
later versions. You can also overwrite the configuration's query parameter
in each bibliography tag individually as described above.
...
...
@@ -360,9 +361,10 @@ just add the line
$:.unshift '/full/path/to/the/repository/lib'
to your
`_plugins/ext.rb`
before requiring 'jekyll/scholar', where
`/full/path/to/the/repository`
is where you have cloned jekyll-scholar into.
`/full/path/to/the/repository`
is the path to your local version
of Jekyll-Scholar.
When contributing to
j
ekyll-
s
cholar, please make sure to install
When contributing to
J
ekyll-
S
cholar, please make sure to install
all dependencies and run the cucumber features:
$ bundle install
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment