Mentions légales du service

Skip to content
Snippets Groups Projects
Commit b13cd0f0 authored by Roberto Di Cosmo's avatar Roberto Di Cosmo
Browse files

Specification: add eprint* fields and update the documentation

parent e6febf45
No related branches found
No related tags found
No related merge requests found
@software{2013ascl.soft05002P,
author = {{Pontzen}, A. and {Ro{\v s}kar}, R. and {Stinson}, G. and {Woods}, R.},
title = "{pynbody: N-Body/SPH analysis for python}",
editor = {{Astrophysics Source Code Library}},
year = 2013,
month = may,
eprint = {1305.002},
eprinttype = "ascl",
url = {http://adsabs.harvard.edu/abs/2013ascl.soft05002P},
note = {Provided by the SAO/NASA Astrophysics Data System}
}
@manual {scilabdoc,
title = {The offical Scilab documentation},
......@@ -77,3 +88,4 @@
urllocal = "http://www.dicosmo.org/Articles/2020-CiSE-swhid.pdf",
Journal = {Computing in Science and Engineering}
}
No preview for this file type
......@@ -76,6 +76,7 @@ extended with the \texttt{software} module.
\item softwaremodule entry Voronoi: from the chain of crossrefs \cite{cgal:lp-gi-20a}, and the from the condensed bibtem \cite{cgal:lp-gi-20a-condensed} (they should be identical)
\item software entry Parmap \cite{parmap}
\item codefragment entry simplemapper \cite{simplemapper}
\item software entry from the Astrophysics Source Code Library, using the eprint field \cite{2013ascl.soft05002P}
\item documentation in a software entry \cite{scilabdoc}
\end{itemize}
......
......@@ -199,6 +199,33 @@ of the source code of the software described in the entry. The default is |true|
\noindent This option controls the inclusion of the url of the code hosting
platform where the software described in the enttry is developed. The default is |true|.
\subsection{Adding support for additional software identifiers}
It would not be reasonable to have a dedicated field for each of the many software releated identifiers that exist.
If you want to create bibliographic records that use identifiers not natively supported by this package, you
can use the standard Bib\LaTeX\ mechanism that uses the ~eprint~, ~eprinttype~ and ~eprintclass~ fields.\\
The default formatting of these fields may be what you want, but if it's not the case, you can define
your own format, as explained in the official Bib\LaTeX\ documentation.\\
As an example, this style already contains a specific formatting definition for the Astrophysics Source Code Library (ASCL) software records,
via the following declaration in the ~software.bbx~ file:
\begin{verbatim}
\DeclareFieldFormat{eprint:ascl}{%
ascl\addcolon\space
\ifhyperref
{\href{https://ascl.net/#1}{%
\nolinkurl{#1}%
\iffieldundef{eprintclass}
{}
{\addspace\texttt{\mkbibbrackets{\thefield{eprintclass}}}}}}
{\nolinkurl{#1}%
\iffieldundef{eprintclass}
{}
{\addspace\texttt{\mkbibbrackets{\thefield{eprintclass}}}}}}
\end{verbatim}
\section{Details}
The detailed information for this style is contained in the example document and
......
......@@ -8,7 +8,7 @@ Computer software.
\emph{Required fields:} \texttt{author} / \texttt{editor}, \texttt{title}, \texttt{url}, \texttt{year}
\emph{Optional fields:} \texttt{abstract}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\emph{Optional fields:} \texttt{abstract}, \texttt{date}, \texttt{doi}, \texttt{eprint}, \texttt{eprintclass}, \texttt{eprinttype}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\texttt{institution}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
\texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{urldate}, \texttt{version}
......@@ -18,7 +18,7 @@ fields from the entry mentioned in the \texttt{crossref} field.
\emph{Required fields:} \texttt{author} / \texttt{editor}, \texttt{title}, \texttt{url}, \texttt{version}, \texttt{year}
\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eprint}, \texttt{eprintclass}, \texttt{eprinttype}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
\texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{subtitle}, \texttt{urldate}
......@@ -29,7 +29,7 @@ fields from the entry mentioned in the \texttt{crossref} field.
\emph{Required fields:} \texttt{author}, \texttt{subtitle}, \texttt{url}, \texttt{year}
\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{editor}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\emph{Optional fields:} \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eprint}, \texttt{eprintclass}, \texttt{eprinttype}, \texttt{editor}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
\texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{title}, \texttt{urldate}, \texttt{version}
......@@ -40,7 +40,7 @@ Inherits values of missing fields from the entry mentioned in the \texttt{crossr
\emph{Required fields:} \texttt{url}
\emph{Optional fields:} \texttt{author}, \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eid}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\emph{Optional fields:} \texttt{author}, \texttt{abstract}, \texttt{crossref}, \texttt{date}, \texttt{doi}, \texttt{eprint}, \texttt{eprintclass}, \texttt{eprinttype}, \texttt{file}, \texttt{hal\_id}, \texttt{hal\_version},
\texttt{institution}, \texttt{introducedin}, \texttt{license}, \texttt{month}, \texttt{note}, \texttt{organization}, \texttt{publisher},
\texttt{related}, \texttt{relatedtype}, \texttt{relatedstring}, \texttt{repository}, \texttt{swhid}, \texttt{subtitle}, \texttt{title}, \texttt{urldate}, \texttt{version}, \texttt{year}
......@@ -63,7 +63,9 @@ style. It is not used by all standard bibliography styles.
\item[{editor}] list (name). The coordinator(s) of large modular software projects.
\item[{file}] field (verbatim). A link to download a copy of the work.
\item[{doi}] field (verbatim). The Digital Object Identifier of the work.
\item[{eid}] field (verbatim). An electronic identifier of the work.
\item[{eprint [biblatex only]}] field (verbatim). An electronic identifier of the work. This field can be used to accommodate electronic identifiers different from the ones that have a dedicate field in this style.
\item[{eprinttype [biblatex only]}] field (verbatim). The type of eprint identifier, e. g., the name of the archive, repository, service, or system the eprint field refers to. Will be typeset by default as a prefix of the content of the eprint field.
\item[{eprintclass [biblatex only]}] field (verbatim). Additional information related to the resource indicated by the eprinttype field. This could be a section of an archive, a path indicating a service, a classification of some sort.
\item[{\texttt{hal\_id} [not in biblatex standard styles]}] field (verbatim). A digital identifier for the
software record including its description and metadata on HAL.
\item[{\texttt{hal\_version} [not in biblatex standard styles]}] field (verbatim). The version of the HAL software record designated by \texttt{hal\_id}.
......
......@@ -31,7 +31,7 @@ whishes to cite. They are listed below in order of granularity.
/Required fields:/ ~author~ / ~editor~, ~title~, ~url~, ~year~
/Optional fields:/ ~abstract~, ~date~, ~doi~, ~eid~, ~file~, ~hal_id~, ~hal_version~,
/Optional fields:/ ~abstract~, ~date~, ~doi~, ~eprint~, ~eprintclass~, ~eprinttype~, ~file~, ~hal_id~, ~hal_version~,
~institution~, ~license~, ~month~, ~note~, ~organization~, ~publisher~,
~related~, ~relatedtype~, ~relatedstring~, ~repository~, ~swhid~, ~urldate~, ~version~
......@@ -41,7 +41,7 @@ whishes to cite. They are listed below in order of granularity.
/Required fields:/ ~author~ / ~editor~, ~title~, ~url~, ~version~, ~year~
/Optional fields:/ ~abstract~, ~crossref~, ~date~, ~doi~, ~eid~, ~file~, ~hal_id~, ~hal_version~,
/Optional fields:/ ~abstract~, ~crossref~, ~date~, ~doi~, ~eprint~, ~eprintclass~, ~eprinttype~, ~file~, ~hal_id~, ~hal_version~,
~institution~, ~introducedin~, ~license~, ~month~, ~note~, ~organization~, ~publisher~,
~related~, ~relatedtype~, ~relatedstring~, ~repository~, ~swhid~, ~subtitle~, ~urldate~
......@@ -52,7 +52,7 @@ whishes to cite. They are listed below in order of granularity.
/Required fields:/ ~author~, ~subtitle~, ~url~, ~year~
/Optional fields:/ ~abstract~, ~crossref~, ~date~, ~doi~, ~eid~, ~editor~, ~file~, ~hal_id~, ~hal_version~,
/Optional fields:/ ~abstract~, ~crossref~, ~date~, ~doi~, ~eprint~, ~eprintclass~, ~eprinttype~, ~editor~, ~file~, ~hal_id~, ~hal_version~,
~institution~, ~introducedin~, ~license~, ~month~, ~note~, ~organization~, ~publisher~,
~related~, ~relatedtype~, ~relatedstring~, ~repository~, ~swhid~, ~title~, ~urldate~, ~version~
......@@ -63,7 +63,7 @@ whishes to cite. They are listed below in order of granularity.
/Required fields:/ ~url~
/Optional fields:/ ~author~, ~abstract~, ~crossref~, ~date~, ~doi~, ~eid~, ~file~, ~hal_id~, ~hal_version~,
/Optional fields:/ ~author~, ~abstract~, ~crossref~, ~date~, ~doi~, ~eprint~, ~eprintclass~, ~eprinttype~, ~file~, ~hal_id~, ~hal_version~,
~institution~, ~introducedin~, ~license~, ~month~, ~note~, ~organization~, ~publisher~,
~related~, ~relatedtype~, ~relatedstring~, ~repository~, ~swhid~, ~subtitle~, ~title~, ~urldate~, ~version~, ~year~
......@@ -85,7 +85,9 @@ The field description is based on the [[http://mirrors.ibiblio.org/CTAN/macros/l
- editor :: list (name). The coordinator(s) of large modular software projects.
- file :: field (verbatim). A link to download a copy of the work.
- doi :: field (verbatim). The Digital Object Identifier of the work.
- eid :: field (verbatim). An electronic identifier of the work.
- eprint [biblatex only] :: field (verbatim). An electronic identifier of the work. This field can be used to accommodate electronic identifiers different from the ones that have a dedicate field in this style.
- eprinttype [biblatex only] :: field (verbatim). The type of eprint identifier, e. g., the name of the archive, repository, service, or system the eprint field refers to. Will be typeset by default as a prefix of the content of the eprint field.
- eprintclass [biblatex only] :: field (verbatim). Additional information related to the resource indicated by the eprinttype field. This could be a section of an archive, a path indicating a service, a classification of some sort.
- ~hal_id~ [not in biblatex standard styles] :: field (verbatim). A digital identifier for the
software record including its description and metadata on HAL.
- ~hal_version~ [not in biblatex standard styles] :: field (verbatim). The version of the HAL software record designated by ~hal_id~.
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment