Skip to content

Bibliography#115

Open
baharmon wants to merge 2 commits into
OSGeo:mainfrom
baharmon:bibliography
Open

Bibliography#115
baharmon wants to merge 2 commits into
OSGeo:mainfrom
baharmon:bibliography

Conversation

@baharmon
Copy link
Copy Markdown
Contributor

@baharmon baharmon commented May 6, 2026

This pull request moves the citation style to the root directory, adds guidance on citations for contributors, adds references to my tutorials, and fixes a couple typographic errors.

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md

```yaml
bibliography: tutorial.bib
csl: ../../../acm.csl
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cwhite911, is this recommended practice, i.e., use relative paths?

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would prefer absolute path, I believe that should work, but didn't test.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@petrasovaa @veroandreo How about using a project relative path?
/acm.csl

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's what I was thinking, but I didn't test.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@petrasovaa I just tested and it failed. Unfortunately /acm.csl doesn't work as Quarto treats the current file as the working directory. Perhaps we could override this by setting execute-dir: project in _quarto.yml (see docs), but that might break things.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I tried to put in _quarto.yml and that seems to work.

...
format:
  html:
    theme: [pandoc, brand, theme.scss]
    toc: true
    toc-title: Table of Contents
    link-external-newwindow: true
    csl: acm.csl
...

Then you don't need to have it in the individual tutorials at all, it gets inherited.

Comment thread CONTRIBUTING.md Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants