Cv format commenting improvements about inspire

[michamos]

I did the macro thing before seeing this issue. Hopefully it is user-friendy enough.

About the future, we were discussing with @jacquerie that we could use BibTeX as a master format for all TeX-related output, and generate the rest by running it through bibtex (or rather pybtex) with various style files.

[kaplun]

cc: @tsgit

[kaplun]

Alternatively one can protect these lines using LaTeX macros that can be toggled at the beginning of the produced output so that the user can just set a flag in order to display/hide each particular line.

[tsgit]

the macros are a neat solution, but the cynic in me would say that users smart enough to understand and use the function of those macros would likely also know regexp well.

The CV format is one of several formats that should be generated with more flexibility from a common metaformat which I understand CSL will provide (minus the up-to-date citation count)

as for macros, something like this (untested)

\newif\ifcitationcount
\citationcountfalse
% \citationcounttrue
\newcommand{\showcitationcount}[1]{\ifcitationcount {#1} \fi}

\begin{document}
.....

\showcitationcount{2 citations counted in INSPIRE as of 24 Aug 2016}

mmh, looks quite complex and there need to be different macros for different comments and users are supposed to understand how to manipulate the preamble?

[tsgit]

@kaplun
so maybe the simple unique prefix method suggested is preferable. What does Barbara think?

[kaplun]

@tsgit yup that would be perfect. Basically only one change to safely amend 300 publication and toggle their display.

The issue with CSL (if I am understanding correctly) is that it's specific to HTML so for our use LaTeX-centric world is not so useful.

The template approach is not as complex as regexp because we could provide a well-documented template that would serve as live example (most physicists learn by example rather than studying the documentation). Additionally, in this proposal, we would preserve the template the physicist has amended, so in any moment she could have an up-to-date CV according to her desire. (her/she intending the generic physicist, not necessarily my wife 💃).

[tsgit]

@kaplun pandoc can use CSL to format LaTeX bibliographies

[kaplun]

@kaplun pandoc can use CSL to format LaTeX bibliographies

although this would be heavyweight for Legacy. I think some simple quick wins can be achieved without going full speed to CSL.

[tsgit]

@michamos @jacquerie

having a rich and flexible metaformat from which various output formats are generated has been discussed repeatedly. only for the latex output formats which are essentially formatted references is bibtex a good choice (and one could offer all kinds of bibstyles to format for specific journals, but isn't that like running bibtex for the users when they should know best themselves what the requirements of the target publisher are), otherwise I consider bibtex format itself an endpoint not a metaformat. It has limited @entry types, limited set of fields, restrictions on field content, no sense of ordering, etc.

so 👍 for pursuing a common metaformat to generate a wide variety of output formats on demand with flexible config options and parameters, but I don't think bibtex is the pivotal thing here. CSL http://citationstyles.org/ anybody?

[kaplun]

Truth is that LaTeX is today the format used by HEP physicists in everything they do: papers, CVs, projects etc.

BibTeX is hence perfect for them, but also our LaTeX format are of high usability for those authors that have less skill or interest in LaTeX details and want just something that works.

HTML or text based formats are instead of little use, because they can't be really cut and paste in any useful external place. They are only nice to look at.

[tsgit]

#260
inspirehep/invenio#377
inspirehep/invenio#379
inspirehep/invenio#380

resolve this issue