Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

tools that facilitate sharing and publishing of already done research #2

Open
pskyhx opened this issue Oct 22, 2021 · 0 comments
Open
Labels
🥼 Documentation Back of house docs about researching and creating website 🧭 Information Not issues specific issues
Milestone

Comments

@pskyhx
Copy link
Contributor

pskyhx commented Oct 22, 2021

these are tools that interface existing research and collection of material with the internet

hugo

Note: The installed by default markdown processor includes syntax highlighting for bibtext code blocks. Syntax Highlighting

hugo cite

Hugo Cite:

that APA is currently the only style partially supported.

Hugo Cite currently supports (in beta) these types of publication:

  • book
  • book chapter
  • article (or journal article)
  • website

Asciidoctor

Bibliography :: Asciidoctor Docs

External Helper Asciidoctor

Third hemisphere theme

The only format supported is JSON, which must follow the CSL-JSON spec.

Create Bibliographies in Hugo with a shortcode:

Hugo can generate HTML content from JSON files, so all we need is a bibliography in this format. The Citation Style Language (CSL) is a modern bibliography format that is perfect for this purpose. .... The Third hemisphere theme contains three shortcodes to display information from the bibliography file

academic theme

Academic includes

Academic Admin CLI: An admin tool to import publications from BibTeX or import assets for an offline site

related is: wowchemy-hugo-themes the website builder for Hugo thread

Make it easier to cite references · Issue #830 · wowchemy/wowchemy-hugo-themes

Jaan Tollander de Balsch

Scientific Writing with Markdown | Jaan Tollander de Balsch

To help getting started, check out the Markdown-Templates GitHub repository, which demonstrates how to create documents in practice.

For creating a static website to write scientific content using Markdown, we recommend using Hugo with Wowchemy.

We write the front matter in YAML between two triple-minus lines --- as follows.

---
title: "Title"
date: \today
author: "Author"
bibliography: "bibliography.bib"
link-citations: true
urlcolor: "blue"
csl: "https://raw.githubusercontent.com/citation-style-language/styles/master/harvard-anglia-ruskin-university.csl"
---

The title, date, and author variables specify information for creating the title. The bibliography variable specifies the location of the bibliography file, link-citations toggles links to citations on and off, urlcolor defines the link color, and the csl variable defines the Citation Style Language. We can find examples of citation styles from Zotero styles and use them by either downloading them or referring directly to the URL of the raw CLS file in citation styles repository.

jaantollander/Markdown-Templates: Templates for creating scientific, academic and technical documents using Markdown and Pandoc that support equations, code blocks, citations, Unicode symbols and vector graphics

discussion threads

How can I manage a publication list in Hugo, preferrably from Bibtex file?

How can I manage a publication list in Hugo, preferrably from Bibtex file? - support - HUGO

suggests using mmarkdown/mmark: Mmark: a powerful markdown processor in Go geared towards the IETF as md processror which includes Citations and adding XML References:

Mmark uses the citation syntax from Pandoc: [@RFC2535], the citation can either be informative (default) or normative, this can be indicated by using the ? or ! modifier: [@!RFC2535] create a normative reference for RFC 2535. To suppress a citation use [@-RFC1000]. It will still add the citation to the references, but does not show up in the document as a citation. ... A bibliography section is created by default if a {backmatter} is given, but you can suppress it by using the command line flag -bibliography=false.

another solution:

I found a solution using pandoc and hugo which might be a workaround.

Given you have a markdown file (input.md 26) with citations as you use it in a typical Pandoc project. Citations are referenced like this.

lorem ipsum[@foobar_2013]

@foobar_2013 ist the key pointing to the bibtex entry in your bibliography file yourbiblio.bib.

  1. Run pandoc on this file like this:
    pandoc input.md -t markdown-citations -s --bibliography yourbiblio.bib --csl yourstyle.csl -o output.md
    This will create a markdown file with normal footnotes and expanded citations.

    lorem ipsum[^1]

  2. Copy the output.md 12 to content/post or where ever you want it, and run hugo server

You will recognize that the file output.md contains a list of publications, used for this text, at the end of the file. Put a headline in front of this list, something like # Bibliography. The footnotes are placed after this list at the very end of the file.

zotero

zotsite

plandes/zotsite - Export Zotero to a stand-alone web site

This generated website has the following features:

  • Easily access your papers, site snapshots, notes from a navigation tree.
  • Provides metadata from collections and attachments (i.e. referenes etc).
  • Display PDF papers and website snapshot (the latter as framed).
  • Search function dynamically narrows down the papers you're looking for.
  • Embed links to a specific collection, article, item, note etc.
  • Export only a portion of your collection with regular expressions using the collection name.
  • BetterBibtex integration.
  • Snazzy look and feel from the latest Bootstrap CSS/Javascript library.

Zot_Bib_Web (npm)

davidswelt/zot_bib_web: Create interactive web bibliographies based on Zotero collections

docs: Interactive web bibliographies with Zotero

This tool generates interactive web bibliographies based on one or more collections in a Zotero repository. Collections can be maintained by groups of people, using Zotero’s web interface or their desktop applications. ...

Zot_bib_web does not depend on any third-party web server. The generated bibliographies load quickly because they are stored as static files along with the rest of your website.

Mac users: See my issue to resolve python errors: ImportError: No module named pyzotero · Issue #17 · davidswelt/zot_bib_web

Zotero Translation Client

zotero/bib: Translation and bibliography management for ZoteroBib

implementation: ZoteroBib: Fast, free bibliography generator - MLA, APA, Chicago, Harvard citations

csl-to-markdown (rust/cargo)

Eonm/csl-to-markdown - Makes your Zotero's/Mendeley's bibliography export compatible with markdown

argenos/zotero-mdnotes - A Zotero plugin to export item metadata and notes as markdown files

combined with papis (python/pip3)

papis/papis - Powerful and highly extensible command-line based document and bibliography manager.

papis/papis-zotero - Zotero compatiblity scripts for papis

papis-html · papis/scripts

Create a simple searchable offline html site with your references

misc zotero

Zotero Documentation - Plugins for Zotero

Turning a Zotero bibliography into an online, browsable catalog – The Digital Orientalist

You can turn any collection of books and articles from Zotero into a website that is easy to search, accessible to anyone, and customize it the way you like. This approach also works if you are using Mendeley or Papers, or any other program that supports export to CSL-JSON, which stands for Citation Style Language JSON (and JSON is an acronym for JavaScript Object Notation, more on that later).

kerko

whiskyechobravo/kerko - A web application component that provides a faceted search interface for bibliographies managed with Zotero.

The combination of Kerko and Zotero gives you the best of both worlds: a rich but easy to use web interface for end-users of the bibliography, and a well-established and powerful bibliographic reference management tool for individuals or teams working on the bibliography's content.

Related: whiskyechobravo/kerkoapp: A web application that provides a faceted search interface for bibliographies managed with Zotero.

zotero misc (TBD)

manubot

video: Revolutionizing scholarly writing with Manubot: a foreshadow of the future - Daniel Himmelstein - YTPrivate (YouTube)

manubot/rootstock: Clone me to create your Manubot manuscript > Open collaborative writing with Manubot:

Manubot adopts the contribution workflow used by many large-scale open source software projects to enable collaborative authoring of scholarly manuscripts. With Manubot, manuscripts are written in Markdown and stored in a Git repository to precisely track changes over time. By hosting manuscript repositories publicly, such as on GitHub, multiple authors can simultaneously propose and review changes. A cloud service automatically evaluates proposed changes to catch errors. Publication with Manubot is continuous: When a manuscript’s source changes, the rendered outputs are rebuilt and republished to a webpage. Manubot automates bibliographic tasks by implementing citation by identifier, where users cite persistent identifiers (e.g. DOIs, PubMed IDs, ISBNs, URLs), whose metadata is then retrieved and converted to a user-specified style. Manubot modernizes publishing to align with the ideals of open science by making it transparent, reproducible, immediate, versioned, collaborative, and free of charge.

Manubot comes with several “plugins” that can be included in manuscripts exported as HTML. These plugins add special interactive features that enhance the user experience of viewing and reading manuscripts (Figure 3). For example, with the “tooltips” plugin enabled, when the user hovers over a link to a reference or figure, a preview of that item pops up above the link, along with controls to navigate between other mentions of that item elsewhere in the document. The build process can also accommodate different “themes”, which change the general aesthetics and appearance of the exported document (e.g. from a contemporary sans-serif style to a more traditional serif style). The architecture of the plugins and themes is designed to provide authors with enough flexibility to suit their particular needs and preferences.

jekyll

inukshuk/jekyll-scholar: jekyll extensions for the blogging scholar

a set of extensions to Jekyll, the awesome, blog aware, static site generator; it formats your bibliographies and reading lists for the web and gives your blog posts citation super-powers.

@pskyhx pskyhx added the 🧭 Information Not issues specific issues label Oct 22, 2021
@pskyhx pskyhx changed the title tools, addons and such regarding citations, bibliographies, websites. future: tools, addons and such regarding citations, bibliographies, websites. Oct 23, 2021
@pskyhx pskyhx added the 🥼 Documentation Back of house docs about researching and creating website label Oct 23, 2021
@pskyhx pskyhx changed the title future: tools, addons and such regarding citations, bibliographies, websites. tools that facilitate sharing and publishing of already done research Oct 23, 2021
@pskyhx pskyhx added this to the info milestone Nov 24, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
🥼 Documentation Back of house docs about researching and creating website 🧭 Information Not issues specific issues
Projects
None yet
Development

No branches or pull requests

1 participant