diff options
author | Karl Berry <karl@freefriends.org> | 2019-05-05 18:06:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2019-05-05 18:06:25 +0000 |
commit | 9427dfbe861b203ec9fe309a1d590644668f2630 (patch) | |
tree | bf186c58649e74ae6a9c85d0e162b3a392f4e17b /Master/texmf-dist/doc/support/bib2gls | |
parent | c59ba5b416eb9d25a88fc9e07cc1d5573867336b (diff) |
bib2gls (10apr19)
git-svn-id: svn://tug.org/texlive/trunk@51008 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/support/bib2gls')
28 files changed, 144 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/support/bib2gls/CHANGES b/Master/texmf-dist/doc/support/bib2gls/CHANGES index d90c4cd5e75..8d0335622cf 100644 --- a/Master/texmf-dist/doc/support/bib2gls/CHANGES +++ b/Master/texmf-dist/doc/support/bib2gls/CHANGES @@ -1,14 +1,60 @@ +v1.9 (2019-04-09): + + * manual: + + - added section "Logical Divisions: type vs group vs parent" + + * new resource option: + + compact-ranges + progenitor-type + adopted-parent-field + unknown-entry-alias + save-original-entrytype + field-case-change + no-case-change-cs + encapsulate-fields + encapsulate-fields* + interpret-fields + replicate-missing-field-action + entry-sort-fallback + + * new entry types: + + @progenitor + @spawnindex + @spawnindexplural + @spawnentry + @spawnsymbol + @spawnnumber + @spawnabbreviation + @spawnacronym + + * New command line options: + + --warn-non-bib-fields + --no-warn-non-bib-fields + --warn-unknown-entry-types + --no-warn-unknown-entry-types + + * The `type` option (and similar options that assign the `type` + field) now accepts the special setting "same as parent". + + * The `group` option no longer requires the --group switch. + + * The `match` and `not-match` options now accept `original entrytype`. + v1.8 (2018-11-30): * new resource options: - --save-primary-locations - --primary-location-formats - --long-case-change - --dual-long-case-change - --word-boundaries - --sort-label-list - --dependency-fields + save-primary-locations + primary-location-formats + long-case-change + dual-long-case-change + word-boundaries + sort-label-list + dependency-fields * added support for the new glossaries-extra package option record=nameref (introduced to glossaries-extra v1.37). diff --git a/Master/texmf-dist/doc/support/bib2gls/README.md b/Master/texmf-dist/doc/support/bib2gls/README.md index 8dc48d0ef11..ac1077f3081 100644 --- a/Master/texmf-dist/doc/support/bib2gls/README.md +++ b/Master/texmf-dist/doc/support/bib2gls/README.md @@ -9,12 +9,19 @@ Application Home Page: http://www.dickimaw-books.com/software/bib2gls # Licence -Copyright (C) 2017-2018 Nicola L. C. Talbot (www.dickimaw-books.com) +Copyright (C) 2017-2019 Nicola L. C. Talbot (www.dickimaw-books.com) License GPLv3+: GNU GPL version 3 or later http://gnu.org/licenses/gpl.html This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. +# Requirements + + - Java Runtime Environment (at least Java 8). + + - TeX distribution that includes `glossaries-extra.sty` + and dependent packages (such as `glossaries.sty`). + # Summary This application may be used to extract glossary information @@ -130,6 +137,7 @@ your local or home TEXMF path (for example, `~/texmf/`): - *TEXMF*`/scripts/bib2gls/convertgls2bib.sh` (Unix-like systems only.) - *TEXMF*`/doc/support/bib2gls/bib2gls.pdf` (User manual.) + - *TEXMF*`/doc/support/bib2gls/bib2gls-begin.pdf` (Introductory Guide.) - *TEXMF*`/doc/support/bib2gls/examples/` (example files) Note that `texparserlib.jar` isn't an application. It's diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf b/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf Binary files differindex 1b56f3d9b33..7e1e380497d 100644 --- a/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls-begin.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls.1 b/Master/texmf-dist/doc/support/bib2gls/bib2gls.1 index 60060770700..b106bdcacf8 100644 --- a/Master/texmf-dist/doc/support/bib2gls/bib2gls.1 +++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls.1 @@ -133,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "BIB2GLS 1" -.TH BIB2GLS 1 "2018-08-25" "perl v5.28.0" "bib2gls" +.TH BIB2GLS 1 "2019-03-31" "perl v5.28.1" "bib2gls" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -211,6 +211,20 @@ Treat \fB\ecitation\fR as an ignored record. .IP "\fB\-\-no\-cite\-as\-record\fR" 4 .IX Item "--no-cite-as-record" Don't check for instances of \fB\ecitation\fR in the \fB.aux\fR file (default). +.IP "\fB\-\-warn\-non\-bib\-fields\fR" 4 +.IX Item "--warn-non-bib-fields" +Warn if internal non-bib fields are found in the .bib file. +.IP "\fB\-\-no\-warn\-non\-bib\-fields\fR" 4 +.IX Item "--no-warn-non-bib-fields" +Don't warn if internal non-bib fields are found in the .bib file. +The use of these internal fields can cause unexpected results, so +only use this option if you have taken appropriate precautions. +.IP "\fB\-\-warn\-unknown\-entry\-types\fR" 4 +.IX Item "--warn-unknown-entry-types" +Warn if any unknown entry types are found in the .bib file. +.IP "\fB\-\-no\-warn\-unknown\-entry\-types\fR" 4 +.IX Item "--no-warn-unknown-entry-types" +Don't warn if any unknown entry types are found in the .bib file. .IP "\fB\-\-merge\-wrglossary\-records\fR" 4 .IX Item "--merge-wrglossary-records" Merge an entry's \fBwrglossary\fR records for the same page locations. diff --git a/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf b/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf Binary files differindex 43d21de48ce..25ac8ce15bd 100644 --- a/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/bib2gls.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1 b/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1 index cc315d6401d..f7e3f097b74 100644 --- a/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1 +++ b/Master/texmf-dist/doc/support/bib2gls/convertgls2bib.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) +.\" Automatically generated by Pod::Man 4.11 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== @@ -54,16 +54,20 @@ .\" Avoid warning from groff about undefined register 'F'. .de IX .. -.if !\nF .nr F 0 -.if \nF>0 \{\ -. de IX -. tm Index:\\$1\t\\n%\t"\\$2" +.nr rF 0 +.if \n(.g .if rF .nr rF 1 +.if (\n(rF:(\n(.g==0)) \{\ +. if \nF \{\ +. de IX +. tm Index:\\$1\t\\n%\t"\\$2" .. -. if !\nF==2 \{\ -. nr % 0 -. nr F 2 +. if !\nF==2 \{\ +. nr % 0 +. nr F 2 +. \} . \} .\} +.rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. @@ -129,7 +133,7 @@ .\" ======================================================================== .\" .IX Title "CONVERTGLS2BIB 1" -.TH CONVERTGLS2BIB 1 "2018-03-04" "perl v5.26.1" "convertgls2bib" +.TH CONVERTGLS2BIB 1 "2018-03-04" "perl v5.28.1" "convertgls2bib" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/miscsymbols.bib b/Master/texmf-dist/doc/support/bib2gls/examples/miscsymbols.bib index 230eb999f3c..09410b7232c 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/miscsymbols.bib +++ b/Master/texmf-dist/doc/support/bib2gls/examples/miscsymbols.bib @@ -1,5 +1,5 @@ % This file is public domain. See the "Examples" chapter -% in the bib2gls user manual for a more detailed icondescription +% in the bib2gls user manual for a more detailed description % of this file. % Encoding: UTF-8 diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf Binary files differindex 7e637a9e649..391edd5c4c0 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-authors.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf Binary files differindex 37088bf4823..b42fe0ce034 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-bacteria.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf Binary files differindex ba5cafb6d1d..415f4aa092b 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-chemical.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf Binary files differindex 70bb61b0470..26d9b7bb3d0 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-citations.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf Binary files differindex 616370e70e7..d650ceed9bb 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-constants.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf Binary files differindex bf7cb76b55d..f06a07262a1 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-markuplanguages.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf Binary files differindex 9f1849fe1ac..8a6db9d368e 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-maths.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf Binary files differindex 2ecee98595b..57b1cd6c752 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-media.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf Binary files differindex 2a8cf08a99f..9ed3e0ce937 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-msymbols.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf Binary files differindex bca3e987feb..0928aae45a6 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi1.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf Binary files differindex e61b207d5ec..a033fb98a12 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-multi2.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf Binary files differindex 1490ac1b029..0c3e8bdfd8f 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-people.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf Binary files differindex 239503ceb43..15b504fc052 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.tex b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.tex index 95b07ce51e8..3855765b8b7 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.tex +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols.tex @@ -1,7 +1,8 @@ % This file is public domain. See the "Examples" chapter % in the bib2gls user manual for a more detailed description % of this file. - +% Compare this file with sample-textsymbols2.tex which uses +% a hierarchical approach. \documentclass[a4paper]{article} \usepackage[T1]{fontenc} @@ -18,7 +19,7 @@ \usepackage[record,% using bib2gls nostyles,% don't load default styles postdot,% append a dot after descriptions - stylemods={tree},% load glossary-mcols.sty and patch + stylemods={tree},% load glossary-tree.sty and patch style=alttreegroup]{glossaries-extra} \GlsXtrLoadResources[ diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf Binary files differnew file mode 100644 index 00000000000..98022c2dac2 --- /dev/null +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.tex b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.tex new file mode 100644 index 00000000000..9a670f91f1a --- /dev/null +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-textsymbols2.tex @@ -0,0 +1,41 @@ +% This file is public domain. See the "Examples" chapter +% in the bib2gls user manual for a more detailed description +% of this file. + +\documentclass[a4paper]{article} + +\usepackage[T1]{fontenc} + +\usepackage{etoolbox} +\usepackage{marvosym} + +% package conflict, need to undefine conflicting commands +\undef\Sun +\undef\Lightning + +\usepackage[weather]{ifsym} + +\usepackage[record,% using bib2gls + nostyles,% don't load default styles + postdot,% append a dot after descriptions + stylemods={tree,topic},% load glossary-tree.sty and glossary-topic.sty + style=topic]{glossaries-extra} + +\GlsXtrLoadResources[ + src={topics,miscsymbols}, +% make @icon behave like @symbol: + entry-type-aliases={icon=symbol}, + field-aliases={ + identifier=parent, + icon=name, + icondescription=description + }, + symbol-sort-fallback={description}, + set-widest, + selection=all +] + +\begin{document} +\printunsrtglossaries +\end{document} + diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf Binary files differindex b3a5176fdba..3d08fa6a9da 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units1.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf Binary files differindex db752bfcd20..e80be3024cd 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units2.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf Binary files differindex 799ee650f30..c7d170c578c 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-units3.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf b/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf Binary files differindex 2cefbd0b1ec..042f277b427 100644 --- a/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf +++ b/Master/texmf-dist/doc/support/bib2gls/examples/sample-usergroups.pdf diff --git a/Master/texmf-dist/doc/support/bib2gls/examples/topics.bib b/Master/texmf-dist/doc/support/bib2gls/examples/topics.bib new file mode 100644 index 00000000000..f38577f6ca8 --- /dev/null +++ b/Master/texmf-dist/doc/support/bib2gls/examples/topics.bib @@ -0,0 +1,9 @@ +% This file is public domain. See the "Examples" chapter +% in the bib2gls user manual for a more detailed description +% of this file. + +% Encoding: UTF-8 + +@index{information} +@indexplural{mediacontrol,text={media control}} +@indexplural{weather,text={weather symbol}} |