bib2ris-utf8 - Online in de cloud

PROGRAMMA:

NAAM

bib2ris, bib2ris-utf8 - converteert bibtex bibliografische gegevens naar het RIS-formaat

KORTE INHOUD

bib2ris [-e log-bestemming] [-h] [-j] [-l Log niveau] [-L log-bestand] [-q] [-s afscheider]
[-v] [-y conf] filet

bib2ris-utf8 [-e log-bestemming] [-h] [-j] [-l Log niveau] [-L log-bestand] [-Q]
[-S afscheider] [-v] [-y conf] filet

PRODUCTBESCHRIJVING

bib2ris converteert BibTeX-bibliografiebestanden naar RIS-bestanden. Latex-commando's, inclusief
niet-ASCII-tekens die als opdrachten zijn geschreven, blijven behouden in de uitvoer. Het importeren van de
uitvoer van het hulpprogramma bib2ris rechtstreeks in RefDB is alleen nuttig als u de gegevens gebruikt
exclusief voor LaTeX.

bib2ris-utf8 is een variant die vreemde karakters converteert naar UTF-8 en alle andere verwijdert
LaTeX-commando's door middel van de tool refdb_latex2utf8txt (1). De uitvoer van bib2ris-utf8 is
het voorkeursformaat voor import in RefDB omdat het geschikt is voor zowel LaTeX als SGML/XML
bibliografieën.

Helaas zijn de concepten die ten grondslag liggen aan de BibTeX- en RIS-bibliografische gegevens behoorlijk
anders, zodat BibTeX-gegevens zich niet gemakkelijk lenen voor een schone conversie naar de
RIS-indeling. Dit is niet bedoeld als excuus om een ​​slecht filter te leveren, maar u moet zich ervan bewust zijn
dat er tijdens het compileren enkele aannames moeten worden gedaan om redelijke resultaten te krijgen. In
in ieder geval, aangezien de datamodellen aanzienlijk verschillen, een verliesvrije heen en terug conversie
tussen de twee gegevenstypen is niet mogelijk: Als u een BibTeX-bibliografiebestand converteert naar
RIS en dan weer terug, het resultaat zal flink afwijken van jouw input.

De volgende overwegingen zijn van toepassing op de gegevensimport in RefDB en de gegevensexport van
RefDB:

1. BibTeX-invoergegevens die niet zijn geschreven in UTF-8, die opmaakcommando's gebruiken zoals
lettertypenaam, gewicht of postuurspecificaties, of die LaTeX-commando's gebruiken om te schrijven
vreemde en speciale tekens moeten altijd worden omgezet met bib2ris-utf8.

2. BibTeX-uitvoergegevens zullen de LaTeX-commandotekens correct laten ontsnappen. De data
zal de standaardcodering van uw referentiedatabase gebruiken, tenzij u specifiek
vraag een andere codering aan met het getref-commando of met de refdbib-tool. Houden in
houd er rekening mee dat recente LaTeX-installaties kunnen werken met UTF-8-gegevens met behulp van het volgende
bezwering in de proloog, waardoor de gemakkelijkste ondersteuning voor allerlei soorten buitenlanders mogelijk is
karakters:

\gebruikpakket[utf8]{invoer}

OPTIES

-e log-bestemming
log-bestemming kan de waarden 0, 1 of 2 hebben, of de equivalente tekenreeksen stderr,
syslogof filet, respectievelijk. Deze waarde geeft aan waar de logboekinformatie naartoe gaat.
0 (nul) betekent dat de berichten naar stderr worden verzonden. Ze zijn direct beschikbaar op de
scherm, maar ze kunnen de uitvoer van opdrachten verstoren. 1 zal de output naar de . sturen
syslog-faciliteit. Houd er rekening mee dat syslog moet worden geconfigureerd om logberichten te accepteren
van gebruikersprogramma's, zie de syslog(8) man-pagina voor meer informatie. Unix-achtig
systemen slaan deze berichten meestal op in /var/log/user.log. 2 stuurt de berichten naar
een aangepast logbestand dat kan worden opgegeven met de -L optie.

-h
Geeft het help- en gebruiksscherm weer en sluit vervolgens af.

-j
Forceer bib2ris om te gebruiken JO RIS-velden in alle gevallen. Als deze optie niet wordt gebruikt, wordt bib2ris
probeert af te leiden of een tijdschriftnaam een ​​afkorting is of niet. Als de tekenreeks
bevat ten minste één punt, JO wordt anders gebruikt JF gebruikt.

-l Log niveau
Specificeer de prioriteit tot welke gebeurtenissen worden gelogd. Dit is ofwel een getal tussen 0
en 7 of een van de snaren emerg, te waarschuwen, crit, dwalen, waarschuwing, kennisgeving, info, debug,
respectievelijk (zie ook Definities op logniveau). -1 schakelt logboekregistratie volledig uit. Een lage
log-niveau zoals 0 betekent dat alleen de meest kritieke berichten worden gelogd. Een hoger logboek
niveau betekent dat ook minder kritieke gebeurtenissen worden gelogd. 7 bevat foutopsporing
berichten. Dit laatste kan uitgebreid en overvloedig zijn, dus u wilt dit logniveau vermijden
tenzij u problemen moet opsporen.

-L log-bestand
Geef het volledige pad op naar een logbestand dat de logberichten zal ontvangen. Meestal dit
zou zijn /var/log/refdba.

-q
Begin zonder de configuratiebestanden te lezen. De client gebruikt de compile-time
standaardwaarden voor alle waarden die u niet instelt met opdrachtregelopties.

-s afscheider
Geef het scheidingsteken op dat afzonderlijke trefwoorden scheidt in een niet-standaard trefwoord
veld. Gebruik de tekenreeks spc voor door witruimten gescheiden lijsten (spaties en tabs).

-v
Drukt versie- en copyrightinformatie af en sluit vervolgens af.

-y conf
Geef de map op waar de globale configuratiebestanden zich bevinden. Opmerking: Standaard zijn alle
RefDB-toepassingen zoeken naar hun configuratiebestanden in een opgegeven map
tijdens de configuratiestap bij het bouwen van het pakket. Dat wil zeggen, je hebt de niet nodig -y
optie tenzij u voorgecompileerde binaire bestanden op ongebruikelijke locaties gebruikt, bijv. door een
rpm pakket.

filet
Indien gebruikt, geeft deze parameter de namen van een of meer bibtex-bestanden aan. Als er geen bestand is
opgegeven, probeert bib2ris de gegevens van stdin te lezen. Uitvoer wordt altijd naar stdout gestuurd.

DIAGNOSE

De exitcode van bib2ris geeft aan wat er in het algemeen mis ging (de details zijn te vinden in
de logboekuitvoer). De code is de som van de volgende foutwaarden:

1
algemene fout; omvat onvoldoende geheugensituaties en ongeldige opdrachtregelopties

2
onvolledige invoer (ten minste één essentieel veld in een invoer ontbrak)

4
onbekende veldnaam

8
onbekend publicatietype

16
ongeldige BibTeX->RIS-typetoewijzing

32
verwerkings fout; bevat bestandstoegangsfouten

CONFIGURATIE

bib2ris evalueert het bestand bib2risrc om zichzelf te initialiseren.

