posts/13_quarto_blog_writing_guide/13_quarto_blog_writing_guide

[utterances-bot]

Albert Rapp - The ultimate guide to starting a Quarto blog

This blog post is an in-depth guide on how to start blogging with Quarto.

https://albert-rapp.de/posts/13_quarto_blog_writing_guide/13_quarto_blog_writing_guide.html

[EcoFin]

Albert, Very well done indeed. I have read any number of these, so I know what I am looking for; this is particularly efficient, complete and straightforward. I found the post after tripping across the html/css video, by the way. One thing that might be helpful is a short discussion of the file directory structure that quarto uses for different sorts of projects. Also, I don't think I would use utteranc.es. It was irritating to have to sign in to my github account just to send a note of thanks! Whether it might discourage others I don't know. Thanks again.

[AlbertRapp]

Thank you, Arthur. Glad that my guide helped you. Also, thank you for the hint about coming here after seeing the CSS video. I'll add a link in the video to this guide to make it easier to find. I'll also think about adding a different comment section.

[EcoFin]

Albert,

Glad to see that the utterance.es comments work! I have used your guide over the past two days to mock up a site of my own – making a few changes along the way. Your guide has been very helpful. I will investigate some other comment systems, although a lot of people seem to think that good old email, or pushing to Twitter, may be preferable. There seems to be an argument in favour of Commento, despite the fee. I don’t like Disqus. People reading your material likely are on github; not necessarily those who might read mine. I also like YARDS by the way, even though I mainly use python. Sometimes I get intro stats students to learn a bit of R, but I always tell them that it stood for “religion”. By the way, in English it is Resources (one “s”); two “s” ressources is French!

Best regards,

Arthur younger

From: AlbertRapp @.> Sent: Wednesday, August 10, 2022 3:40 PM To: AlbertRapp/blogComments @.> Cc: Arthur Younger @.>; Comment @.> Subject: Re: [AlbertRapp/blogComments] posts/13_quarto_blog_writing_guide/13_quarto_blog_writing_guide (Issue #7)

Thank you, Arthur. Glad that my guide helped you. Also, thank you for the hint about coming here after seeing the CSS video. I'll add a link in the video to this guide to make it easier to find. I'll also think about adding a different comment section.

— Reply to this email directly, view it on GitHub https://github.com/AlbertRapp/blogComments/issues/7#issuecomment-1211184720 , or unsubscribe https://github.com/notifications/unsubscribe-auth/AB3HOETYWUIE3VX34KNCWBTVYQAP7ANCNFSM55FYGXLQ . You are receiving this because you commented.Message ID: @.***>

[aghaynes]

Thanks for the comprehensive post! So much great info! I was wondering about renv... how do you handle the case where you need to update a package? It might then be that an old post using the older version of the package no longer functions correctly... post-level lockfiles somehow?

[AlbertRapp]

Thank you, Alan! Glad that you like this post.

As for {renv}, whenever I finish a blog post, I save a most recent snapshot of all the versions I use into a new lockfile with renv::snapshot(). Then, I copy that file to my new post's directory. Finally, in the first code chunk of my new blog posts chunk I include a renv::use() call and instruct this file to be rendered with the versions from the dedicated lock file. That way, each post gets its own version control. You can find the renv::use() code chunk in the text above.

Were my explanations in the blog post too imprecise? Hope my additional explanation helped. Let me know if I can help if something remained unclear.

[mphandejohn]

Dear Albert, Thank you for your thorough instructions. However I got stuck here "Now, we have to link to our new listing pages somewhere. I chose to link to my archive in the navbar (see _quarto.yml)." care to expand a little bit here, sorry I am new to this.

best regards, John

[AlbertRapp]

Hi John,

In the _quarto.yml file you can see that one every of the navbar was set with

navbar:
    right:
      - text: Blog
        href: blog.qmd

You can do the same for the archive. Just replace the text that you want to display, e.g. Blog -> Archive, and switch the hyperlink (href) to your newly created . qmd file. Does that help you?

[aghaynes]

As for {renv}, [...]

Were my explanations in the blog post too imprecise? Hope my additional explanation helped. Let me know if I can help if something remained unclear.

Hi Albert, thanks for clarifying... on a second read it's clear... thanks again!

[qowork]

Hi Albert, thanks how i can add embed code HTML or PHP, i have jotforms i need to add to my blog. regards

[kantel]

Ich wünschte, ich hätte diese Seiten gekannt, bevor ich meine eigenen Quarto-Versuche gestartet hatte. Sie hätten mir viele eigenen Experimente erspart. Aber ich habe auch jetzt noch viele Anregungen gefunden, von denen ich einige sicher in meinen Seiten noch einbauen werde. Danke dafür.

[AlbertRapp]

Hallo @kantel, freut mich, dass ich helfen konnte. Weiterhin viel Spaß mit Quarto :)

[mroberts1]

Hi Albert, I believe I followed the instructions correctly but when I render the website, from the landing page (the renamed about.qmd page), when I click on Blog I get the blog.qmd page (the renamed index.qmd page), but the new post that I created under /posts/first-post/first-post.qmd is not listed. I tried changing the name of first-post.qmd to index.qmd but the result is the same.

So I'm not sure why the listing of posts in the /posts directory doesn't appear on the blog.qmd page. The YAML for that file seems correct:

---

title: "sandbox" [the name of the blog] listing: contents: posts sort: "date desc" type: default categories: true sort-ui: false filter-ui: false page-layout: full title-block-banner: true

[helenajambor]

Nice write-up an +1 that perfectionism can be countered with the simple observation that essentially noone will read most posts.. with few exceptions such as this one!

(I blog for a while, only now start moving to quarto... )

[analytical]

What amazing post! Thanks Albert

[msh855]

I think it would be good to clarify how one case changes the defaults of a theme (e.g. fonts as you explained in your video) when there are two themes activated (light and dark). Thank you for the great post

[AliGunerMD]

great post again. Thanks Albert..

regarding using
renv::use(lockfile = "renv.lock") within the blogpost,

is it better idea to define the exact path like renv::use(lockfile = "content/blog/2023-11-19-newpostfolder/renv.lock") for future usages..

[DiabbZegpi]

This post has been great for me to start with a new hobbie! By the way, what is the configuration ta hides the content image in the list of blogs page?

[DiabbZegpi]

Can you elaborate more in how to set up beehiiv?

[martinsatt]

Thanks for this nice walkthrough.