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
Hide 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
...
@@ -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
will attempt to read the key
`ruby`
from file
`/home/foo/bar.bib`
. It will not
fallback to the default BibTeX file.
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,
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
publications that have the same
`id`
attributes. As a result, when you
cite a reference the link to an
`id`
attribute cannot be resolved
cite a reference the link to an
`id`
attribute cannot be resolved
uniquely. Your browser will always take you take you to the first
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
attributes. This scenario may happen, for example, if you cite the
same reference in different blog posts, and all of these posts are
same reference in different blog posts, and all of these posts are
shown in one html document.
shown in one html document.
...
@@ -276,9 +276,9 @@ For the second blog post you would cite as follows:
...
@@ -276,9 +276,9 @@ For the second blog post you would cite as follows:
{% bibliography --cited --prefix post2 %}
{% bibliography --cited --prefix post2 %}
Even though both posts cite rabinowitz, both citations will be
Even though both posts cite
'
rabinowitz
'
, both citations will be
assigned unique identifiers linking to the respective
R
eferences
assigned unique identifiers linking to the respective
r
eferences
section
.
,
even if
both posts will be rendered into a single HTML
section,
although
both posts will be rendered into a single HTML
document.
document.
...
@@ -340,8 +340,9 @@ configuration option. For example:
...
@@ -340,8 +340,9 @@ configuration option. For example:
query: "@*[url]" #=> includes all entries with a url field
query: "@*[url]" #=> includes all entries with a url field
query: "@*[status!=review]" #=> includes all entries whose status field is not set to 'review'
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[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
later versions. You can also overwrite the configuration's query parameter
in each bibliography tag individually as described above.
in each bibliography tag individually as described above.
...
@@ -360,9 +361,10 @@ just add the line
...
@@ -360,9 +361,10 @@ just add the line
$:.unshift '/full/path/to/the/repository/lib'
$:.unshift '/full/path/to/the/repository/lib'
to your
`_plugins/ext.rb`
before requiring 'jekyll/scholar', where
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:
all dependencies and run the cucumber features:
$ bundle install
$ 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