tafel 1. bib2risrc
┌─────────────────┬───────────────────── ─┬──────── ──────────────────┐
│Veranderlijk │ Standaard │ Opmerking │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│logfile │ /var/log/bib2ris.log │ Het volledige pad van een │
│ │ │ aangepast logbestand. Dit is
│ │ │ alleen gebruikt als logdest │ . is
│ │ │ correct ingesteld. │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│logdest │ 1 │ De bestemming van de │
│ │ │ logboekinformatie. 0 =
│ │ │ afdrukken naar stderr; 1 = gebruik │
│ │ │ de syslog-faciliteit; 2 =
│ │ │ gebruik een aangepast logbestand. │
│ │ │ De laatste heeft een │ . nodig
│ │ │ juiste instelling van │
│ │ │ logbestand. │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│logniveau │ 6 │ Het logniveau tot │
│ │ │ welke berichten zullen worden │
│ │ verzonden. Een lage instelling (0) │
│ │ │ staat alleen de meeste │ toe
│ │ │ belangrijke berichten, een │
│ │ │ hoge instelling (7) maakt │ . mogelijk
│ │ │ alle berichten inclusief │
│ │ │ debug berichten. -1 betekent
│ │ │ er wordt niets gelogd. │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│abbrevfirst │ t │ Als deze optie is ingesteld op │
│ │ │ "t", de voornamen van │
│ │ │ alle auteurs en redacteuren │
│ │ │ wordt afgekort tot │
│ │ │ de initialen. Indien ingesteld op │
│ │ │ "f", de voornamen │
│ │ │ worden gebruikt zoals ze zijn │
│ │ │ gevonden in de BibTeX │
│ │ │ bibliografiebestand. │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│listsep │ ; │ Dit is het scheidingsteken │
│ │ │ die │ scheidt
│ │ │ individuele zoekwoorden in een │
│ │ │ niet-standaard trefwoord │
│ │ │ veld. Gebruik de tekenreeks │
│ │ │ "spc" voor │
│ │ │ door witruimte gescheiden │
│ │ │ lijsten (spaties en tabs). │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│forcejabbrev │ f │ Als dit is ingesteld op "t", │
│ │ │ tijdschriftnamen worden │
│ │ │ verpakt in RIS "JO" │
│ │ │ vermeldingen. Als het is ingesteld op │
│ │ │ "f", bib2ris zal │ gebruiken
│ │ │ "JO"-vermeldingen alleen als de │
│ │ │ tijdschriftnaam bevat at │
│ │ │ ten minste één punt, │
│ │ │ anders gebruikt het │
│ │ │ "JF". │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartartikel │ JOUR │kaart het BibTeX-artikel │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartenboek │ BOEK │ kaart het BibTeX-boek │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartenboekje │ PAMP │ kaart het BibTeX boekje │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│mapconferentie │ CHAP │ breng de BibTeX in kaart │
│ │ │ conferentiepublicatie │
│ │ │ type naar een RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│mapinbook │ CHAP │ kaart het BibTeX inbook │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartincollectie │ CHAP │kaart de BibTeX │
│ │ │ incollectiepublicatie │
│ │ │ type naar een RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartinprocedures │ CHAP │kaart de BibTeX │
│ │ │ in procedures │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaarthandleiding │ BOEK │ kaart de BibTeX-handleiding │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│mapmasterscriptie │ THES │map the BibTeX │
│ │ │ masterproef │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│mapmisc │ GEN │ kaart de BibTeX misc │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│mapphdthesis │ THES │ breng de BibTeX-phdthesis in kaart │
│ │ │ publicatietype naar een │
│ │ │ RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaartprocedure │ CONF │ kaart de BibTeX in kaart │
│ │ │ publicatie publicatie │
│ │ │ type naar een RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaarttechnisch rapport │ RPRT │ breng de BibTeX in kaart │
│ │ │ techreport publicatie │
│ │ │ type naar een RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│kaart niet gepubliceerd │ UNPB │ kaart de BibTeX │
│ │ │ ongepubliceerde publicatie │
│ │ │ type naar een RIS-type │
├─────────────────┼───────────────────── ─┼──────── ──────────────────┤
│nsf_xyz │ (geen) │ U kunt een │
│ │ │ onbeperkt aantal │
│ │ │ deze vermeldingen in kaart te brengen │
│ │ │ niet-standaard BibTeX │
│ │ │ velden naar RIS-tags. De │
│ │ │ BibTeX-veldnaam in │
│ │ │ deze variabele moet │ zijn
│ │ │ in kleine letters, ongeacht │
│ │ │ van de zaak in uw │
│ │ │ invoergegevens (bib2ris │
│ │ │ behandelt veldnamen als │
│ │ │ niet hoofdlettergevoelig). De │
│ │ │ RIS-tag van twee letters heeft │
│ │ │ in hoofdletters. Bijv. │
│ │ │ om uw BibTeX in kaart te brengen │
│ │ │ "Abstract" veld naar de │
│ │ │ RIS "N2"-tag, de invoer │
│ │ │ zou lezen: │
│ │ │ "nsf_abstract N2". │
└─────────────────┴───────────────────── ─┴──────── ──────────────────┘

GEGEVENS VERWERKEN

Deze sectie geeft een paar hints over de dataconversie zelf en het BibTeX-formaat
vereisten.

· Het ontleden van de invoergegevens wordt gedaan door de btparse-bibliotheek. Allemaal beperkingen daarvan
bibliotheek is ook van toepassing op bib2ris. Dit geldt heel specifiek voor twee hardcoded
instellingen in btparse die, simpel gezegd, de grootte en complexiteit beperken (in termen van
macro's) van een invoerbestand dat btparse aankan. Mocht je tegen dit soort problemen aanlopen
(Ik moest een BibTeX-bibliografie van 2 MB van internet halen om deze limiet te verifiëren)
u moet de waarden van verhogen NUM_MACROS en STRING_SIZE in het bronbestand
macros.c en compileer de btparse-bibliotheek opnieuw.

· Alle invoernamen en veldnamen in het BibTeX-invoerbestand worden behandeld als
niet hoofdlettergevoelig, dwz "BoOk" is hetzelfde als "book" en "AUTHOR" is hetzelfde als
"auteur".

· De inzendingen worden gecontroleerd op volledigheid. Er wordt een fout gegenereerd als een invoer ontbreekt
velden die essentieel worden geacht voor het specifieke publicatietype.

· Niet-standaard velden kunnen worden geïmporteerd naast de vooraf gedefinieerde BibTeX-velden.
Maak een invoer voor elke niet-standaard BibTeX-veldnaam waarin uw invoergegevens worden gebruikt
uw bib2ris-configuratiebestand. De gegevens worden verschillend behandeld op basis van het type
RIS-veld waarin ze zijn geïmporteerd. Als de gegevens worden geïmporteerd naar de RIS-velden AD, N1 of
N2, die in principe een onbeperkte grootte hebben, zullen alle voorkomens van deze velden zijn
samengevoegd tot respectievelijk een enkele AD-, N1- of N2-tagregel. Als de gegevens zijn
toegewezen aan het RIS KW-veld, wordt de tekenreeks getokeniseerd op basis van het lijstscheidingsteken
opgegeven in de configuratievariabele listsep. Elk token wordt geschreven als een
aparte KW-taglijn. Een speciaal geval is het RIS pseudo-veld "PY.day". Gegevens geïmporteerd
aan deze tag zijn geïntegreerd als het dagdeel in de regel voor de publicatiedatum "PY" (year
en maand, maar niet dag, zijn standaard BibTeX-velden en worden standaard herkend). Alle
andere velden worden afgedrukt met de gevraagde RIS-tag. Het is ter beoordeling van
elke RIS-importtoepassing om te beslissen wat te doen met dubbele tagregels. Veelvouden
zijn toegestaan ​​voor auteurstags (AU, A2, A3) en de trefwoordtag (KW). refdb zal de
laatste optreden van een tagregel die meerdere keren niet is toegestaan.

· Afgekorte tijdschriftnamen worden alleen gedetecteerd als ze punten gebruiken. Bijv. "J. Biol.
Chem." zal worden toegewezen aan een "JO" RIS-element, terwijl "J Biol Chem" dat zal zijn
(ten onrechte) toegewezen aan een "JF"-element ("Journal of Biological Chemistry" zou
komen hier ook terecht). Spaties na punten zijn optioneel. Om “J Biol
Chem” in een "JO"-element, gebruik de -j opdrachtregeloptie of de "forcejabbrev"
configuratiebestand variabele.

· Het in kaart brengen van BibTeX-publicatietypes (boek, inproceedings...) naar RIS-types als
opgegeven in het configuratiebestand wordt gecontroleerd op geldige RIS-typen. Als een ongeldig RIS
type is opgegeven, wordt er een fout gegenereerd en wordt in plaats daarvan de standaardwaarde voor compileren gebruikt.

· Standaard worden de voornamen van auteurs en redacteuren niet afgekort. Als je dat wenst
kan configureren bib2ris om voor- en tweede namen af ​​te korten.

Gebruik bib2ris-utf8 online met behulp van onworks.net-services