nmfs-opensci / quarto_titlepages

A Quarto extension for making title and cover pages for PDF output.
https://nmfs-opensci.github.io/quarto_titlepages/
Creative Commons Zero v1.0 Universal
115 stars 20 forks source link

can't make `quarto_titlepages` work following the instructions #44

Closed jgunstone closed 10 months ago

jgunstone commented 11 months ago

I'm trying to run the examples in quarto_titlepages to check I understand how it works - when I run through the installation process and render on the command line I'm unable to reproduce the examples shown.

Steps to Reproduce

I did the following in a fresh Ubuntu2004 (and tried Ubuntu2204) install.

# running line by line
quarto --version
# > 1.3.450
mamba install -n quarto-test quarto  # create testing env
quarto install tinytex  # install latex: https://quarto.org/docs/output-formats/pdf-engine.html
mamba activate quarto-test 
quarto use template nmfs-opensci/quarto_titlepages
# prompt download ? > Y
# prompt give dir ? > nmfs-opensci/quarto_titlepages
cd nmfs-opensci/quarto_titlepages
quarto render example_1.qmd --to pdf

# > 
(quarto-tests) jovyan@PORT4028:~/nmfs-opensci/quarto_titlepages$ quarto render example_1.qmd --to pdf
pandoc
  to: latex
  output-file: example_1.tex
  standalone: true
  pdf-engine: xelatex
  variables:
    graphics: true
    tables: true
  default-image-extension: pdf

metadata
  documentclass: scrartcl
  classoption:
    - DIV=11
    - numbers=noendperiod
  papersize: letter
  header-includes:
    - '\KOMAoption{captions}{tableheading}'
  block-headings: true
  title: A Sample Title - The SocioEconomic Aspects of Stock Assessments
  subtitle: with non-English diacritics in the author names. See documentation.
  author:
    - name: Jane Doe
      affiliations:
        - name: Minnesota Department of Natural Resources
          address: '500 Lafayette Road Saint Paul, MN 55155'
        - name: University of Minnesota
          department: Department of Mathematics
    - name: Eva Nováková
      affiliations:
        - name: Czech University of Life Sciences
          address: 'Družstevní 666, Vikýřovice, Czechia'
    - name: Matti Meikäläinen
      email: matti@jy.fi
      affiliations:
        - name: University of Kemijärvi
          department: Department of Biological and Environmental Science
          address: 'Kylmäniementie 79, 98120, KEMIJÄRVI, Finland'
    - name: Ashok Kumar
      affiliations:
        - name: University of Minnesota
          department: Department of Mathematics
        - name: HØnefoss Institute
          address: 'R Tradição 35, Portugal 2950-726'
  bibliography:
    - references.bib

WARNING: Unable to resolve crossref @eq-eq2
running xelatex - 1
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode

running xelatex - 2
  This is XeTeX, Version 3.141592653-2.6-0.999995 (TeX Live 2023) (preloaded format=xelatex)
   restricted \write18 enabled.
  entering extended mode

Output created: example_1.pdf
(quarto-tests) jovyan@PORT4028:~/nmfs-opensci/quarto_titlepages$ quarto list tools
[✓] Inspecting tools

Tool         Status            Installed     Latest
chromium     Not installed     ---           869685
tinytex      Up to date        v2023.09      v2023.09

Does the bug relate to PDF output?

yes!

what it should look like: image

what it looked like for me! quarto render example_1.qmd --to pdf image

ppssphysics commented 10 months ago

I am running into the same issue, running on macOS Ventura 13.5.2 and quarto version 1.3.450. Followed the same steps as described by @jgunstone to compile the pdf but the formatting of the title page is inexistent in the output.

eeholmes-uw commented 10 months ago

Hi,

The correct command is

quarto render example_1.qmd --to titlepage-pdf

By using --to pdf, you are instructing Quatro to compile to a plain pdf format and to not use the titlepage-pdf format.

Regards,

Eli

ppssphysics commented 10 months ago

Thank you @eeholmes-uw, it works fine now. Thanks for taking the time to share the simple solution that explains many of my other issues with Quarto compilation.

jgunstone commented 10 months ago

thanks for the simple explanation and thanks for adding the note to the readme https://github.com/nmfs-opensci/quarto_titlepages/commit/ad9c0b1c8f8a9053610a899b56bcc28983e70c3f

will close now