loup-brun / hugo-cite Goto Github PK

View Code? Open in Web Editor NEW

102.0 8.0 23.0 219 KB

📝 Easily manage your bibliography and in-text citations with Hugo, the popular static-site generator.

Home Page: https://labs.loupbrun.ca/hugo-cite/

License: Do What The F*ck You Want To Public License

HTML 95.99% CSS 4.01%

hugo bibliography shortcode csl-json citations static-site-generator

hugo-cite's Introduction

loup-brun

Why a README when you already have a website of your own?

https://www.loupbrun.ca

hugo-cite's People

Contributors

Stargazers

Watchers

hugo-cite's Issues

Display two authors instead of "Author 1 & al."

Actually if a bibliographical reference have 2 authors, the citation display just the first, but it's useful to have both when there is less than 3 authors.

Current:

Expected:

In-text citations: support audio/video time codes

This discussion arouse previously in #19 and is moved here for the sake of finer scoping.

Make it easy to download & install/update

Provide a way to make simple updates, by downloading the repo without manually copy-pasting or cherry-picking files.

This may be useful:
https://gohugo.io/hugo-modules/theme-components/

How to uninstall?

Add documentation on how to uninstall the submodule from a project.

This implies the following actions:

Remove the theme entry in the Hugo config.yml/config.toml file:
- GNU sed: sed -i -e '/- hugo-cite/d' config.yml;
- MacOS sed: sed -i '' -e '/- hugo-cite/d' config.yml (via StackOverflow);
Delete the themes/hugo-cite directory + removing from the parent Git project: git rm -r themes/hugo-cite;
Cleanup local submodule objects (rm -rf .git/modules/themes/hugo-cite/).

singular/plural editor marker (Eds.) vs. (Ed.)

Greetings,

in the Chapter type there is the following lines:

hugo-cite/layouts/partials/bibliography/apa-style.html

Line 185 in bd36e7f

  {{- if .editor -}}
  &#32;{{- template "editorPart" . }} (Eds.),&#32;
  {{- end -}}

APA 6th calls fro (Eds.) to only be used when editor count is more than one, else (Ed.) is used.

Bubble overflow on small screens

This is a layout gotcha on narrower screens: citation bubbles overflow the document.
A quick fix is to apply overflow: hidden to the scrolling html/body element, but the hover bubble remains partly hidden.

Suggestions:

on narrower screens, hide the bubbles completely;
align to the absolute left of the viewport, setting maximum width the viewport width.

Chapter type

Greeting

I am looking at CSL-JSON and schema.org/Chapter

https://schema.org/Chapter is for chapter, but the Zotero content (assuming that one uses Zotero to generate the CSL-JSON) is simply for book section (introduction and other book portions too. see: https://www.zotero.org/support/kb/item_types_and_fields#zotero_item_types_and_fields). Does using the schema.org type make assumptions about the data which is not true all the time? – granted they are likely true most of the time...

Needs minimal CSS

To show nice bubbles on hover.

APA 6th for translator roles

Greetings,

I needed to add a translator so I did. Translators can be attached to any resource type. But in my templates I only added them to books as that is all I needed sofar. Ideally there would be a better way than to add translator to each title... maybe a title template is needed. Here is the two part solution I came up with:

