serhii.net

ERROR: TypeError: title.trim is not a function quarto

happens for me when in front-matter I do

---
# title: "Publications and Awards"
title: {\{< var test >}}

instead of QUOTED

---
# title: "Publications and Awards"
title: "{\{< var test >}}"

ALSO, interestingly, when I save the wrong version while previewing the error is better:

ERROR: Validation of YAML front matter failed.
ERROR: In file publications.qmd
(line 3, columns 8--24) Field "title" has value {\{< var test >}}, which must insteadbe a string
2: # title: "Publications and Awards"
3: title: {\{< var test >}}
         ~~~~~~~~~~~~~~~~~
4: css: ./posts_publications/pub_style.css
✖ The value {\{< var test >}} is of type object.
ℹ The error happened in location title.

ERROR: Render failed due to invalid YAML.

So: quarto errors are more detailed when previewing instead of when compiling from zero? Interesting. Okay.

• No native support

• R package exists, but I don’t feel like digging into R at all: Renders a Multilingual Quarto Book • babelquarto

• The other approaches I found are all based on project profiles and conditional output

  • oooo12 - Multi-language Blog with Quarto - Guide
  • Mario Angst - A multi-language (German/ English) Quarto website
    • only difference is that it’s /de/ /en/ instead of ENG being /en/
    • nice and more detailed about interesting corner cases

• Document Language – Quarto¹ for setting one language in the page and doing per-language changes to the template texts

  • quarto-cli/src/resources/language at main · quarto-dev/quarto-cli
  • quarto-cli/src/resources/language/_language.yml at main · quarto-dev/quarto-cli

• Conditional Content – Quarto

• Project Profiles – Quarto

Config files

_quarto-profilename.yml ONLY, the rest won’t get parsed

profile:
  default: en
  # mutually exclusive group: you can do only one
  # (otherwise `--profile one,two` does multiple)
  group: 
    - [en, de, uk]

Page content

# `unless-profile` exists as well
::: {.content-visible when-profile="en"}
This content will only appear in the advanced version.
:::

Links

Links are going to be interesting!

Currently /de is German, / is English.

Main home page is .. from DE lang, or /de from EN.

Menu items:

• ENG as-is. (`href: whatever.qmd)
• DEU: href: ../de/lehre.html — note the HTML bit!

But when previewing DEU, all of these pages are at / — ergo menu items don’t work, as they lead to a non-existing ../de/...

ALSO: marioangst.de shows nicely how one can link to other languages from the menu!

- icon: book
href: publications.qmd
text: Publikationen
- href: ../en/blog
text: Blog (englisch)

Site language

Website Options – Quarto tells me I can do this in each _quarto-de.yml etc. profile:

format:
  html:
    lang: de
	#lang: ua
	#lang: en

This changes the interface to follow the corresponding quarto-cli/src/resources/language/_language.yml at main · quarto-dev/quarto-cli

Unsolved

How do I change front matter (e.g. title)?

Not dealt with in any of the approaches: quarto’s native Document Language¹ thing

So: - How do I do different post titles per language? - How do I change site language, so _languages.yml, conditionally?

• Project Basics – Quarto discusses the various approaches to metadata

  • And I can conditionally include stuff

• … I could literally do a bash script that puts a _metadata.yaml, builds with a proflie, then removes that file. Oh this would be painful

• Skimming Website Options – Quarto doesn’t really help

  • except that I can set html format lang: de from within profiles! NICE

Do variables magic

• title gets taken from variable title[currnet-profile-name] or something?
• _variables.yml works for var shortcodes (240619-1845 Quarto error title.trim() is not a function), and shortcodes can do metadata too

# works
title-en: "Publications and Awards"
title: "{\{< meta title-en >}}"

If only I could do per-language attributes as shown in the docu²:

language:
  en:
    title-block-published: "Updated"
  fr:
    title-block-published: "Mis à jour"

It would be so cool if one could overwrite the other variables

language:
  de: 
    title: german post title

The above would nicely get a language from the profile _quarto-lang.yml and automatically change the things. Can I do this for titles and front-matter?

• I’m not alone:
  • Is there a way to insert variables in other shortcodes with Quarto? - Stack Overflow

I can get the current profile from the env variable

profile: {\{< env QUARTO_PROFILE >}}

If I could just

title: vars['titles']['postname'][QUARTO_PROFILE]

• Asked this on Github: How do I do conditional YAML frontmatter, e.g. based on profile? · quarto-dev/quarto-cli · Discussion #10064
  • Mea culpa, discussed already: Conditional metada for different profiles on a website · Issue #4516 · quarto-dev/quarto-cli Conditional metada for different profiles on a website · quarto-dev/quarto-cli · Discussion #4455 no idea how I missed this.

Use scripts

• Project Scripts – Quarto
  • A python script that sets title based on QUARTO_PROFILE

Quarto lua filters

OK let’s do this. No choice.

Learn Lua in Y Minutes

First³ attempt to write anything in lua:

function Meta(m)
  local profiles = quarto.project.profile
  local profile = profiles[1]
  if profile then
    print("Profile: " .. profile)
    m.active_profile = profile
  end

  if profile and m.titles and m.titles[profile] then
    cleantitle = pandoc.utils.stringify(m.titles[profile])
    oldtitle = pandoc.utils.stringify(m.title)
    m.title = cleantitle
    print("Profile:" .. profile)
    print("Old title:" .. oldtitle)
    print("New title:" .. cleantitle)
  end

  return m
end

I’d need to make it more robust:

• multiple profiles? Not now
• No titles set in titles — use the default one

So:

• Always require a title
• Optionally add array of titles, indexed by language=profile name
• If present use one of these.

function Meta(m)
  local profiles = quarto.project.profile
  if not profiles then
    -- TODO: missing YAML key? Empty YAML key?..
    -- TODO even more later: filter multiple profiles to use the language one
    return m
  end

  local profile = profiles[1]
  -- If we have a named profile, save it, otherwise return
  if profile then
    print("Profile: " .. profile)
    m.active_profile = profile
  else
    return m
  end

  if m.titles then
    local titles = m.titles
    if titles[profile] then
      newtitle = pandoc.utils.stringify(titles[profile])
      oldtitle = pandoc.utils.stringify(m.title)
      -- log both if they differ
      if newtitle ~= oldtitle then
        m.title = newtitle
        -- print("Old title:" .. oldtitle)
        -- print("New title:" .. newtitle)
        print(oldtitle .. " => " .. newtitle)
      end
    else
      print("Title for profile " .. profile .. " not found among ")
      for lang, title in pairs(titles) do -- Table iteration.
        print("    " .. lang .. ": " .. pandoc.utils.stringify(title))
      end
    end
  end

  return m
end

Main problems:

• listing pages use the old title anyway
• supports only title, not e.g. description (used, again, in listings)
  • and side menus!

All from javascript - How can I comment the EJS code (JS node) without getting an error - Stack Overflow:

// Neat multiline comment thing
<%if(false) {%>  
  <!-- single row of inline icons for pdf. etc instead of buttons -->
<%} %>

// hard to grep for and no syntax highlight, so maybea adding COMMENT works as my bad idea
<%if(false) {%>  
  <!-- COMMENT 
	single row of inline icons for pdf. etc instead of buttons 
  -->

// Documentation says: 
<%# comment %> 


// Not documentation, multiline comment:
<%/* comment */%> 

I had issues putting HTML code w/ EJS snippets in the latter one, so iffalse it is. For nested things, SO suggests these (both bad imo):

<!--label for="<%#= user.id %>" style="background-color: <%#= user.color %>;"-->
<!--label for= <%#=`${user.id}` %> style= <%#=`background-color: ${user.color};`%> -->

Given: quarto website page with publications. Previously touched upon in the messy 240605-2055 Quarto website creation notes.

Anchor links in (quarto) markdown

This works:

[UNLP paper](publications.qmd#hamotskyi2024unlp)

Anchor targets

• Only correct solution: ¹ <a name="title"></a>
  • (markdown - How to link to a named anchor in Multimarkdown? - Stack Overflow says to use the name=, not id=, attribute, but this doesn’t work for me in quarto.)

Template

// Get anchor id somehow from paper path
<% let y= item.path.split('/'); y.pop(); let dirname = y.pop(); let citation_key = dirname.split('-').pop() %>

// Overwrite with paper front-matter if there's one
<% if (item.citation_key) { %> 
	<% citation_key = item.citation_key %>
<% } %>       

// Add to paper listing thing 
<a id="<%= citation_key %>"></a>

Old way with systemd

/etc/systemd/system/user-suspend@.service:

[Unit]
Description=Lock the screen
Before=sleep.target

[Service]
User=%I
Type=forking
Environment=DISPLAY=:0
ExecStart=/usr/bin/xlock -usefirst -echokeys -description -modelist swarm,starfish,mandelbrot,polyominoes,fadeplot,matrix,lisa,life3d,life1d,kumppa,grav,flow


[Install]
WantedBy=sleep.target 

To enable¹: sudo systemctl enable user-suspend@myusername.service

Arch wiki (Session lock - ArchWiki) omits @myusername which leads to this error:

Failed to enable unit: Destination unit sleep.target is a non-template unit.

Also: xlock (xlockmore) is neat, here’s a list of modes: XlockMore modes

(Also: XScreenSaver versus XLock)

Offtopic but cool: Cool, but obscure X11 tools

New way with xss-lock

Added this to qtile autostart:

xss-lock -- xlock -usefirst -echokeys -modelist qix,lisa & 

Also

Auto-lock after 300 seconds:

xset s on xset s 300

Also

xlock is insecure, which is why it’s absent from Ubuntu repos, but especially jarring when having an external monitor — on my install, it used to show the lock screen on the external monitor, but show a still image of the desktop and my open programs on the internal one. Damn.

xscreensaver ftw.

maim is supposed to be the “better scrot”¹

# screenshot and put into clipboard
 maim -s | xclip -selection clipboard -t image/png -i

In qtile you can’t do that, because | is a shell construct².

Solution: do it in a shell:

CommandSet(commands={
	#...
	"S/clipboard": "bash -c \"maim -s | xclip -selection clipboard -t image/png -i\"",

Added ddg’s backslash-feeling-lucky to qb search engines. Encoded the backslash as URI, it worked!

https://duckduckgo.com/?q=%5C{}

Full list:

c.url.searchengines = {
        'DEFAULT': 'https://search.brave.com/search?q={}',
        'b': 'https://search.brave.com/search?q={}',
        'g': 'https://google.com/search?q={}', 
        's': 'https://scholar.google.de/scholar?hl=de&as_sdt=0%2C5&q={}&btnG=', 
        'ddg': 'https://duckduckgo.com/?q={}', 
        'l': 'https://duckduckgo.com/?q=%5C{}', 
        'c': 'http://dict.cc/?s={}', 
        'y': 'https://youtube.com/results?search_query={}',
        'd': 'https://en.wiktionary.org/wiki/Special:Search?search={}',
        'w': 'https://en.wikipedia.org/wiki/Special:Search?search={}',
        'wa': 'http://wolframalpha.com/input?i={}', 
}

A minimal citation style(for grant proposals) – anton.cromba.ch

• Quarto – Document Language is related but different.

• R package for this, but R: ropensci-review-tools/babelquarto: Renders a Multilingual Quarto Project (Book or Website)

• Mario Angst - A multi-language (German/ English) Quarto website

  • Profiles + visible-when — all langs in one file, looks kinda ugly but why not…
  • Quarto – Project Profiles

• oooo12 - Multi-language Blog with Quarto - Guide profiles as well.

• Approach for now — write them in separate files, and optionally at some point include them in the visible-when option?..

quarto create project 

Listing pages

• Quarto – Document Listings
  • Quarto – Creating a Blog
• Dates are awkward: Quarto – Quarto Dates and Date Formatting

---
title: "Blog"
listing:
- id: test-l1
  contents: "blog_posts/*"
  sort: "date desc"
  type: table
  categories: true
- id: test-l2
  contents: "blog_posts/*"
  sort: "date desc"
  type: default
  categories: true
- id: test-l3
  contents: "blog_posts/*"
  sort: "date desc"
  type: grid
  categories: true
---

This will be a test listing page.


## Table listing
::: {#test-l1}
:::


## Default listing
::: {#test-l2}
:::


## Grid listing
::: {#test-l3}
:::

• Configs
  • each directory can have it’s own _metadata.yml with configs that will be applied to all files in that directory

Publications

To get something like Drew Dimmery - Research or our old wowchemy thingy some magic will be needed.

Doing

---
title: "Publications and Awards"
bibliography: "./publications/papers.bib"
nocite: |
  @*
---

results in a list in a certain CSL format, which is limited — no ways to link videos/slides/… etc.

So likely it’ll be yet another listings view, or how Drew Dimmery - Quarto for an Academic Website did it — papers to YAML with ALL the metadata, then python script (inside quarto qmds, first nice case I see for this!) to convert it into the on-screen form.

And if code — then maybe it’s a conveter package from wowchemy yaml thingy?

• Quarto – Custom Listings together with “listing from yaml” may help?.. - Supporting category like feature for listing authors (e.g. filter by author like categories) · Issue #6246 · quarto-dev/quarto-cli TL;DR complex tags work
  • EJS – Embedded JavaScript templates is used for templating — looks kinda similar to Hugo
  • Meghan Hall describes this and links to Quarto’s own listing templates: quarto-cli/src/resources/projects/website/listing/listing-table.ejs.md at main · quarto-dev/quarto-cli
  • (Quarto – Article Templates for the general thing)

OK, then:

• Concatenate all wowchemy publication files into one large yaml (one-time python thing?)
• do EJS template for it

(Alternatively — just use the dirs as-is and do no yaml)

Onwards

• Albert Rapp - The ultimate guide to starting a Quarto blog

  • cool tutorial about the basics, including:
    • many ways to use listings to create blogs, archive pages, etc. + per-directory options
    • layouts to create cool pages e.g. contacts
    • include-after-body footers
    • styling, incl. scss rules
    • page-layouts and complex reactive grids

• Quarto – Article Layout is my friend — columns, margins, overflows etc.

• Quarto – Page Layout

• Quarto – HTML Options

• Code/Other links text can be changed here: quarto-cli/src/resources/language/_language.yml at main · quarto-dev/quarto-cli

• Quarto glob syntax can do a lot: Quarto – Quarto Glob Syntax

• cool pic sources:

  • LoremFlickr: free placeholder images

• sample of including a style in the qmd: quarto-web/docs/gallery/index.qmd at main · quarto-dev/quarto-web

Creating a publications view

• This convets bibtex into directory+md: GetRD/academic-file-converter: 📚 Import Bibtex publications and Jupyter Notebook blog posts into your Markdown website or book. 将Bibtex转换为Markdown网站

• Hugo Blox template? hugo-blox-builder/modules/blox-bootstrap/layouts/publication/single.html at main · HugoBlox/hugo-blox-builder

  • all fields: hugo-blox-builder/modules/blox-bootstrap/archetypes/publication/index.md at main · HugoBlox/hugo-blox-builder

• Gallery example: https://github.com/quarto-dev/quarto-web/blob/main/docs/gallery/gallery.ejs

  • Ex. includes using quarto syntax w/ ::: in a template: quarto-web/ejs/links.ejs at main · quarto-dev/quarto-web

• Would be cool to have the format consistent with the existing quarto infra: quarto-web/docs/journals/authors.qmd at main · quarto-dev/quarto-web

• EJS

  • EJS – Embedded JavaScript templates
  • EJS — Embedded javascript tutorial | by Simuratli | May, 2024 | Level Up Coding:
  • Introduction to EJS: A Guide to Building Dynamic Web Applications - DEV Community

	<% for (let i = 0; i < item['authors'].length; i++) { %>
<%= item['authors'][i] %>,
    <% } %>

• Problem: full HTML templates don’t accept markdown bits: Markdown not parsed in listings with custom EJS · Issue #8756 · quarto-dev/quarto-cli

Changes in the paper mds

• Remove markdown from all existing paper md, HTML-only
• Remove “image” key
• date is publishing date of the paper, not of its page — publishDate doesn’t exist
• publicationType: maybe at some point change the int representation into str, as per latest hugo blocks behaviour
• doi: no URI
• publication: no In *journal*, just journal

This and only this will be supported:

title: 'Title'
authors:
  - TODO
  - TODO
date: '2010-10-20T00:00:00Z'
doi: 

# Publication name and optional abbreviated publication name.
publication: 'Proceedings of the World Congress on Engineering and Computer Science. Vol. 1'
publication_short: 'WCeCS 2010'

abstract: 'Long abstract'
links:
  - name: TODO Anthology
    url: https://aclanthology.org/L14-1240

url_pdf:
slides:
video:

tags:
  - paper-tag

EDIT: more fields here: hugo-blox-builder/modules/blox-bootstrap/archetypes/publication/index.md at main · HugoBlox/hugo-blox-builder

url_pdf:
url_code:
url_dataset:
url_poster:
url_source:
url_project:
url_slides:
url_video:

Process

Parsing date year

Datetime formatting / customization in ejs - Stack Overflow describes ways to do things with dates in EJS/JS

<%= new Date().getFullYear();%>

OK so I can use JS?

// Works
<%= new Date(item.date).getFullYear() %>

Iconify Icons

I can’t seem to use shortcodes inside html EJS (same as markdown problem I guess?)

But I can use the CSS (and ofc just download the PNG files)

Accessing file path to find its Bibtex

.. in a file inside same dir as paper markdown.

• Problem: no access to filename being rendered!

• item.filename is the name, not path. I can’t do “link to file in the same directory as the one being listed”

• Find the name of the current file being rendered in Quarto - General - Posit Community

• At some point you could use shortcodes in frontmatter: Variables in categories (in frontmatter) do not parse properly when categories is set to true in listing · Issue #5578 · quarto-dev/quarto-cli

  • metadata is the one in the listing page, not the page being listed :(

• [FR] New Lua utility function to access qmd input filename · Issue #2249 · quarto-dev/quarto-cli

  • mcanouil/quarto-lua-env: lua-env is an extension for Quarto to provide access to LUA objects as metadata.
  • extension to get access to some vars
  • works for not-frontmatter

• Just realized that for listings item.path (=location of page) is just what I need — I just need to change the last element

  • Split Path String - DEV Community for js path operations

Most horrible thing I’ve ever written but seems to work:

<%= item.path %><br>              
<% let x= item.path.split('/') %> 
<% x.pop() %>                     
<%- x.join('/') %>                
<%- x.join('/') %>/cite.bib       

// ---

<% let x= item.path.split('/'); x.pop(); let biburi =  x.join('/')+'/cite.bib' %>
<a href="<%- biburi %>">
	<%= biburi %>
</a>

(I should just do a lua filter or something at this point)

Anchors

Idea: link from elsewhere directly to the paper in papers

• Text fragments
  • not supported in firefox
  • could write a trivial style and use quarto’s mechanisms for citations but that doesn’t matter because not widely supported
• anchors
  • markdown - How to link to a named anchor in Multimarkdown? - Stack Overflow
  • completed with anchors, taken from dirname and optionally overwritten by a paper’s front-matter

Final system: described in 240618-1448 Quarto publications page and adding anchors