diff options
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/latex/citation-style-language/CHANGELOG.md | 22 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/citation-style-language/DEPENDS.txt | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/citation-style-language/README.md | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.pdf | bin | 219427 -> 220489 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.tex | 48 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/citeproc-lua.1 (renamed from Master/texmf-dist/doc/man/man1/citeproc.1) | 6 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/citeproc-lua.man1.pdf (renamed from Master/texmf-dist/doc/man/man1/citeproc.man1.pdf) | bin | 14638 -> 14676 bytes |
7 files changed, 61 insertions, 27 deletions
diff --git a/Master/texmf-dist/doc/latex/citation-style-language/CHANGELOG.md b/Master/texmf-dist/doc/latex/citation-style-language/CHANGELOG.md index 1c6b2df688e..e351714b3a9 100644 --- a/Master/texmf-dist/doc/latex/citation-style-language/CHANGELOG.md +++ b/Master/texmf-dist/doc/latex/citation-style-language/CHANGELOG.md @@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [v0.2.0] - 2022-08-18 + +### Added + +- The cite grouping, collapsing, and disambiguation features are now implemented. + +### Changed + +- The `citeproc` executable is renamed to `citeproc-lua` to avoid conflicts with other processor implementations. +- Package configuration can also be given in the package loading options. +- A warning is raised instead of and error in case of duplicate entry keys ([#14](https://github.com/zepinglee/citeproc-lua/issues/14)). + +### Fixed + +- Fix an infinite loop error when bib entry keys contain hyphens or underscores ([#18](https://github.com/zepinglee/citeproc-lua/issues/18)). +- Fix incorrect item position in note style ([#20](https://github.com/zepinglee/citeproc-lua/issues/20)). +- Fix compatibility with `\blockquote` of `csquotes` ([#21](https://github.com/zepinglee/citeproc-lua/issues/21)). +- Fix non-lowercase field names ([#22](https://github.com/zepinglee/citeproc-lua/issues/22)). + ## [v0.1.1] - 2022-03-21 ### Added @@ -27,6 +46,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Initial CTAN release. -[Unreleased]: https://github.com/zepinglee/citeproc-lua/compare/v0.1.1...HEAD +[Unreleased]: https://github.com/zepinglee/citeproc-lua/compare/v0.2.0...HEAD +[v0.2.0]: https://github.com/zepinglee/citeproc-lua/compare/v0.1.1...0.2.0 [v0.1.1]: https://github.com/zepinglee/citeproc-lua/compare/v0.1.0...v0.1.1 [v0.1.0]: https://github.com/zepinglee/citeproc-lua/releases/tag/v0.1.0 diff --git a/Master/texmf-dist/doc/latex/citation-style-language/DEPENDS.txt b/Master/texmf-dist/doc/latex/citation-style-language/DEPENDS.txt new file mode 100644 index 00000000000..3d0edb73de8 --- /dev/null +++ b/Master/texmf-dist/doc/latex/citation-style-language/DEPENDS.txt @@ -0,0 +1,10 @@ +# The format of this file is described in https://www.tug.org/texlive/pkgcontrib.html#deps. + +hard luatex +hard l3kernel +hard l3packages +hard filehook +hard url +hard luaxml +hard lua-uca +hard lualibs diff --git a/Master/texmf-dist/doc/latex/citation-style-language/README.md b/Master/texmf-dist/doc/latex/citation-style-language/README.md index 74c27590c61..6ad5a87602e 100644 --- a/Master/texmf-dist/doc/latex/citation-style-language/README.md +++ b/Master/texmf-dist/doc/latex/citation-style-language/README.md @@ -48,7 +48,7 @@ lualatex example.tex ```bash pdflatex example.tex -citeproc example.aux +citeproc-lua example.aux pdflatex example.tex ``` diff --git a/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.pdf b/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.pdf Binary files differindex b4ccbe55d39..af42980a811 100644 --- a/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.pdf +++ b/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.pdf diff --git a/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.tex b/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.tex index 538aaae00ac..1dda26c5fa9 100644 --- a/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.tex +++ b/Master/texmf-dist/doc/latex/citation-style-language/citation-style-language-doc.tex @@ -49,7 +49,7 @@ }% } -\date{2022-03-21 v0.1.1} +\date{2022-08-18 v0.2.0} \maketitle @@ -73,7 +73,7 @@ citations and bibliography according to the selected CSL style. A LaTeX package (\file{citation-style-language.sty}) is provided to communicate with the processor. Note that this project is in early development stage and some features of CSL -are not implemented yet (especially collapsing and disambiguation). +are not implemented yet. Comments, suggestions, and bug reports are welcome. @@ -131,14 +131,14 @@ The general procedure is similar to the traditional BibTeX workflow. \end{syntax} \end{function} -The behavior of the \pkg{citation-style-language} package is controlled by several key-value -options which can be set with the \cs{cslsetup} command. -For example, +Package options may be set when the package is loaded or at any later stage +with the \cs{cslsetup} command. +These two methods are equivalent. \begin{LaTeXdemo} - \cslsetup{ - style = apa, - locale = zh-CN, - } + \usepackage[style = apa]{citation-style-langugage} + % OR + \usepackage{citation-style-langugage} + \cslsetup{style = apa} \end{LaTeXdemo} \DescribeOption{style} @@ -278,13 +278,11 @@ recommended. If only one optional argument is provided, it is treated as \meta{postnote}. The \meta{postnote} is used as a page locator if it consists of only digits. -In other packages, several commands are provided for producing citations in -different styles such as \cs{citet}, \cs{citep}, \cs{parencite}, and -\cs{footnotecite}. -In \pkg{citation-style-language} package, however, the format of citations is -fixed as defined in CSL style and it is impossible to select another format -without modifying the \file{.csl} style file. -Note that narrative citation (like ``Doe (2018)'') will be supported in CSL 1.1. +For author-date styles, there are also narrative in-text citations where the +author names appear in running text and only dates are enclosed in parentheses +(\cs{citet} in \pkg{natbib} pacakge or \cs{textcite} in \pkg{biblatex}). +However such cite command in this pakcage is not available at the momment and +it will be implemented in the next release. \begin{function}{\cites} \begin{syntax} @@ -302,6 +300,17 @@ scanning process. The following example illustrates its usage. \cites[prefix = {See }, page = 6]{key1}[section = 2.3]{key2}\relax [Text] \end{LaTeXdemo} +\begin{function}{\nocite} + \begin{syntax} + \cs{nocite}\marg{keys} + \end{syntax} +\end{function} + +This command produces no output but makes the entries included in the +bibliography, which is the same in standard \LaTeX. +If the special key |*| is given (\cs{notecite\{*\}}), all the entries in the +database are included. + \begin{function}{\printbibliography} @@ -368,16 +377,11 @@ An error will be triggered if any of them is loaded together with \pkg{citation- The \pkg{citation-style-language} package is in early development stage and there are some issues with it. \begin{itemize} - \item The \pkg{citeproc-lua} has not implemented all the features of CSL, - especially disambiguation and collapsing. + \item The \pkg{citeproc-lua} has not implemented all the features of CSL. For detailed information of the coverage on the CSL standard test suite\footnote{\url{https://github.com/citation-style-language/test-suite}}, see \href{https://github.com/zepinglee/citeproc-lua/blob/main/test/citeproc-test.log}{citeproc-test.log} in the GitHub repository. - \item The processor is much slower than expected compared to other - reference engines. - This is because little care has been taken in the development so far. - Optimization is needed in the future. \item When used with \pkg{hyperref}, the citations are not correctly rendered as hyperlinks. \item The Unicode sorting method is provided by \pkg{lua-uca} package and diff --git a/Master/texmf-dist/doc/man/man1/citeproc.1 b/Master/texmf-dist/doc/man/man1/citeproc-lua.1 index bb891d9f419..c8fe3c3d68e 100644 --- a/Master/texmf-dist/doc/man/man1/citeproc.1 +++ b/Master/texmf-dist/doc/man/man1/citeproc-lua.1 @@ -1,8 +1,8 @@ -.TH citeproc 1 "0.1.1" +.TH citeproc-lua 1 "0.1.1" .SH NAME -citeproc \- make CSL citations and bibliography for LaTeX +citeproc-lua \- make CSL citations and bibliography for LaTeX .SH SYNOPSIS -.B citeproc +.B citeproc-lua .RB [<options>] .IR auxname [ \fB.aux\fP ] .SH DESCRIPTION diff --git a/Master/texmf-dist/doc/man/man1/citeproc.man1.pdf b/Master/texmf-dist/doc/man/man1/citeproc-lua.man1.pdf Binary files differindex 11e8faf70bf..93a4090cd09 100644 --- a/Master/texmf-dist/doc/man/man1/citeproc.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/citeproc-lua.man1.pdf |