I duplicated the authorPart and modified it to become translatorPart (if the authorPart is modified to include handle corporate or "literal" names, then those adjustments should also be made to the translatorPart #26 ):

{{/* BEGIN translator */}}
{{- define "translatorPart" }}
  {{- $translators := .translator }}
  {{- if $translators -}}
  {{- $totalTranslators := len $translators -}}
  {{- range $translatorIndex, $translator := $translators -}}
  <span itemprop="author" itemscope itemtype="https://schema.org/Person">
     {{- with $translator.given -}}
    <meta itemprop="givenName" content="{{ . }}" />{{ substr . 0 1 }}.&nbsp;
    {{- end -}}{{/* First letter (initial). */}}
    {{- with $translator.secondInitial -}}
    <meta itemprop="additionalName" content="{{ . }}" />
    {{- substr . 0 1 -}}.&nbsp;{{- end -}}
   {{- with $translator.family -}}
    <span itemprop="familyName">{{ . }}</span>
    {{- end -}}
  </span>
  {{- if and (gt $totalTranslators 1) (lt (add $translatorIndex 2) $totalTranslators) -}},&#32;
  {{ end -}}
  {{ if eq $totalTranslators (add $translatorIndex 2) -}}&#32;&amp;&#32;{{ end -}}{{/* Last name has ampersand */}}
  {{- end -}}
  {{- else -}}{{/* Fallback if no translators are specified */}}
  {{- end -}}
{{- end -}}{{/* END translator */}}

In the book type after title add:

{{- if isset . "translator" -}}&#32;(<span itemprop="translator">{{- template "translatorPart" . -}}</span>){{- end -}}

Semantics of schema.org locationCreated vs contentLocation

Greetings,

What is your understanding of schema.org's locationCreated vs contentLocation. In the current release of Hugo-Cite contentLocation is used for the location of the publisher. I suspect that this is errant. I think the better choice is locationCreated, given the definitions of the terms on schema. org. Would you agree?

See:

https://schema.org/contentLocation
https://schema.org/locationCreated
These terms are used in the schema.org metadata around the publisher's location in references. Semantically the assertion could be richer. That is, the location value is really the location of the publisher's office, which would be a property location but type address might need to be invoked first. See my upcoming example for Thesis/dissertation. #30

Missing publisher location in book type

Greetings,

I was looking at the book templage in APA6th and it seems that the template is missing the publisher-place. (even the example posted at the top of the apa-template.html page includes the publisher-place). The code correctly outputs it to schema.org metadata, but then fails to output the data to the screen. The relevant line of code is

hugo-cite/layouts/partials/bibliography/apa-style.html

Line 150 in 3fb8de5

code

  {{ if isset . "publisher-place" -}}
  <meta itemprop="locationCreated"
        value="{{- echoParam . "publisher-place" -}}">
  {{- end -}}
  {{- with .publisher -}}&#32;
  <span itemprop="publisher"
             itemtype="http://schema.org/Organization"
             itemscope>
    <span itemprop="name">
      {{- . -}}
    </span></span>.
  {{- end }}

error in schema.org metadata for datePublished

greetings,

I am going through the apa-style.html document and notice that the date format in the itemprop element for datePublished does not conform to what schema.org requires. https://schema.org/datePublished can only take two types of content: Date and DateTime, both require dates formatted in ISO 8601. This is visually incompatabile with what APA (6th or 7th) calls for. So I suggest moving the datePublished metadata from a span tag to a meta tag.

Code reference:

hugo-cite/layouts/partials/bibliography/apa-style.html

Line 89 in 021e37a

(<span itemprop="datePublished">

cite shortcode produces complete ref info for in-line citation

Hi @loup-brun! I'm excited about using this theme as an add on. I've done my best to follow your instructions, but I am seeing too much info appear when invoking the cite shortcode in a page. For example:

when it should just read "(Link & Sauer, 1998)". Have you seen this before? Perhaps I am missing something embarrassingly simple. I'd be happy to share the Hugo site itself if necessary. Thanks in advance!

Integrate the <cite> element for extra semantics

It works !

Thank you for your module ! It works !
(no issue for me)

Hugo server does not reflect changes to bibliography templates

When files in layouts/partials/bibliography/ are changed, they are not reflected live on the site (hugo serve must be restarted).

This is mainly related in dev.

JSON+LD vs microdata for schema.org

I'm just looking over how schema.org metadata is implemented. I'm wondering if It makes more sense to implement schema.org as blocks of JSON+LD instead of as inline microdata. I don't really have an opinion one way or another, I'm just wondering about the maintainability of the code, the readability, and if someone wanted to use the apa style as a template does the microdata implementation make sense?
My understanding is that JSON+LD is google's prefered method, while microdata is bing's prefered method. (though I haven't looked at this in a while. Also I don't know what impact inserting a bunch of blocks of JSON+LD has. That is should they be in someway combined into one block or is there absolutely no reason to combine them.

see: https://stackoverflow.com/a/30205733
and: https://webmasters.stackexchange.com/questions/122836/can-we-add-multiple-schema-org-json-ld-code-blocks-to-the-home-page-of-a-website
and: https://stackoverflow.com/questions/30723531/best-json-ld-practices-using-multiple-script-elements

What thoughts do you have about this?

Is it possible to display only references with a specific keyword in the biblio.json file ?

for example : {{< bibliography keyword:"metaphor" >}}

Bug in recent two author fix

Greetings @antoinentl & @loup-brun,

I just implemented the fix accepted and mentioned here 511d138

I agree that the pattern shown in #35 for two authors is not a good pattern, in fact it is not APA 6th compliant. But worse I think is that it totally breaks display for cases with three authors. take a look at my screen shot, where I have changed the & al. to et al.

For reference on what APA 6th calls for in in-line citations here is their reference chart.

Multiple citations

Love the look of your citation style! However, I have a lot of "combined" references, where I want to cite multiple sources. In LaTeX this is done using \cite{paper1,paper2}. Is there an option to also do this with the cite shortcode?

Connecting the Schema.org parts...

I had a musing and passing thought about which maybe someone else has a better idea for implementing than I do. It has to do with how declared schema.org entities are related. By way of example consider my example page.

When I validate my page:
https://hughandbecky.us/Hugh-CV/talk/2019-archives-features-without-a-business-plan/

in the schema.org validator: https://validator.schema.org/#url=https%3A%2F%2Fhughandbecky.us%2FHugh-CV%2Ftalk%2F2019-archives-features-without-a-business-plan%2F

The content does not make a single graph. Each piece is there and it is shown in the validator, but the schema.org vocabulary could declare how the things are connected. I'm at a loss on how to do this or if there are technical challenges due to the setup of hugo-cite and how it engages with other themes. One assumption we might be able to make is about the presence of the @id property. That is, we could say that each item referenced in the bibliographies is "cited" by the page and make the page ID the URL. This might work in my set-up but does it work more generally?

Markdown citation syntax

Hi,

is there any way to make this work with the Markdown citation syntax [@citekey] ?
Any pointers would be appreciated!

Thanks

APA 6th template for Blog Posts

I had a case where I wanted to add BlogPosts in my bibliographies. I copied the article format and modified it according to APA 6th edn formatting. I used the examples here: https://aus.libguides.com/apa/apa-blog and from Zotero for reference. I added the following code to the apa-style.html file. I'm still confused about what the data-type="" attribute is as I don't see it used on schema.org examples. — but I did change it to blog from article. I left the volume and issue numbers in. They could be pulled out/cleaned up.

{{/* -------------------- BEGIN BLOGPOST TYPE -------------------- */}}
{{- else if eq .type "post-weblog" -}}
<span itemscope
      itemtype="https://schema.org/BlogPosting"
      data-type="blog">
  {{- template "authorPart" . }}
  &#32;
  {{- template "issuedPart" . }}.
  &#32;
  {{- if .title -}}
  <span itemprop="name">
    {{- .title | markdownify -}}
  </span>
  {{- end -}}
{{- if isset . "genre" -}}<span itemprop="genre">&nbsp;[{{- echoParam . "genre" -}}]</span>
    {{- end -}}.&nbsp;

  {{- if isset . "container-title" -}}
  {{- if .editor -}}{{/* Add `In` before name of Eds. and title*/}}
  &#32;{{- i18n "apa_in" | default "In" -}}&#32;
  {{- template "editorPart" . }} (Eds.),&#32;
  {{- end -}}

<span itemprop="isPartOf">
    {{- echoParam . "container-title" -}}</span>
    {{- if isset . "volume" -}}
    ,&#32;{{- .volume -}}
    {{- end -}}
    {{- if isset . "issue" }}({{ .issue }})
    {{- end -}}
.{{- end -}}
  {{- if isset . "page" -}}
  &#32;<span itemprop="pagination">{{ replace .page "-" "–" }}</span>.
  {{- end -}}
  {{- template "DOIPart" . -}}
</span>
{{/* -------------------- END BLOGPOST TYPE -------------------- */}}

Make it a Hugo module

People should be able to use it easily. This would ease the install phase.

See https://gohugo.io/hugo-modules/

Error with editor format

I found an error with the formatting of editors' names. Editors, in APA 6th edn when they are listed for a book in the format below have the name order F. Last-name. The current template has this backwards as Last-name F.

Example from APA book:

Haybron, D. M. (2008). Philosophy and the science of subjective well-being. In M. Eid & R. J. Larsen (Eds.), The science of subjective well-being (pp. 17-43). New York, NY: Guilford Press.

However, there is a slight complication with the the way the template is currently set up because, editors when they take the place of the author (the whole book is referenced) are presented just like authors, such as in the example below:

Koch, S. (Ed.). (1959-1963). Psychology: A study of science (Vols. 1-6). New York, NY: McGraw-Hill.

My solution is two fold:

to copy the current editor template, rename the copy bookeditor and bookeditorPart. And then redirect the editor template called in the case of books:

hugo-cite/layouts/partials/bibliography/apa-style.html

Line 129 in bd36e7f

{{- template "editorPart" . -}}

(this solution still needs to have  (Eds.). added after the template is called... actually this (Ed.). / (Eds.). needs to be context dependent on singular plural.
I corrected the code used for all other cases of editors and make it available here:

{{/* BEGIN editor */}}
{{- define "editorPart" }}
  {{- $editors := .editor }}
  {{- if $editors -}}
  {{- $totalEditors := len $editors -}}
  {{- range $editorIndex, $editor := $editors -}}
  <span itemprop="editor" itemscope itemtype="https://schema.org/Person">
  {{- with $editor.given -}}&#32;
    <meta itemprop="givenName" content="{{ . }}" />
    {{ substr . 0 1 }}.&#32;
    {{- end -}}{{/* First letter (initial). */}}
    {{- with $editor.secondInitial -}}
    <meta itemprop="additionalName" content="{{ . }}" />
    {{- substr . 0 1 -}}.&#32;{{- end -}}
    {{- with $editor.family -}}
    <span itemprop="familyName">{{ . }}</span>
    {{- end -}}
  </span>
  {{- if and (gt $totalEditors 1) (lt (add $editorIndex 2) $totalEditors) -}},&#32;
  {{ end -}}
  {{ if eq $totalEditors (add $editorIndex 2) -}}&#32;&amp;&#32;{{ end -}}{{/* Last name has ampersand */}}
  {{- end -}}
  {{- end -}}
{{- end -}}{{/* END editor */}}

Add option to cite only year, i.e. suppress author

Add option to render only the year of the APA in-text citation, e.g. if the author’s name is already mentioned in the text:

Bruno Latour (2014)

rather than:

Bruno Latour (Latour, 2014)

Include Editors

Include the list of Editors in an article or book.

Multi-fire pop-over

Greetings,

I recently published a post where when one in-text citation is hovered over, the others also automatically show up... I'm pulling my hair out (what little is left ;-) ) trying to debug this.

Here is the post in question: https://hughandbecky.us/Hugh-CV/post/olac-subject-terms/
Here is another post rendered at the same time where the issue does not happen: https://hughandbecky.us/Hugh-CV/post/linguistic-literature-growth-rate/

I can make the JSON and the markdown available on request. But I'm wondering if anyone has seen this sort of error before and knows what it might be... Also not the change in font size in the inline citation... that is just happening. So something is being triggered and I'm not sure what it is (I looked at the JSON, ran it through a validator and it looks fine). Any pointers are appreciated.

The part that I think is challenging is that it is only happening on that specific page.

Clash with wowchemy cite.html shortcode - document how to solve that?

There is a cite.html shortcode in the wowchemy-hugo-themes (https://github.com/wowchemy/wowchemy-hugo-themes/blob/main/wowchemy/layouts/shortcodes/cite.html). In my setup, that masked the hugo-cite version, which took a while to troubleshoot. I am still not sure what the best action to take would be - for now, I deleted the unneeded cite.html, but it might come back with future updates.

Probably the only thing that can be done about that is to add a warning/hint to the installation instructions?

Prepare a release flow

Commit tagged releases to master with their respective changes.

Implement Git flow, with semver-like releases.

Update screenshot (demo)

In-text citation: add coma separator for author-date

CSL and multiple styles

If I wanted to contribute another style how would this project enable a site designer to pick between the styles?
CSL is in XML. Hugo has no capacity to read XML. Have you thought about any possibilities of converting the CSL.xml files to say something like CSV or JSON so they can be used in hugo? I'm brain storming and trying to figure out how this might work.

I used: https://www.convertjson.com/xml-to-json.htm to convert the APA csl.xml file to json from XML https://www.zotero.org/styles/apa-5th-edition

this would essentially make all the CSL variables "available" in JOSN, then we would just need to process these into Hugo or a defined html?

Allow to specify custom prefix or suffix

Thanks for this great module.

I find myself quite frequently wanting to add a prefix - for instance (reviewed in Miller, 2020) - or a suffix - for instance (Miller, 2020, Table 3) - to a citation. Could that be supported?

(I would also be happy with a solution that lets me link a custom text with a specific reference if that is easier to implement - that would give the user the possibility to customize individual citations as needed ...)

Add preview (or screenshot) in README

Show off what this is about. 💅⭐️

APA 6th template for Reports

Greetings,

I worked out the template for reports. Three notes:

I could send these over as PRs but I don't want to clog the PR flow if there is no intent of using them, or they will be rejected. further instruction is needed in this regard.
In contrast to my previous template for Thesis works #30 I created a template for if archive metadata is present in the CSL. this is referenced just like the authorPart and DOIpart templates. and is included below
Issue #26 points out that corporate authors are not handled by the authorPart. Many Reports have Institutional authors. So many reports are going to show "no author" until the authorPart is revised.

{{/* BEGIN ArchivalID */}}
{{- define "ArchivalID" }}
{{ if isset . "archive" -}}&#32; Available from <meta itemprop="Organization" itemtype="http://schema.org/Organization"
             itemscope><span itemprop="name">{{- echoParam . "archive" -}}</span>.&#32; ({{- if isset . "archive_location" -}}{{- echoParam . "archive_location" -}}{{- end }}</span>)</span>.
  {{- end -}}
{{- end }}
{{/* END ArchivalID */}}

{{/* -------------------- BEGIN REPORT TYPE -------------------- */}}
{{- else if eq .type "report" -}}
<span itemscope
      itemtype="https://schema.org/Report"
      data-type="report">
  {{- template "authorPart" . }}
  &#32;
  {{- template "issuedPart" . }}.
  &#32;
  {{- if .title -}}
  <span itemprop="name">
    <i>{{- .title | markdownify -}}</i>
  </span>
  {{- end -}}
{{- if isset . "number" -}}<span itemprop="reportNumber">&nbsp;({{- echoParam . "number" -}})</span>
    {{- end -}}.&nbsp;
{{ if isset . "publisher-place" -}}
  <meta itemprop="contentLocation"
        value="{{- echoParam . "publisher-place" -}}">
  {{- end -}}
  {{- with .publisher -}}
  <span itemprop="Organization"
             itemtype="http://schema.org/Organization"
             itemscope>
    <span itemprop="name">
      {{- . -}}{{- end -}}
    </span> {{ if isset . "publisher-place" -}}:&#32; <span itemprop="location">{{- echoParam . "publisher-place" -}}</span></span>.
  {{- end }}
  {{- template "ArchivalID" . -}}
  {{- template "DOIPart" . -}}
</span>
{{/* -------------------- END REPORT TYPE -------------------- */}}

Publish bib.json file used for the bibliography demo

Could you please publish the bib.json file that you have used in this demo: https://labs.loupbrun.ca/hugo-cite/demo/

Thanks :)

Missing space...

It seems in book portions that there is a space missing after the "In" and the editor's name. consider the screenshot provided. Maybe that is normal and expected. I'm not used to APA. But also notice that the abbreviation for editor is plural. when it should be singular.

Name_spacing

Greetings,

I'm encountering an issue as i use the hugo theme wowchemy. That particular theme has a short code called cite. So there is a conflict when both themes are used together. as I want my site to use hugo-cite I have moved it to be referenced as the first theme. However, it is my understanding that hugo-cite is designed to be the secondary theme. As such, I am wondering if it might be good to name space the short codes. As much as name-spacing is ugly, I don't know of another way to not conflict with other themes. One proposal is to use eth ð as a namespace element ð_ eth is pretty much exotic everywhere except in Iceland and the Faroe Islands... though another option would be to use the two rune version of å which would confound everyone including the Scandinavians.

Using Hugo-cite inside a short code?

I have a simple shortcode that parses a CSV file into a table. One of the columns in that CSV/Table are references. I am struggling to use the cite shortcode inside of the custom csv_table shortcode. I tried including cite as a partial, but that was unsuccessful. Has anyone used cite inside of another shortcode?

How to update?

Add instructions to README on how to update via Git.
If downloading from ZIP, it's a matter of removing the themes/hugo-cite folder and replacing with a fresh download + extraction.

Most likely:

cd themes/hugo-cite
git pull

APA 6th template for Thesis/Dissertation

Greetings,
I worked through how to format dissertations and thesis documents in APA6th. Here is my contribution. It may need cleaned up but it outputs correctly from CSL-JSON.

{{/* -------------------- BEGIN DEGREE WORK TYPE -------------------- */}}
{{- else if eq .type "thesis" -}}
<span itemscope
      itemtype="https://schema.org/Thesis"
      data-type="thesis">
  {{- template "authorPart" . }}
  &#32;
  {{- template "issuedPart" . }}.
  &#32;
  {{- if .title -}}
  <span itemprop="name">
    <i>{{- .title | markdownify -}}</i>
  </span>
  {{- end -}}
{{- if isset . "genre" -}}<span itemprop="inSupportOf">&nbsp;({{- echoParam . "genre" -}})</span>
    {{- end -}}.&#32;
{{- if isset . "publisher-place" -}}
  <meta itemprop="locationCreated"
        value="{{- echoParam . "publisher-place" -}}">
  {{- end -}}
  {{- with .publisher -}}
  <span itemprop="publisher"
             itemtype="http://schema.org/EducationalOrganization"
             itemscope>
    <span itemprop="name">{{- . -}}{{- end -}}
    </span>{{ if isset . "publisher-place" -}},&#32; <span itemprop="location">{{- echoParam . "publisher-place" -}}</span></span>.
  {{- end }}
  {{- template "ArchivalID" . -}}
  {{- template "DOIPart" . -}}
</span>
{{/* -------------------- END DEGREE WORK TYPE -------------------- */}}

the below code was moved to the archivalID template

{{ if isset . "archive" -}}&#32; Available from <meta itemprop="Organization" itemtype="http://schema.org/Organization"
             itemscope><span itemprop="name">{{- echoParam . "archive" -}}</span>.&#32; ({{- if isset . "archive_location" -}}{{- echoParam . "archive_location" -}}{{- end }}</span>)</span>.
  {{- end }}

APA: 6th vs 7th edition

As outlined recently in #38 and #35, there are significant differences between APA 6th edition and APA 7th edition. It would be a good thing to decide whether we chose one or the other, or offer both (!!) as in apa6 / apa7.

error messages

When using {{< bibliography >}} and the bib.json file can not be found the site render fails. But there is no output to the terminal saying where or why the problem exists. errorf using https://gohugo.io/functions/errorf/ might save some users down the road.
Currently I get the following error. A more helpful error might include which leaf-bundle was trying to be processed and that hugo-cite couldn't find a bibliography JSON file.

Building sites … ERROR 2020/09/24 09:31:35 Failed to get JSON resource "": read /home/user_dir/Sites/Hugo/Hugo5(wip)/academic-kickstart: is a directory
Built in 1811 ms
Error: Error building site: logged 1 error(s)```

Open source documentation site

Open source the documentation site.

In this repo? (~~exampleSite~~ docs?)
Elsewhere?

Add localized terms

Add possibility for the user to bring translation strings, default to english.

Suppress reference title

Hey @loup-brun, this is a stellar module! I was wondering if there's an easy way to suppress printing the "title" of each reference. For instance, on rendering {{< cite "link1998estimating" >}} with {{< bibliography cited >}}, I see:

Link & Sauer (1998)
Link, W. & Sauer, J. (1998). Estimating population change from count data: Application to the north american breeding bird survey. Ecological applications, 8(2). 258–268.

Is there any way to silence the bold-face Link & Sauer (1998)? I think all I actually need is just the citation....

Bibliography list does not respect custom styles

The context $.Site is not available in the following lines:

hugo-cite/layouts/partials/bibliography/bibliography-list.html

Lines 23 to 24 in ca42411

    
           {{- if $.Site.Params.citationStyle }} 
        
           {{- $citationStyle = $.Site.Params.citationStyle }}

This is because only $.references was passed as a context to this template:

hugo-cite/layouts/shortcodes/bibliography.html

Lines 99 to 100 in ca42411

    
           {{- $bibParams := dict "references" $references }} 
        
           {{- partial "bibliography/bibliography-list.html" $bibParams }}

An easy fix is to add another key in the context dictionary:

{{- $bibParams := dict "references" $references "Site" $.Site }}

literal value in CLS-JSON

When citing a publication with a corporate author CSL adds a "literal" value to the author field. Hugo-Cite goes blank here. The solution is to make the authorPart more robust so that it deals with these situations.

  {"id":"international_organization_for_standardization_iso_iso_2007","author":[{"literal":"International Organization for Standardization (ISO)"}],"collection-title":"as amended through 2020 by the ISO 639-3 registrar, SIL International","event-place":"Geneva, Switzerland","issued":{"date-parts":[[2007]]},"language":"en","publisher":"International Standards Organization","publisher-place":"Geneva, Switzerland","title":"ISO 639-3:2007 : Codes for the representation of names of languages -- Part 3: Alpha-3 code for comprehensive coverage of languages","type":"book","URL":"https://www.iso.org/standard/39534.html"}

Differentiate the point paginations (p. 10) from the passages (pp. 10-15)

Actually hugo-cite, and in particular the shortcodes cite.html, is set up for the passages between one page to another indicated with a double "pp". But we need to cite with just a page indicated with a single "p".

For the implementation we can use the indication of the -.

	{{- if $.Site.Params.citationStyle }}
	{{- $citationStyle = $.Site.Params.citationStyle }}

	{{- $bibParams := dict "references" $references }}
	{{- partial "bibliography/bibliography-list.html" $bibParams }}

loup-brun / hugo-cite Goto Github PK

hugo-cite's Introduction

loup-brun

hugo-cite's People

Contributors

Stargazers

Watchers

Forkers

hugo-cite's Issues

Recommend Projects

Recommend Topics

Recommend Org