diff --git a/content/posts/2023/using obsidian callouts with quarto.md b/content/posts/2023/2023-05-31 Using obsidian callouts with quarto.md
similarity index 100%
rename from content/posts/2023/using obsidian callouts with quarto.md
rename to content/posts/2023/2023-05-31 Using obsidian callouts with quarto.md
diff --git a/content/posts/2023/back to hugo.md b/content/posts/2023/2023-08-03 From Quarto with love.md
similarity index 100%
rename from content/posts/2023/back to hugo.md
rename to content/posts/2023/2023-08-03 From Quarto with love.md
diff --git a/content/posts/2023/pdf-quarto-tips.md b/content/posts/2023/2023-08-04 PDF tweaks and tips with Quarto.md
similarity index 100%
rename from content/posts/2023/pdf-quarto-tips.md
rename to content/posts/2023/2023-08-04 PDF tweaks and tips with Quarto.md
diff --git a/content/posts/2023/Awesome Zotero Plugins.md b/content/posts/2023/2023-08-15 Awesome Zotero Plugins.md
similarity index 100%
rename from content/posts/2023/Awesome Zotero Plugins.md
rename to content/posts/2023/2023-08-15 Awesome Zotero Plugins.md
diff --git a/content/drafts/learning-hugo.md b/content/posts/2024/drafts/learning-hugo.md
similarity index 90%
rename from content/drafts/learning-hugo.md
rename to content/posts/2024/drafts/learning-hugo.md
index 40e9ea9..3bc9e31 100644
--- a/content/drafts/learning-hugo.md
+++ b/content/posts/2024/drafts/learning-hugo.md
@@ -7,6 +7,12 @@ tags:
- Hugo
---
+### How to render blog with future
+
+`hugo server --buildFuture`
+
+### Tutorials
+
Great tutorials for beginners about deployment of your page with Hugo and github pages (this is how I doing with my blog) is here [Blogging with Hugo and GitHub Pages](https://carpentries-incubator.github.io/blogging-with-hugo-and-github-pages/aio/index.html)
Customization of the site
@@ -25,4 +31,7 @@ git submodule update --remote --merge
https://harrycresswell.com/writing/menus-in-hugo/
https://www.bram.us/2020/01/10/smooth-scrolling-sticky-scrollspy-navigation/
-https://ma.ttias.be/adding-a-sticky-table-of-contents-in-hugo-to-posts/
\ No newline at end of file
+https://ma.ttias.be/adding-a-sticky-table-of-contents-in-hugo-to-posts/
+
+
+v
\ No newline at end of file
diff --git a/public/2023/back-to-hugo/index.html b/public/2023/back-to-hugo/index.html
index 9aac378..fa52ed9 100644
--- a/public/2023/back-to-hugo/index.html
+++ b/public/2023/back-to-hugo/index.html
@@ -1,10 +1,10 @@
-
+
-
+
From Quarto with love (but back to Hugo) | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -32,11 +32,11 @@
-
+
-
-
+
+
@@ -56,7 +56,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/2023\/back-to-hugo\/"
+ "@id": "http:\/\/localhost:60341\/2023\/back-to-hugo\/"
},
"author" : {
"@type": "Person",
@@ -78,16 +78,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/2023\/back-to-hugo\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/2023\/back-to-hugo\/",
"wordCount" : "666",
"genre" : [ "Quarto" , "Hugo" , "Blogging" ],
"keywords" : [ "Quarto" , "Hugo" , "Blogging" ]
diff --git a/public/2023/obsidian-quarto-callouts/index.html b/public/2023/obsidian-quarto-callouts/index.html
index 38d488a..c8fe3eb 100644
--- a/public/2023/obsidian-quarto-callouts/index.html
+++ b/public/2023/obsidian-quarto-callouts/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Using Wikilinks and Git/Obsidian Callouts in Quarto Markdown | Daniel Borek
@@ -16,7 +16,7 @@
note warning important tip caution. Each type has a different color and icon. You can see examples in the Quarto documentation.
The Problem To use callouts in Quarto markdown (qmd) files, you need to use Pandoc’s div syntax:">
-
+
-
+
-
-
+
+
@@ -69,7 +69,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/2023\/obsidian-quarto-callouts\/"
+ "@id": "http:\/\/localhost:60341\/2023\/obsidian-quarto-callouts\/"
},
"author" : {
"@type": "Person",
@@ -91,16 +91,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/2023\/obsidian-quarto-callouts\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/2023\/obsidian-quarto-callouts\/",
"wordCount" : "566",
"genre" : [ "Quarto" , "Obsidian" , "Lua" , "CSS" ],
"keywords" : [ "Quarto" , "Obsidian" , "Lua" , "CSS" ]
diff --git a/public/2023/quarto-tips/index.html b/public/2023/quarto-tips/index.html
index 58c6405..cac732f 100644
--- a/public/2023/quarto-tips/index.html
+++ b/public/2023/quarto-tips/index.html
@@ -1,10 +1,10 @@
-
+
-
+
PDF tweaks and tips with Quarto | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -31,11 +31,11 @@
-
+
-
-
+
+
@@ -55,7 +55,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/2023\/quarto-tips\/"
+ "@id": "http:\/\/localhost:60341\/2023\/quarto-tips\/"
},
"author" : {
"@type": "Person",
@@ -77,16 +77,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/2023\/quarto-tips\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/2023\/quarto-tips\/",
"wordCount" : "791",
"genre" : [ "Quarto" , "Latex" ],
"keywords" : [ "Quarto" , "Latex" ]
diff --git a/public/2023/zotero-7/index.html b/public/2023/zotero-7/index.html
index d250b27..bae519d 100644
--- a/public/2023/zotero-7/index.html
+++ b/public/2023/zotero-7/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Zotero 7 is coming … | Daniel Borek
@@ -14,7 +14,7 @@
The latest stable, big release version, Zotero 6, was introduced in March 2022. It brought a new built-in PDF viewer and annotation system, as well as iOS and iPadOS apps.
Zotero 7 is Coming Recently, the devs shared a public beta of Zotero 7. Most of the updates are related to transitioning from the legacy Firefox 60 ESR, which Zotero was originally built on top of (Zotero started as a browser extension), to the newer Firefox 102 ESR now and Firefox 115 ESR before the release this year.">
-
+
-
+
-
-
+
+
@@ -61,7 +61,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/2023\/zotero-7\/"
+ "@id": "http:\/\/localhost:60341\/2023\/zotero-7\/"
},
"author" : {
"@type": "Person",
@@ -83,16 +83,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/2023\/zotero-7\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/2023\/zotero-7\/",
"wordCount" : "416",
"genre" : [ "Zotero" , "Academia" ],
"keywords" : [ "Zotero" , "Academia" ]
diff --git a/public/2024/zotero-rename-files/index.html b/public/2024/zotero-rename-files/index.html
index 2750cfb..d6b7b6f 100644
--- a/public/2024/zotero-rename-files/index.html
+++ b/public/2024/zotero-rename-files/index.html
@@ -1,10 +1,10 @@
-
+
-
+
How to autorename files using Zotero | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -31,11 +31,11 @@
-
+
-
-
+
+
@@ -55,7 +55,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/2024\/zotero-rename-files\/"
+ "@id": "http:\/\/localhost:60341\/2024\/zotero-rename-files\/"
},
"author" : {
"@type": "Person",
@@ -77,16 +77,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/2024\/zotero-rename-files\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/2024\/zotero-rename-files\/",
"wordCount" : "539",
"genre" : [ "Zotero" , "Bibliography" ],
"keywords" : [ "Zotero" , "Bibliography" ]
diff --git a/public/about/index.html b/public/about/index.html
index f06084c..001c93f 100644
--- a/public/about/index.html
+++ b/public/about/index.html
@@ -1,10 +1,10 @@
-
+
-
+
About | Daniel Borek
@@ -15,7 +15,7 @@
My doctoral research at Ghent University focuses on the spectral parametrization of neural oscillations. It applies my computational background to elucidate the brain’s rhythmic (and non-rhythmic) activity.
I’m leveraging my skills in statistical inference, data analysis, and visualization to understand the human brain.">
-
+
-
+
-
-
+
+
@@ -59,7 +59,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/about\/"
+ "@id": "http:\/\/localhost:1313\/about\/"
},
"author" : {
"@type": "Person",
@@ -81,16 +81,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:1313/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:1313\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/about\/",
+ "image": "http://localhost:1313/",
+ "url" : "http:\/\/localhost:1313\/about\/",
"wordCount" : "244",
"genre" : [ ],
"keywords" : [ ]
diff --git a/public/atom.xml b/public/atom.xml
index 819e488..fcc9816 100644
--- a/public/atom.xml
+++ b/public/atom.xml
@@ -3,49 +3,18 @@
Daniel BorekInstrumental reflexes
- http://localhost:62585/
+ http://localhost:60341/
enCopyright 2024, Daniel Borek
- Fri, 14 Jun 2024 01:00:00 -0700
+ Thu, 13 Jun 2024 00:00:00 +0000Hugo - gohugo.iohttp://cyber.harvard.edu/rss/rss.html
-
- Github Education Pack and other tips
- http://localhost:62585/2024/zotero-rename-files/
- <p>GitHub is a powerful platform (if you stayed on it after it was bought by Microsoft) that you can use for version control with Git and collaborative software/project development.</p>
-<p>Apart of its main purpose for managing and maintaining your projects, and many people are familiar with the basic functionalities of GitHub, there are several valuable features that even experienced users might overlook</p>
-<p>This is a bit trivial information but I know that are some people (mostly academic colleagues) who were using Github and for whom this information was new when I shared with them. The post will be updated if I will learn about features.</p>
-<h1 id="if-you-are-a-student-ask-for-the-github-education-pack">If You Are a Student, Ask for the GitHub Education Pack</h1>
-<p>If you’re a student, you can apply for the GitHub Student Developer Pack, which offers free access to various developer tools, resources, and services. Some of the best perks include access to Microsoft Copilot inside VSCode, a license for PyCharm Professional Edition (which supports some great features), and a year of a Namecheap domain.</p>
-<p>You also get a year of a free domain with a .me ending on Namecheap, a free 3-month individual subscription to DataCamp, and access to other perks. Some of these perks might not be as useful, but you may find something valuable, like computing credits on Azure and other services for machine learning. More details can be found here: <a href="https://education.github.com/pack">GitHub Education Pack</a></p>
-<p>When applying, if you encounter verification issues, you might find useful this comment from related <a href="https://github.com/orgs/community/discussions/61537">discussion</a> :</p>
-<blockquote>
-<p>You are unlikely to be verified until you have completed your GitHub user profile with your full name as it appears in your academic affiliation document, plus a short bio.</p>
-</blockquote>
-<p>Overall, having a good presence and short introduction on your profile is a good idea.</p>
-<p>Even after successful verification, you might need to wait up to 72hours, and in peak times like the start of the semester even longer.</p>
-<h1 id="use-favorites-for-easy-access-to-repositories">Use Favorites for Easy Access to Repositories</h1>
-<p>The staring a favorites repo is a pretty standard feature, but a new shiny beta feature is “lists,” which you can create and add repositories to when starring them. This is useful for creating low-effort, different collections.</p>
-<h1 id="be-notified-about-releases-of-specific-packages">Be Notified About Releases of Specific Packages</h1>
-<p>To stay updated on the latest releases of specific packages or repositories, you can “Watch” the repository. This is one of the badges on the top of the repository view. By default, the “Participation and mentions” option is active. When you choose “Custom,” you can select “Releases Only” to stay informed about the latest updates.</p>
-<h1 id="utilize-github-pages-for-hosting">Utilize GitHub Pages for Hosting</h1>
-<p>GitHub Pages allows you to host static websites directly from your repositories. This is an excellent way to showcase your projects, create documentation, or even host a personal blog. It’s free and integrates seamlessly with your GitHub workflow.</p>
-<p>For creating webpages you can use static site generators that use markdown.<br>
-Hugo and Jekyll are great for that (Hugo is really fast, i switched from Jekyll ), but if you work with code and often want to showcase you project notebooks as blogpost you might think about using Quarto for <a href="https://quarto.org/docs/websites/website-blog.html">blogging</a> .</p>
-<h2 id="open-github-repository-on-the-web-in-vscode">Open Github repository on the web in vscode</h2>
-<p>You can open your repository in the vscode in your browser replacing <code>github.com</code> by <code>vscode.dev</code>. It may be useful when you travel and have only access to your tablet et cetera.</p>
-
- dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2024/zotero-rename-files/
- Fri, 14 Jun 2024 01:00:00 -0700
-
-
How to autorename files using Zotero
- http://localhost:62585/2024/zotero-rename-files/
+ http://localhost:60341/2024/zotero-rename-files/
<p>After listening an episode of <code>PhD Life Coach</code> podcast (reccomeded to everyone relared to academia) on <a href="https://thephdlifecoach.buzzsprout.com/1992545/15220518-2-39-how-to-be-your-own-best-personal-assistant">How to be your own best personal assistant</a> Iearned that some academic people still spent their time on renaming pdfs downloaded from internet. I want to share an important message to those people :) :</p>
<ol>
<li>If you deal if structured articles (web, pdf) please use Reference Mangers, even if you don’t cite those articles that often; It will remove many of your headeaches and you can have nice organisation of your research materials</li>
@@ -69,13 +38,13 @@ Hugo and Jekyll are great for that (Hugo is really fast, i switched from Jekyll
<p>Even if you prefer have PDFs in the folders of your projects, you can always easily open folder conating the renamed files and move it to the project folder.</p>
dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2024/zotero-rename-files/
+ http://localhost:60341/2024/zotero-rename-files/Thu, 13 Jun 2024 00:00:00 +0000Zotero 7 is coming …
- http://localhost:62585/2023/zotero-7/
+ http://localhost:60341/2023/zotero-7/
<p><a href="https://www.zotero.org/">Zotero</a> is a free, open-source reference management software. It make the process of collecting and storing references pretty easy (sometimes too easy !).</p>
<p>The latest stable, big release version, Zotero 6, was introduced in March 2022. It brought a new built-in PDF viewer and annotation system, as well as iOS and iPadOS apps.</p>
<h2 id="zotero-7-is-coming">Zotero 7 is Coming</h2>
@@ -101,13 +70,13 @@ https://forums.zotero.org/discussion/90858/pdf-reader-and-zotero-open-pdf-links
<a href="https://github.com/erazlogo/zotero-markdown-translators">https://github.com/erazlogo/zotero-markdown-translators</a></p>
dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2023/zotero-7/
+ http://localhost:60341/2023/zotero-7/Tue, 15 Aug 2023 00:00:00 +0000PDF tweaks and tips with Quarto
- http://localhost:62585/2023/quarto-tips/
+ http://localhost:60341/2023/quarto-tips/
<p><em>Disclaimer: This is work in progress, I will be updating this post as I standardize and create a separate template/extension repository.</em></p>
<p>I wrote my master thesis in LaTeX, but given that markdown is a bit nicer to write, so I decided to switch with my PhD thesis to Markdown.<br>
I was trying with Pandoc but last year I switched to Quarto, as it is more flexible, and it is easier to customize.</p>
@@ -216,13 +185,13 @@ If you don’t use quarto, but you want to play with it, you can modify
</div>
dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2023/quarto-tips/
+ http://localhost:60341/2023/quarto-tips/Fri, 04 Aug 2023 00:00:00 +0000From Quarto with love (but back to Hugo)
- http://localhost:62585/2023/back-to-hugo/
+ http://localhost:60341/2023/back-to-hugo/
<p>I’ve been using different static site generators over the years - Jekyll, Hugo, and most recently Quarto. In this post I’ll share my experiences and how I’m now using Hugo and Quarto together for my blog.</p>
<h1 id="why-i-switched-back-to-hugo">Why I Switched back to Hugo</h1>
<p>I used Jekyll years ago (you can see one of the pages I created <a href="https://brainhackwarsaw2017.github.io/">here</a>), then switched to Hugo, and about a year ago I started using Quarto.</p>
@@ -315,13 +284,13 @@ I followed advice<sup id="fnref:1"><a href="#fn:1" clas
</div>
dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2023/back-to-hugo/
+ http://localhost:60341/2023/back-to-hugo/Thu, 03 Aug 2023 00:00:00 +0000Using Wikilinks and Git/Obsidian Callouts in Quarto Markdown
- http://localhost:62585/2023/obsidian-quarto-callouts/
+ http://localhost:60341/2023/obsidian-quarto-callouts/
<h1 id="about-callouts">About Callouts</h1>
<p><em>Disclaimer: Previous version of this post was originally published as a <a href="https://gist.github.com/danieltomasz/87b1321e23c045309d2571f525f856cf">public gist</a></em></p>
<p>Callouts are a great way to highlight important details in your text by adding boxes with icons. Many flavours of markdown support them (but might use different syntax).</p>
@@ -418,7 +387,7 @@ I followed advice<sup id="fnref:1"><a href="#fn:1" clas
<p>Let me know if you have any other questions!</p>
dtborek@gmail.com (Daniel Borek)
- http://localhost:62585/2023/obsidian-quarto-callouts/
+ http://localhost:60341/2023/obsidian-quarto-callouts/Wed, 31 May 2023 00:00:00 +0000
diff --git a/public/drafts/index.html b/public/drafts/index.html
index 23203b5..84af906 100644
--- a/public/drafts/index.html
+++ b/public/drafts/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Drafts | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
diff --git a/public/drafts/listened-to/index.html b/public/drafts/listened-to/index.html
index 14d64bc..a3b2625 100644
--- a/public/drafts/listened-to/index.html
+++ b/public/drafts/listened-to/index.html
@@ -1,10 +1,10 @@
-
+
-
+
| Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -26,11 +26,11 @@
-
+
-
-
+
+
@@ -50,7 +50,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/drafts\/listened-to\/"
+ "@id": "http:\/\/localhost:60341\/drafts\/listened-to\/"
},
"author" : {
"@type": "Person",
@@ -72,16 +72,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:60341/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/drafts\/listened-to\/",
+ "image": "http://localhost:60341/",
+ "url" : "http:\/\/localhost:60341\/drafts\/listened-to\/",
"wordCount" : "40",
"genre" : [ ],
"keywords" : [ ]
diff --git a/public/feed.json b/public/feed.json
index 1d01093..9cccf34 100644
--- a/public/feed.json
+++ b/public/feed.json
@@ -1,52 +1,35 @@
{
"version": "https://jsonfeed.org/version/1",
"title": "Daniel Borek",
- "home_page_url": "http://localhost:62585/",
- "feed_url": "http://localhost:62585//feed.json",
+ "home_page_url": "http://localhost:60341/",
+ "feed_url": "http://localhost:60341//feed.json",
"description": "Instrumental reflexes",
- "icon": "http://localhost:62585//assets/icon.png",
- "favicon": "http://localhost:62585//assets/favicon.ico",
+ "icon": "http://localhost:60341//assets/icon.png",
+ "favicon": "http://localhost:60341//assets/favicon.ico",
"expired": false,
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
},
"items": [
- {
- "id": "4280b7c7527fd5ebb202c41ba3e8ac230dec0555",
- "title": "Github Education Pack and other tips",
- "summary": "Autorenaming - another reason that Zotero is great",
- "content_text": "GitHub is a powerful platform (if you stayed on it after it was bought by Microsoft) that you can use for version control with Git and collaborative software/project development.\nApart of its main purpose for managing and maintaining your projects, and many people are familiar with the basic functionalities of GitHub, there are several valuable features that even experienced users might overlook\nThis is a bit trivial information but I know that are some people (mostly academic colleagues) who were using Github and for whom this information was new when I shared with them. The post will be updated if I will learn about features.\nIf You Are a Student, Ask for the GitHub Education Pack If you’re a student, you can apply for the GitHub Student Developer Pack, which offers free access to various developer tools, resources, and services. Some of the best perks include access to Microsoft Copilot inside VSCode, a license for PyCharm Professional Edition (which supports some great features), and a year of a Namecheap domain.\nYou also get a year of a free domain with a .me ending on Namecheap, a free 3-month individual subscription to DataCamp, and access to other perks. Some of these perks might not be as useful, but you may find something valuable, like computing credits on Azure and other services for machine learning. More details can be found here: GitHub Education Pack\nWhen applying, if you encounter verification issues, you might find useful this comment from related discussion :\nYou are unlikely to be verified until you have completed your GitHub user profile with your full name as it appears in your academic affiliation document, plus a short bio.\nOverall, having a good presence and short introduction on your profile is a good idea.\nEven after successful verification, you might need to wait up to 72hours, and in peak times like the start of the semester even longer.\nUse Favorites for Easy Access to Repositories The staring a favorites repo is a pretty standard feature, but a new shiny beta feature is “lists,” which you can create and add repositories to when starring them. This is useful for creating low-effort, different collections.\nBe Notified About Releases of Specific Packages To stay updated on the latest releases of specific packages or repositories, you can “Watch” the repository. This is one of the badges on the top of the repository view. By default, the “Participation and mentions” option is active. When you choose “Custom,” you can select “Releases Only” to stay informed about the latest updates.\nUtilize GitHub Pages for Hosting GitHub Pages allows you to host static websites directly from your repositories. This is an excellent way to showcase your projects, create documentation, or even host a personal blog. It’s free and integrates seamlessly with your GitHub workflow.\nFor creating webpages you can use static site generators that use markdown.\nHugo and Jekyll are great for that (Hugo is really fast, i switched from Jekyll ), but if you work with code and often want to showcase you project notebooks as blogpost you might think about using Quarto for blogging .\nOpen Github repository on the web in vscode You can open your repository in the vscode in your browser replacing github.com by vscode.dev. It may be useful when you travel and have only access to your tablet et cetera.\n",
- "content_html": "\u003cp\u003eGitHub is a powerful platform (if you stayed on it after it was bought by Microsoft) that you can use for version control with Git and collaborative software/project development.\u003c/p\u003e\n\u003cp\u003eApart of its main purpose for managing and maintaining your projects, and many people are familiar with the basic functionalities of GitHub, there are several valuable features that even experienced users might overlook\u003c/p\u003e\n\u003cp\u003eThis is a bit trivial information but I know that are some people (mostly academic colleagues) who were using Github and for whom this information was new when I shared with them. The post will be updated if I will learn about features.\u003c/p\u003e\n\u003ch1 id=\"if-you-are-a-student-ask-for-the-github-education-pack\"\u003eIf You Are a Student, Ask for the GitHub Education Pack\u003c/h1\u003e\n\u003cp\u003eIf you’re a student, you can apply for the GitHub Student Developer Pack, which offers free access to various developer tools, resources, and services. Some of the best perks include access to Microsoft Copilot inside VSCode, a license for PyCharm Professional Edition (which supports some great features), and a year of a Namecheap domain.\u003c/p\u003e\n\u003cp\u003eYou also get a year of a free domain with a .me ending on Namecheap, a free 3-month individual subscription to DataCamp, and access to other perks. Some of these perks might not be as useful, but you may find something valuable, like computing credits on Azure and other services for machine learning. More details can be found here: \u003ca href=\"https://education.github.com/pack\"\u003eGitHub Education Pack\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003eWhen applying, if you encounter verification issues, you might find useful this comment from related \u003ca href=\"https://github.com/orgs/community/discussions/61537\"\u003ediscussion\u003c/a\u003e :\u003c/p\u003e\n\u003cblockquote\u003e\n\u003cp\u003eYou are unlikely to be verified until you have completed your GitHub user profile with your full name as it appears in your academic affiliation document, plus a short bio.\u003c/p\u003e\n\u003c/blockquote\u003e\n\u003cp\u003eOverall, having a good presence and short introduction on your profile is a good idea.\u003c/p\u003e\n\u003cp\u003eEven after successful verification, you might need to wait up to 72hours, and in peak times like the start of the semester even longer.\u003c/p\u003e\n\u003ch1 id=\"use-favorites-for-easy-access-to-repositories\"\u003eUse Favorites for Easy Access to Repositories\u003c/h1\u003e\n\u003cp\u003eThe staring a favorites repo is a pretty standard feature, but a new shiny beta feature is “lists,” which you can create and add repositories to when starring them. This is useful for creating low-effort, different collections.\u003c/p\u003e\n\u003ch1 id=\"be-notified-about-releases-of-specific-packages\"\u003eBe Notified About Releases of Specific Packages\u003c/h1\u003e\n\u003cp\u003eTo stay updated on the latest releases of specific packages or repositories, you can “Watch” the repository. This is one of the badges on the top of the repository view. By default, the “Participation and mentions” option is active. When you choose “Custom,” you can select “Releases Only” to stay informed about the latest updates.\u003c/p\u003e\n\u003ch1 id=\"utilize-github-pages-for-hosting\"\u003eUtilize GitHub Pages for Hosting\u003c/h1\u003e\n\u003cp\u003eGitHub Pages allows you to host static websites directly from your repositories. This is an excellent way to showcase your projects, create documentation, or even host a personal blog. It’s free and integrates seamlessly with your GitHub workflow.\u003c/p\u003e\n\u003cp\u003eFor creating webpages you can use static site generators that use markdown.\u003cbr\u003e\nHugo and Jekyll are great for that (Hugo is really fast, i switched from Jekyll ), but if you work with code and often want to showcase you project notebooks as blogpost you might think about using Quarto for \u003ca href=\"https://quarto.org/docs/websites/website-blog.html\"\u003eblogging\u003c/a\u003e .\u003c/p\u003e\n\u003ch2 id=\"open-github-repository-on-the-web-in-vscode\"\u003eOpen Github repository on the web in vscode\u003c/h2\u003e\n\u003cp\u003eYou can open your repository in the vscode in your browser replacing \u003ccode\u003egithub.com\u003c/code\u003e by \u003ccode\u003evscode.dev\u003c/code\u003e. It may be useful when you travel and have only access to your tablet et cetera.\u003c/p\u003e\n",
- "url": "http://localhost:62585/2024/zotero-rename-files/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
- "date_published": "14066-14-09T60:1414:00-07:00",
- "date_modified": "14066-14-09T60:1414:00-07:00",
- "author": {
- "name": "Daniel Borek",
- "url": "http://localhost:62585/"
- }
- },
-
{
"id": "d87690e4d1e759df4dfe4e1249b278979983c5fd",
"title": "How to autorename files using Zotero",
"summary": "Autorenaming - another reason that Zotero is great",
"content_text": "After listening an episode of PhD Life Coach podcast (reccomeded to everyone relared to academia) on How to be your own best personal assistant Iearned that some academic people still spent their time on renaming pdfs downloaded from internet. I want to share an important message to those people :) :\nIf you deal if structured articles (web, pdf) please use Reference Mangers, even if you don\u0026rsquo;t cite those articles that often; It will remove many of your headeaches and you can have nice organisation of your research materials Even if you want to store PDFs inside specific projects a Reference Mangers can be really useful by automatic file renaming for you (you can move this files to another folder later). If you need to standardize the naming convention for all your PDF files or want to include specific metadata in the file names, Zotero or other reference mangers offers built-in functionalities and add-ons to achieve this efficiently. Here a quick tips how to rename files using Zotero.\nI am using Zotero 7 Beta (which offer nicer interface that Zotero 6 and some additional features like epub or webpages annotation, and is really stable and I hope will soon released as stable version) so my description might be slightly different from what people using previous version may sees .\nIn Zotero Go to Edit \u0026gt; Preferences (or Zotero \u0026gt; Preferences on a Mac). In the General tab, check the box • Automatically rename locally added files The \u0026lsquo;Rename linked files\u0026rsquo; will matter only the files added to Zotero items arent story with Zotero folder (where every bibliographic item has its own folder with the not so meaningful alphanumeric name ) but out outside of Zotero (when you move the file, you will broke the link )\nif you click Customize Filename Format… you can customize the format,.\nFor example using filename template\n{{ firstCreator suffix=\u0026quot; - \u0026quot; }}{{ year suffix=\u0026quot; - \u0026quot; }}{{ title truncate=\u0026quot;100\u0026quot; }} the resulting name will result in the filename similar to the one below:\nAljalal et al. - 2024 - Selecting EEG channels and features using multi-objective optimization for accurate MCI detection v.pdf\nOn the official documentation page you can find the options you can use explained in more depth file_renaming [Zotero Documentation]\nYou easily rename in bulk the files that you already downloaded and store in Zotero if for some reason you prefer to change the pattern in the future.\nZotero will add a great value to you ith its Browser Plugin Zotero Connector (which attomatical download and add pdf (if you have acces to it on publishers page) or snapshot of webpage to your local library ), and apperently this is not a comment knowledge, as prof. Inga Mewburn from [The Thesis Whisperer][thttps://thesiswhisperer.com/] blog and On the reg podcast recently admitted in one of the episosed that she learned about the connector after few years of using Zotero.\nIf you prefer to have linked files in one big folder, the Zotfile or other plugin that offer the same capabilities are something for you.\nEven if you prefer have PDFs in the folders of your projects, you can always easily open folder conating the renamed files and move it to the project folder.\n",
"content_html": "\u003cp\u003eAfter listening an episode of \u003ccode\u003ePhD Life Coach\u003c/code\u003e podcast (reccomeded to everyone relared to academia) on \u003ca href=\"https://thephdlifecoach.buzzsprout.com/1992545/15220518-2-39-how-to-be-your-own-best-personal-assistant\"\u003eHow to be your own best personal assistant\u003c/a\u003e Iearned that some academic people still spent their time on renaming pdfs downloaded from internet. I want to share an important message to those people :) :\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eIf you deal if structured articles (web, pdf) please use Reference Mangers, even if you don\u0026rsquo;t cite those articles that often; It will remove many of your headeaches and you can have nice organisation of your research materials\u003c/li\u003e\n\u003cli\u003eEven if you want to store PDFs inside specific projects a Reference Mangers can be really useful by automatic file renaming for you (you can move this files to another folder later). If you need to standardize the naming convention for all your PDF files or want to include specific metadata in the file names, Zotero or other reference mangers offers built-in functionalities and add-ons to achieve this efficiently.\u003c/li\u003e\n\u003c/ol\u003e\n\u003cp\u003eHere a quick tips how to rename files using Zotero.\u003c/p\u003e\n\u003cp\u003eI am using \u003ca href=\"https://www.zotero.org/support/beta_builds\"\u003eZotero 7 Beta\u003c/a\u003e (which offer nicer interface that \u003ca href=\"https://www.zotero.org/download/\"\u003eZotero 6\u003c/a\u003e and some additional features like epub or webpages annotation, and is really stable and I hope will soon released as stable version) so my description might be slightly different from what people using previous version may sees .\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eIn Zotero Go to Edit \u0026gt; Preferences (or Zotero \u0026gt; Preferences on a Mac).\u003c/li\u003e\n\u003cli\u003eIn the General tab, check the box •\u003ccode\u003e Automatically rename locally added files\u003c/code\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eThe \u0026lsquo;Rename linked files\u0026rsquo; will matter only the files added to Zotero items arent story with Zotero folder (where every bibliographic item has its own folder with the not so meaningful alphanumeric name ) but out outside of Zotero (when you move the file, you will broke the link )\u003c/p\u003e\n\u003cp\u003eif you click \u003ccode\u003eCustomize Filename Format…\u003c/code\u003e you can customize the format,.\u003c/p\u003e\n\u003cp\u003eFor example using filename template\u003cbr\u003e\n\u003ccode\u003e{{ firstCreator suffix=\u0026quot; - \u0026quot; }}{{ year suffix=\u0026quot; - \u0026quot; }}{{ title truncate=\u0026quot;100\u0026quot; }}\u003c/code\u003e the resulting name will result in the filename similar to the one below:\u003cbr\u003e\n\u003ccode\u003eAljalal et al. - 2024 - Selecting EEG channels and features using multi-objective optimization for accurate MCI detection v.pdf\u003c/code\u003e\u003c/p\u003e\n\u003cp\u003eOn the official documentation page you can find the options you can use explained in more depth \u003ca href=\"https://www.zotero.org/support/file_renaming\"\u003efile_renaming [Zotero Documentation]\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003eYou easily rename in bulk the files that you already downloaded and store in Zotero if for some reason you prefer to change the pattern in the future.\u003c/p\u003e\n\u003cp\u003eZotero will add a great value to you ith its Browser Plugin Zotero Connector (which attomatical download and add pdf (if you have acces to it on publishers page) or snapshot of webpage to your local library ), and apperently this is not a comment knowledge, as prof. Inga Mewburn from [The Thesis Whisperer][thttps://thesiswhisperer.com/] blog and On the reg podcast recently admitted in one of the episosed that she learned about the connector after few years of using Zotero.\u003c/p\u003e\n\u003cp\u003eIf you prefer to have linked files in one big folder, the Zotfile or other plugin that offer the same capabilities are something for you.\u003c/p\u003e\n\u003cp\u003eEven if you prefer have PDFs in the folders of your projects, you can always easily open folder conating the renamed files and move it to the project folder.\u003c/p\u003e\n",
- "url": "http://localhost:62585/2024/zotero-rename-files/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
+ "url": "http://localhost:60341/2024/zotero-rename-files/",
+ "image": "http://localhost:60341/photos/",
+ "banner_image": "http://localhost:60341/photos/",
"date_published": "13066-13-09T60:1313:00+00:00",
"date_modified": "13066-13-09T60:1313:00+00:00",
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
}
},
@@ -56,14 +39,14 @@
"summary": "",
"content_text": "Zotero is a free, open-source reference management software. It make the process of collecting and storing references pretty easy (sometimes too easy !).\nThe latest stable, big release version, Zotero 6, was introduced in March 2022. It brought a new built-in PDF viewer and annotation system, as well as iOS and iPadOS apps.\nZotero 7 is Coming Recently, the devs shared a public beta of Zotero 7. Most of the updates are related to transitioning from the legacy Firefox 60 ESR, which Zotero was originally built on top of (Zotero started as a browser extension), to the newer Firefox 102 ESR now and Firefox 115 ESR before the release this year.\nWhat\u0026rsquo;s exciting is the native support for Apple Silicon desktop devices and an even better reader, with EPUB support and web annotation. An Android app is also in development.\nPlugins I\u0026rsquo;m Using in Zotero 7 As an avid Zotero user, I\u0026rsquo;ve tested my fair share of plugins to optimize my workflow. While Zotero is great on its own, plugin take it to the next level for managing citations and references. Unfortunately with the changes to Zotero app, many plugins doesnt support beta yet. Below those I am using and are ported (or will be ported soon):\nGitHub - retorquere/zotero-open-pdf Since introduction of Zotero 6 users can opt to use new build-in PDF reader. I like the new new reader, but sometimes need to open the PDF in external PDF reader (PDF Expert in my case). This simple plugin lets you open PDF in external PDF reader via right click menu, instead of tedious opening in folder. Better BibTeX for Zotero :: Better BibTeX for Zotero.A must-have for LaTeX/Obsidian/Pandoc users like myself. Provide citekeys. Ported with much of work due to many changes in Zotero 7. GitHub - windingwind/zotero-pdf-preview: PDF Preview for Zotero. Enables live PDF miniature previews right in my Zotero item info pane so I can quickly confirm I have looking into right paper without open the item. Current changes to PDF Reader (Zotero 7 beta 29) broke it, it still doesn\u0026rsquo;t work as for the middle of August; GitHub - wshanks/Zutilo: Zotero plugin providing some additional editing features A nice collection of tools, still in the process of porting. While Zotero 7 has some additional compatible plugins I don\u0026rsquo;t use or haven\u0026rsquo;t tested, many of the best plugins remain available only for Zotero 6.\u0026quot;\nMarkdown translators Useful pair of Zotero translators when you want to link to Zotero item as Markdown link\nhttps://github.com/erazlogo/zotero-markdown-translators\n",
"content_html": "\u003cp\u003e\u003ca href=\"https://www.zotero.org/\"\u003eZotero\u003c/a\u003e is a free, open-source reference management software. It make the process of collecting and storing references pretty easy (sometimes too easy !).\u003c/p\u003e\n\u003cp\u003eThe latest stable, big release version, Zotero 6, was introduced in March 2022. It brought a new built-in PDF viewer and annotation system, as well as iOS and iPadOS apps.\u003c/p\u003e\n\u003ch2 id=\"zotero-7-is-coming\"\u003eZotero 7 is Coming\u003c/h2\u003e\n\u003cp\u003eRecently, the devs shared a public beta of Zotero 7. Most of the updates are related to transitioning from the legacy Firefox 60 ESR, which Zotero was originally built on top of (Zotero started as a browser extension), to the newer Firefox 102 ESR now and Firefox 115 ESR before the release this year.\u003c/p\u003e\n\u003cp\u003eWhat\u0026rsquo;s exciting is the native support for Apple Silicon desktop devices and an \u003ca href=\"https://forums.zotero.org/discussion/106716/available-for-beta-testing-updated-reader-with-epub-snapshot-support-and-new-annotation-types\"\u003eeven better reader, with EPUB support and web annotation\u003c/a\u003e. An Android app is also in development.\u003c/p\u003e\n\u003c!--Markdow export\nzotero://open-pdf/library/items/9WYPFUSR?page=9\n\nhttps://forums.zotero.org/discussion/90858/pdf-reader-and-zotero-open-pdf-links\n--\u003e\n\u003ch2 id=\"plugins-im-using-in-zotero-7\"\u003ePlugins I\u0026rsquo;m Using in Zotero 7\u003c/h2\u003e\n\u003cp\u003eAs an avid Zotero user, I\u0026rsquo;ve tested my fair share of plugins to optimize my workflow. While Zotero is great on its own, plugin take it to the next level for managing citations and references. Unfortunately with the changes to Zotero app, many plugins doesnt support beta yet. Below those I am using and are ported (or will be ported soon):\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/retorquere/zotero-open-pdf\"\u003eGitHub - retorquere/zotero-open-pdf\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003eSince introduction of Zotero 6 users can opt to use new build-in PDF reader. I like the new new reader, but sometimes need to open the PDF in external PDF reader (PDF Expert in my case). This simple plugin lets you open PDF in external PDF reader via right click menu, instead of tedious opening in folder.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://retorque.re/zotero-better-bibtex/\"\u003eBetter BibTeX for Zotero :: Better BibTeX for Zotero\u003c/a\u003e.A must-have for LaTeX/Obsidian/Pandoc users like myself. Provide citekeys. Ported with much of work due to many changes in Zotero 7.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/windingwind/zotero-pdf-preview\"\u003eGitHub - windingwind/zotero-pdf-preview: PDF Preview for Zotero.\u003c/a\u003e Enables live PDF miniature previews right in my Zotero item info pane so I can quickly confirm I have looking into right paper without open the item. Current changes to PDF Reader (Zotero 7 beta 29) broke it, it still doesn\u0026rsquo;t work as for the middle of August;\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://github.com/wshanks/Zutilo\"\u003eGitHub - wshanks/Zutilo: Zotero plugin providing some additional editing features\u003c/a\u003e A nice collection of tools, still in the process of porting.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eWhile Zotero 7 has some additional compatible plugins I don\u0026rsquo;t use or haven\u0026rsquo;t tested, many of the best plugins remain available only for Zotero 6.\u0026quot;\u003c/p\u003e\n\u003ch2 id=\"markdown-translators\"\u003eMarkdown translators\u003c/h2\u003e\n\u003cp\u003eUseful pair of Zotero translators when you want to link to Zotero item as Markdown link\u003cbr\u003e\n\u003ca href=\"https://github.com/erazlogo/zotero-markdown-translators\"\u003ehttps://github.com/erazlogo/zotero-markdown-translators\u003c/a\u003e\u003c/p\u003e\n",
- "url": "http://localhost:62585/2023/zotero-7/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
+ "url": "http://localhost:60341/2023/zotero-7/",
+ "image": "http://localhost:60341/photos/",
+ "banner_image": "http://localhost:60341/photos/",
"date_published": "15086-15-09T80:1515:00+00:00",
"date_modified": "15086-15-09T80:1515:00+00:00",
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
}
},
@@ -73,14 +56,14 @@
"summary": "Some tips and tricks for writing thesis with Quarto",
"content_text": "Disclaimer: This is work in progress, I will be updating this post as I standardize and create a separate template/extension repository.\nI wrote my master thesis in LaTeX, but given that markdown is a bit nicer to write, so I decided to switch with my PhD thesis to Markdown.\nI was trying with Pandoc but last year I switched to Quarto, as it is more flexible, and it is easier to customize.\nNicer Fonts and Better Handling of Figures I am sharing with you a fragment of my _quarto.yml file, with some tweaks I am using to make my PDF output nicer.\nformat: pdf: link-citations: true # \u0026lt;1\u0026gt; number-sections: false reference-section-title: \u0026#34;References\u0026#34; pdf-engine: xelatex include-in-header: text: | \\usepackage{epigraph} %% %% Code related to fonts and how the output looks %% \\usepackage{mathpazo} % \u0026lt;2\u0026gt; \\usepackage[T1]{fontenc} \\usepackage[sups,osf]{fbb} % osf (or tosf) for text, not math # \u0026lt;2\u0026gt; \\usepackage[scaled=.95]{cabin} % sans serif # \u0026lt;2\u0026gt; \\usepackage[varqu,varl]{inconsolata} % sans serif typewriter # \u0026lt;2\u0026gt; %% %% Code related to figures in document %% \\usepackage{float} % \u0026lt;3\u0026gt; \\graphicspath{{figures}{chapters/figures}{../figures}{chapters}} # \u0026lt;4\u0026gt; \\let\\origfigure\\figure \\let\\endorigfigure\\endfigure \\renewenvironment{figure}[1][2] { \\expandafter\\origfigure\\expandafter[H] } { \\endorigfigure } I put number as comments, so you can better understand specific lines.\nSome options for PDF output (more or less self-explanatory)\u0026gt; The font use by default template are ugly format, this look similar but are nicer. Forcing figures to be placed where they are in the text Allowing to use figures from different folders, and allowing to use relative paths to figures. Use Profiles to Compile either Whole Book or Thesis or Single Chapter Since quarto 1.2 profiles are introduced 1 In my use case I have on profile _quarto-thesis.yml which include all chapters and preambles, and another _quarto.yml which I can use just to compile the current markdown file; If I want to render whole thesis I just use quarto render --profile thesis; you could have as many as you want of those profiles (I was procrastinating that way with different look and templates for my thesis :slight_smile: )\nRoman Numbering for front Matter and Arabic for Main Matter I am inserting roman numbering for front matter and arabic for main matter.\nformat: pdf: include-before-body: text: | \\pagestyle{plain} \\pagenumbering{roman} In main tex I switch back to arabic numbering:\n\\pagenumbering{arabic} Problem with index.md and Inserted Blank Page As you write complex project, you want might want to have separate files for each chapter.\nWhen you are using quarto to render your project, you could put them inside index.md in your root folder:\n{{include \u0026#34;chapters/chapter1.qmd\u0026#34;}} {{include \u0026#34;chapters/chapter2.qmd\u0026#34;}} Using include filter will add the content of the files to the index.md file when compiling.\nThis is nice solution, but I have a problem when I want to use quarto preview to update and monitor resulting pdf when I change something in source files.\nUnfortunately, quarto preview does not update output .pdf file when files added with include change, so I needed to choose another solution.\nAlternative solution is to add chapters into you _quarto.yml file:\nproject: output-dir: _output execute-dir: file book: title: Title of my thesis or book author: name: Author Name chapters: - index.qmd - chapters/chapter1.md - chapters/chapter1.md I want to all of my content of to live in the \u0026lsquo;chapters\u0026rsquo; folder.\nUnfortunately currently in quatro users always need to include index.md (it makes sense when generating html as output, but not always when generating pdf).\nI can leave the index.md file empty, but then I will have an empty page between my table of content and first chapter.\nI can include the first chapter into index.md but then we were hitting the same problem on smaller scale again.\nMy Solution By default, latex is adding a page break after each chapter, and the index.md file is treated as a chapter, even if empty.\nAs a hack, I am hiding the problem by relaxing \\clearpage behaviour in latex.\nI am leaving my index.md file almost empty, I\u0026rsquo;m just adding this latex code 2:\n\\let\\standardclearpage\\clearpage \\let\\clearpage\\relax Then within my first chapter when my content start, I am returning to standard behaviour of \\clearpage:\n\\let\\clearpage\\standardclearpage This way I am not adding any extra page between my table of content and first chapter, and I can use quarto preview to monitor my changes.\nIn future the quatro behaviour might change regarding inclusion of `index.md``, you can follow discussion here:\nUseful Materials I just saw this post published on the blog of Cameron Patrick, it contains more useful information about writing thesis with quarto: https://cameronpatrick.com/post/2023/07/quarto-thesis-formatting/.\nI am personally using modified quarto-thesis template for my thesis, you can find it here: https://github.com/nmfs-opensci/quarto-thesis\nIf you don\u0026rsquo;t use quarto, but you want to play with it, you can modify it online on the Posit virtual Rstudio instance https://rstudio.cloud/content/4383755 (free account required)\nReferences Quarto - Project Profiles\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nhttps://tex.stackexchange.com/a/176109\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n",
"content_html": "\u003cp\u003e\u003cem\u003eDisclaimer: This is work in progress, I will be updating this post as I standardize and create a separate template/extension repository.\u003c/em\u003e\u003c/p\u003e\n\u003cp\u003eI wrote my master thesis in LaTeX, but given that markdown is a bit nicer to write, so I decided to switch with my PhD thesis to Markdown.\u003cbr\u003e\nI was trying with Pandoc but last year I switched to Quarto, as it is more flexible, and it is easier to customize.\u003c/p\u003e\n\u003ch1 id=\"nicer-fonts-and-better-handling-of-figures\"\u003eNicer Fonts and Better Handling of Figures\u003c/h1\u003e\n\u003cp\u003eI am sharing with you a fragment of my \u003ccode\u003e_quarto.yml\u003c/code\u003e file, with some tweaks I am using to make my PDF output nicer.\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yaml\" data-lang=\"yaml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eformat\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003epdf\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003elink-citations\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003etrue\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#998;font-style:italic\"\u003e# \u0026lt;1\u0026gt;\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003enumber-sections\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003efalse\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ereference-section-title\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#d14\"\u003e\u0026#34;References\u0026#34;\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003epdf-engine\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003exelatex\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003einclude-in-header\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003etext\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e|\u003cspan style=\"color:#d14\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage{epigraph} \n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %%\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %% Code related to fonts and how the output looks\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %%\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage{mathpazo} % \u0026lt;2\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage[T1]{fontenc}\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage[sups,osf]{fbb} % osf (or tosf) for text, not math # \u0026lt;2\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage[scaled=.95]{cabin} % sans serif # \u0026lt;2\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage[varqu,varl]{inconsolata} % sans serif typewriter # \u0026lt;2\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %%\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %% Code related to figures in document\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e %%\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\usepackage{float} % \u0026lt;3\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\graphicspath{{figures}{chapters/figures}{../figures}{chapters}} # \u0026lt;4\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\let\\origfigure\\figure\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\let\\endorigfigure\\endfigure\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\renewenvironment{figure}[1][2] {\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\expandafter\\origfigure\\expandafter[H]\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e } {\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\endorigfigure\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e }\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e \n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eI put number as comments, so you can better understand specific lines.\u003c/p\u003e\n\u003col\u003e\n\u003cli\u003eSome options for PDF output (more or less self-explanatory)\u0026gt;\u003c/li\u003e\n\u003cli\u003eThe font use by default template are ugly format, this look similar but are nicer.\u003c/li\u003e\n\u003cli\u003eForcing figures to be placed where they are in the text\u003c/li\u003e\n\u003cli\u003eAllowing to use figures from different folders, and allowing to use relative paths to figures.\u003c/li\u003e\n\u003c/ol\u003e\n\u003c!--Those are setting I am using to render a working preview of a chapter.\n The final version will be using a font provided by my university: --\u003e\n\u003ch1 id=\"use-profiles-to-compile-either-whole-book-or-thesis-or-single-chapter\"\u003eUse Profiles to Compile either Whole Book or Thesis or Single Chapter\u003c/h1\u003e\n\u003cp\u003eSince quarto 1.2 profiles are introduced \u003csup id=\"fnref:1\"\u003e\u003ca href=\"#fn:1\" class=\"footnote-ref\" role=\"doc-noteref\"\u003e1\u003c/a\u003e\u003c/sup\u003e In my use case I have on profile \u003ccode\u003e_quarto-thesis.yml\u003c/code\u003e which include all chapters and preambles, and another \u003ccode\u003e_quarto.yml\u003c/code\u003e which I can use just to compile the current markdown file; If I want to render whole thesis I just use \u003ccode\u003equarto render --profile thesis\u003c/code\u003e; you could have as many as you want of those profiles (I was procrastinating that way with different look and templates for my thesis :slight_smile: )\u003c/p\u003e\n\u003ch1 id=\"roman-numbering-for-front-matter-and-arabic-for-main-matter\"\u003eRoman Numbering for front Matter and Arabic for Main Matter\u003c/h1\u003e\n\u003cp\u003eI am inserting roman numbering for front matter and arabic for main matter.\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yaml\" data-lang=\"yaml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eformat\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003epdf\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003einclude-before-body\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003etext\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e|\u003cspan style=\"color:#d14\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\pagestyle{plain}\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#d14\"\u003e \\pagenumbering{roman}\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e \n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eIn main tex I switch back to arabic numbering:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-tex\" data-lang=\"tex\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\\pagenumbering\u003c/span\u003e\u003cspan style=\"color:#0086b3\"\u003e{\u003c/span\u003earabic\u003cspan style=\"color:#0086b3\"\u003e}\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003ch1 id=\"problem-with-_indexmd_-and-inserted-blank-page\"\u003eProblem with \u003cem\u003eindex.md\u003c/em\u003e and Inserted Blank Page\u003c/h1\u003e\n\u003cp\u003eAs you write complex project, you want might want to have separate files for each chapter.\u003cbr\u003e\nWhen you are using \u003ccode\u003equarto\u003c/code\u003e to render your project, you could put them inside \u003ccode\u003eindex.md\u003c/code\u003e in your root folder:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-markdown\" data-lang=\"markdown\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e{{include \u0026#34;chapters/chapter1.qmd\u0026#34;}}\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e{{include \u0026#34;chapters/chapter2.qmd\u0026#34;}}\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eUsing \u003ccode\u003einclude\u003c/code\u003e filter will add the content of the files to the \u003ccode\u003eindex.md\u003c/code\u003e file when compiling.\u003cbr\u003e\nThis is nice solution, but I have a problem when I want to use \u003ccode\u003equarto preview\u003c/code\u003e to update and monitor resulting pdf when I change something in source files.\u003cbr\u003e\nUnfortunately, \u003ccode\u003equarto preview\u003c/code\u003e does not update output \u003ccode\u003e.pdf\u003c/code\u003e file when files added with \u003ccode\u003einclude\u003c/code\u003e change, so I needed to choose another solution.\u003c/p\u003e\n\u003cp\u003eAlternative solution is to add chapters into you \u003ccode\u003e_quarto.yml\u003c/code\u003e file:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yaml\" data-lang=\"yaml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000080\"\u003eproject\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eoutput-dir\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e_output\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eexecute-dir\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003efile\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ebook\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003etitle\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003eTitle of my thesis or book\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eauthor\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ename\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003eAuthor Name\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003echapters\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e- index.qmd\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e- chapters/chapter1.md\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e- chapters/chapter1.md\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eI want to all of my content of to live in the \u0026lsquo;chapters\u0026rsquo; folder.\u003cbr\u003e\nUnfortunately currently in \u003ccode\u003equatro\u003c/code\u003e users always need to include \u003ccode\u003eindex.md\u003c/code\u003e (it makes sense when generating \u003ccode\u003ehtml\u003c/code\u003e as output, but not always when generating \u003ccode\u003epdf\u003c/code\u003e).\u003c/p\u003e\n\u003cp\u003eI can leave the \u003ccode\u003eindex.md\u003c/code\u003e file empty, but then I will have an empty page between my table of content and first chapter.\u003cbr\u003e\nI can include the first chapter into index.md but then we were hitting the same problem on smaller scale again.\u003c/p\u003e\n\u003ch2 id=\"my-solution\"\u003eMy Solution\u003c/h2\u003e\n\u003cp\u003eBy default, latex is adding a page break after each chapter, and the \u003ccode\u003eindex.md\u003c/code\u003e file is treated as a chapter, even if empty.\u003cbr\u003e\nAs a hack, I am hiding the problem by relaxing \u003ccode\u003e\\clearpage\u003c/code\u003e behaviour in latex.\u003c/p\u003e\n\u003cp\u003eI am leaving my \u003ccode\u003eindex.md\u003c/code\u003e file almost empty, I\u0026rsquo;m just adding this latex code \u003csup id=\"fnref:2\"\u003e\u003ca href=\"#fn:2\" class=\"footnote-ref\" role=\"doc-noteref\"\u003e2\u003c/a\u003e\u003c/sup\u003e:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-tex\" data-lang=\"tex\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\\let\\standardclearpage\\clearpage\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\\let\\clearpage\\relax\u003c/span\u003e \n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eThen within my first chapter when my content start, I am returning to standard behaviour of \u003ccode\u003e\\clearpage\u003c/code\u003e:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-tex\" data-lang=\"tex\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\\let\\clearpage\\standardclearpage\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eThis way I am not adding any extra page between my table of content and first chapter, and I can use \u003ccode\u003equarto preview\u003c/code\u003e to monitor my changes.\u003cbr\u003e\nIn future the \u003ccode\u003equatro\u003c/code\u003e behaviour might change regarding inclusion of `index.md``, you can follow discussion here:\u003c/p\u003e\n\u003ch1 id=\"useful-materials\"\u003eUseful Materials\u003c/h1\u003e\n\u003cp\u003eI just saw this post published on the blog of Cameron Patrick, it contains more useful information about writing thesis with \u003ccode\u003equarto\u003c/code\u003e: \u003ca href=\"https://cameronpatrick.com/post/2023/07/quarto-thesis-formatting/.\"\u003ehttps://cameronpatrick.com/post/2023/07/quarto-thesis-formatting/.\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003eI am personally using modified \u003ccode\u003equarto-thesis\u003c/code\u003e template for my thesis, you can find it here: \u003ca href=\"https://github.com/nmfs-opensci/quarto-thesis\"\u003ehttps://github.com/nmfs-opensci/quarto-thesis\u003c/a\u003e\u003cbr\u003e\nIf you don\u0026rsquo;t use quarto, but you want to play with it, you can modify it online on the Posit virtual \u003ccode\u003eRstudio\u003c/code\u003e instance \u003ca href=\"https://rstudio.cloud/content/4383755\"\u003ehttps://rstudio.cloud/content/4383755\u003c/a\u003e (free account required)\u003c/p\u003e\n\u003ch1 id=\"references\"\u003eReferences\u003c/h1\u003e\n\u003cdiv class=\"footnotes\" role=\"doc-endnotes\"\u003e\n\u003chr\u003e\n\u003col\u003e\n\u003cli id=\"fn:1\"\u003e\n\u003cp\u003e\u003ca href=\"https://quarto.org/docs/projects/profiles.html\"\u003eQuarto - Project Profiles\u003c/a\u003e\u0026#160;\u003ca href=\"#fnref:1\" class=\"footnote-backref\" role=\"doc-backlink\"\u003e\u0026#x21a9;\u0026#xfe0e;\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli id=\"fn:2\"\u003e\n\u003cp\u003e\u003ca href=\"https://tex.stackexchange.com/a/176109\"\u003ehttps://tex.stackexchange.com/a/176109\u003c/a\u003e\u0026#160;\u003ca href=\"#fnref:2\" class=\"footnote-backref\" role=\"doc-backlink\"\u003e\u0026#x21a9;\u0026#xfe0e;\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003c/div\u003e\n",
- "url": "http://localhost:62585/2023/quarto-tips/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
+ "url": "http://localhost:60341/2023/quarto-tips/",
+ "image": "http://localhost:60341/photos/",
+ "banner_image": "http://localhost:60341/photos/",
"date_published": "4086-04-09T80:44:00+00:00",
"date_modified": "4086-04-09T80:44:00+00:00",
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
}
},
@@ -90,14 +73,14 @@
"summary": "Why I switched from Quarto to Hugo - some thoughts on my blogging setup",
"content_text": "I\u0026rsquo;ve been using different static site generators over the years - Jekyll, Hugo, and most recently Quarto. In this post I\u0026rsquo;ll share my experiences and how I\u0026rsquo;m now using Hugo and Quarto together for my blog.\nWhy I Switched back to Hugo I used Jekyll years ago (you can see one of the pages I created here), then switched to Hugo, and about a year ago I started using Quarto.\nQuarto is great for scientific publishing, but I found it too limiting for a personal blog:\nEvery post must be in its own folder with an index.qmd file. This works well for showcasing content, but isn\u0026rsquo;t convenient for writing. As a scientific publishing tool, the blog features remain an afterthought. The Quarto team is great about adding features, but blog improvements happen slowly. So I decided to switch back to Hugo as my static site generator for the flexibility.\nFortunately, there\u0026rsquo;s no need to fully abandon Quarto. Quarto has built-in support for outputting to Hugo. I can use Quarto to render my posts written in qmd format into Markdown that Hugo can use.\nQuarto Loves Hugo Here is a quick overview of how I have Hugo and Quarto working together:\nI added some config settings to my Hugo config.toml file: ignoreFiles = [ \u0026#34;\\\\.qmd$\u0026#34;, \u0026#34;\\\\.ipynb$\u0026#34;, \u0026#34;\\\\.py$\u0026#34; ] [markup] defaultMarkdownHandler = \u0026#34;goldmark\u0026#34; [markup.goldmark.renderer] unsafe = true I have a content/posts folder containing subfolders for each post, with a index.qmd file inside.\nI put this _quarto.yml in the Hugo root directory:\nproject: type: hugo format: hugo-md: code-fold: true html-math-method: webtex execute: warning: false To create post written in qmd files, I run quarto render which outputs Markdown from my qmd posts into the Hugo content folder. I also found two nice blog posts from people using Quarto with Hugo:\n🪄 Quarto, Hugo, Apero | Cédric Batailler. Cédric is using lovely Apero theme. I am finding this theme great, but I choose to stick with minimalism of lines theme. Setting up a Hugo Website with Quarto | Paul Johnson. Paul is using a PaperMod theme, which is also very nice. He is a bit more technical in his post Paul Johnson describe how he render mermaid diagrams (supported in Quarto) in this blogpost. Customizing the Theme I started from the lines theme, you can find it here.\nLater I mixed it with another theme, simplist by the same author and I added my custom CSS parts.\nMore Customisation I started with the Lines theme, customised it with styles from the Simplist theme, and added some of my own CSS.\nHugo and GitHub Pages I followed Hugo\u0026rsquo;s GitHub Pages guide but ran into some issues:\nThe theme submodule wasn\u0026rsquo;t syncing properly. I had to manually add the .gitmodules file. The theme\u0026rsquo;s example content was cluttering my published site. I forked the theme and removed the examples. Here is my final .gitmodules file:\n[submodule \u0026#34;themes/lines\u0026#34;] path = \u0026#34;themes/lines\u0026#34; url = \u0026#34;https://github.com/danieltomasz/lines.git\u0026#34; Hugo and Code Highlighting To get code highlighting in backticks markdown fences I enabled:\npygmentsStyle = \u0026#34;pygments\u0026#34; pygmentsCodefences = true Adding Comments with giscus I followed various blogpost with the configuration advices.\nBy default, giscus is adding comments to every page, but I wanted to have comments only on my posts.\nI followed advice1 and I wrapped my addition of giscus partial into footer.html with if statement:\n{{ if not .Params.noComment }} {{ partial \u0026#34;giscus\u0026#34; . }} {{ end }} When I don\u0026rsquo;t want to include a comments block, I am adding this in the frontmatter of the post (yaml):\nnoComment: true Some other useful links: https://www.brycewray.com/posts/2022/05/tips-using-giscus/\nDate of Last Edit Directly from Github Some advice how to set up it: Add a Last Edited Date to Posts · Make with Hugo.\nOne caveat: setting enableGitInfo to true in your site’s configuration file sometimes is not enough2. You have to add --enableGitInfo to get .GitInfo:\nhugo serve --enableGitInfo How to disable comments in specific pages? - support - HUGO\u0026#160;\u0026#x21a9;\u0026#xfe0e;\nAdd git commit date as last update date in hugo page\u0026#160;\u0026#x21a9;\u0026#xfe0e;\n",
"content_html": "\u003cp\u003eI\u0026rsquo;ve been using different static site generators over the years - Jekyll, Hugo, and most recently Quarto. In this post I\u0026rsquo;ll share my experiences and how I\u0026rsquo;m now using Hugo and Quarto together for my blog.\u003c/p\u003e\n\u003ch1 id=\"why-i-switched-back-to-hugo\"\u003eWhy I Switched back to Hugo\u003c/h1\u003e\n\u003cp\u003eI used Jekyll years ago (you can see one of the pages I created \u003ca href=\"https://brainhackwarsaw2017.github.io/\"\u003ehere\u003c/a\u003e), then switched to Hugo, and about a year ago I started using Quarto.\u003c/p\u003e\n\u003cp\u003e\u003cstrong\u003eQuarto\u003c/strong\u003e is great for scientific publishing, but I found it too limiting for a personal blog:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eEvery post must be in its own folder with an \u003ccode\u003eindex.qmd\u003c/code\u003e file. This works well for showcasing content, but isn\u0026rsquo;t convenient for writing.\u003c/li\u003e\n\u003cli\u003eAs a scientific publishing tool, the blog features remain an afterthought. The Quarto team is great about adding features, but blog improvements happen slowly.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eSo I decided to switch back to \u003cstrong\u003eHugo\u003c/strong\u003e as my static site generator for the flexibility.\u003c/p\u003e\n\u003cp\u003eFortunately, there\u0026rsquo;s no need to fully abandon Quarto. \u003ca href=\"https://quarto.org/docs/output-formats/hugo.html\"\u003eQuarto has built-in support for outputting to Hugo\u003c/a\u003e. I can use Quarto to render my posts written in \u003ccode\u003eqmd\u003c/code\u003e format into Markdown that Hugo can use.\u003c/p\u003e\n\u003ch1 id=\"quarto-loves-hugo\"\u003eQuarto Loves Hugo\u003c/h1\u003e\n\u003cp\u003eHere is a quick overview of how I have Hugo and Quarto working together:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eI added some config settings to my Hugo \u003ccode\u003econfig.toml\u003c/code\u003e file:\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-toml\" data-lang=\"toml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003eignoreFiles = [ \u003cspan style=\"color:#d14\"\u003e\u0026#34;\\\\.qmd$\u0026#34;\u003c/span\u003e, \u003cspan style=\"color:#d14\"\u003e\u0026#34;\\\\.ipynb$\u0026#34;\u003c/span\u003e, \u003cspan style=\"color:#d14\"\u003e\u0026#34;\\\\.py$\u0026#34;\u003c/span\u003e ]\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e[markup]\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e defaultMarkdownHandler = \u003cspan style=\"color:#d14\"\u003e\u0026#34;goldmark\u0026#34;\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e [markup.goldmark.renderer]\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e unsafe = \u003cspan style=\"color:#000;font-weight:bold\"\u003etrue\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cul\u003e\n\u003cli\u003e\n\u003cp\u003eI have a \u003ccode\u003econtent/posts\u003c/code\u003e folder containing subfolders for each post, with a \u003ccode\u003eindex.qmd\u003c/code\u003e file inside.\u003c/p\u003e\n\u003c/li\u003e\n\u003cli\u003e\n\u003cp\u003eI put this \u003ccode\u003e_quarto.yml\u003c/code\u003e in the Hugo root directory:\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yaml\" data-lang=\"yaml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000080\"\u003eproject\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003etype\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003ehugo\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eformat\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ehugo-md\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ecode-fold\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003etrue\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ehtml-math-method\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003ewebtex\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003eexecute\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000080\"\u003ewarning\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003efalse\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cul\u003e\n\u003cli\u003eTo create post written in \u003ccode\u003eqmd\u003c/code\u003e files, I run \u003ccode\u003equarto render\u003c/code\u003e which outputs Markdown from my \u003ccode\u003eqmd\u003c/code\u003e posts into the Hugo content folder.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eI also found two nice blog posts from people using Quarto with Hugo:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003ca href=\"https://cedricbatailler.me/blog/2022-apero/\"\u003e🪄 Quarto, Hugo, Apero | Cédric Batailler\u003c/a\u003e. Cédric is using lovely Apero theme. I am finding this theme great, but I choose to stick with minimalism of lines theme.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"https://www.paulrjohnson.net/2022/09/setting-up-a-hugo-website-with-quarto/\"\u003eSetting up a Hugo Website with Quarto | Paul Johnson\u003c/a\u003e. Paul is using a PaperMod theme, which is also very nice. He is a bit more technical in his post\u003c/li\u003e\n\u003cli\u003ePaul Johnson describe how he render mermaid diagrams (supported in Quarto) in \u003ca href=\"https://www.paulrjohnson.net/2022/09/rendering-mermaid-diagrams-on-a-hugo-website-using-quarto/\"\u003ethis blogpost\u003c/a\u003e.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch1 id=\"customizing-the-theme\"\u003eCustomizing the Theme\u003c/h1\u003e\n\u003cp\u003eI started from the lines theme, you can find it \u003ca href=\"https://github.com/ronv/lines\"\u003ehere\u003c/a\u003e.\u003cbr\u003e\nLater I mixed it with another theme, \u003ca href=\"https://github.com/ronv/simplist\"\u003esimplist\u003c/a\u003e by the same author and I added my custom CSS parts.\u003c/p\u003e\n\u003ch1 id=\"more-customisation\"\u003eMore Customisation\u003c/h1\u003e\n\u003cp\u003eI started with the Lines theme, customised it with styles from the Simplist theme, and added some of my own CSS.\u003c/p\u003e\n\u003ch2 id=\"hugo-and-github-pages\"\u003eHugo and GitHub Pages\u003c/h2\u003e\n\u003cp\u003eI followed \u003ca href=\"https://gohugo.io/hosting-and-deployment/hosting-on-github/\"\u003eHugo\u0026rsquo;s GitHub Pages guide\u003c/a\u003e but ran into some issues:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eThe theme submodule wasn\u0026rsquo;t syncing properly. I had to manually add the \u003ccode\u003e.gitmodules\u003c/code\u003e file.\u003c/li\u003e\n\u003cli\u003eThe theme\u0026rsquo;s example content was cluttering my published site. I forked the theme and removed the examples.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eHere is my final \u003ccode\u003e.gitmodules\u003c/code\u003e file:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-toml\" data-lang=\"toml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e[submodule \u003cspan style=\"color:#d14\"\u003e\u0026#34;themes/lines\u0026#34;\u003c/span\u003e]\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e path = \u003cspan style=\"color:#d14\"\u003e\u0026#34;themes/lines\u0026#34;\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e url = \u003cspan style=\"color:#d14\"\u003e\u0026#34;https://github.com/danieltomasz/lines.git\u0026#34;\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003ch2 id=\"hugo-and-code-highlighting\"\u003eHugo and Code Highlighting\u003c/h2\u003e\n\u003cp\u003eTo get code highlighting in backticks markdown fences I enabled:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-toml\" data-lang=\"toml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003epygmentsStyle = \u003cspan style=\"color:#d14\"\u003e\u0026#34;pygments\u0026#34;\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003epygmentsCodefences = \u003cspan style=\"color:#000;font-weight:bold\"\u003etrue\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003ch2 id=\"adding-comments-with-giscus\"\u003eAdding Comments with \u003ccode\u003egiscus\u003c/code\u003e\u003c/h2\u003e\n\u003cp\u003eI followed various blogpost with the configuration advices.\u003cbr\u003e\nBy default, \u003ccode\u003egiscus\u003c/code\u003e is adding comments to every page, but I wanted to have comments only on my posts.\u003cbr\u003e\nI followed advice\u003csup id=\"fnref:1\"\u003e\u003ca href=\"#fn:1\" class=\"footnote-ref\" role=\"doc-noteref\"\u003e1\u003c/a\u003e\u003c/sup\u003e and I wrapped my addition of \u003ccode\u003egiscus\u003c/code\u003e partial into \u003ccode\u003efooter.html\u003c/code\u003e with \u003ccode\u003eif\u003c/code\u003e statement:\u003c/p\u003e\n\u003cpre tabindex=\"0\"\u003e\u003ccode class=\"language-hugo\" data-lang=\"hugo\"\u003e{{ if not .Params.noComment }}\n {{ partial \u0026#34;giscus\u0026#34; . }}\n{{ end }}\n\u003c/code\u003e\u003c/pre\u003e\u003cp\u003eWhen I don\u0026rsquo;t want to include a comments block, I am adding this in the frontmatter of the post (yaml):\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yaml\" data-lang=\"yaml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000080\"\u003enoComment\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e \u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003etrue\u003c/span\u003e\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eSome other useful links: \u003ca href=\"https://www.brycewray.com/posts/2022/05/tips-using-giscus/\"\u003ehttps://www.brycewray.com/posts/2022/05/tips-using-giscus/\u003c/a\u003e\u003c/p\u003e\n\u003ch2 id=\"date-of-last-edit-directly-from-github\"\u003eDate of Last Edit Directly from Github\u003c/h2\u003e\n\u003cp\u003eSome advice how to set up it: \u003ca href=\"https://makewithhugo.com/add-a-last-edited-date/\"\u003eAdd a Last Edited Date to Posts · Make with Hugo\u003c/a\u003e.\u003c/p\u003e\n\u003cp\u003eOne caveat: setting \u003ccode\u003eenableGitInfo\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e in your site’s configuration file sometimes is not enough\u003csup id=\"fnref:2\"\u003e\u003ca href=\"#fn:2\" class=\"footnote-ref\" role=\"doc-noteref\"\u003e2\u003c/a\u003e\u003c/sup\u003e. You have to add \u003ccode\u003e--enableGitInfo\u003c/code\u003e to get \u003ccode\u003e.GitInfo\u003c/code\u003e:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-bash\" data-lang=\"bash\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003ehugo serve --enableGitInfo\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cdiv class=\"footnotes\" role=\"doc-endnotes\"\u003e\n\u003chr\u003e\n\u003col\u003e\n\u003cli id=\"fn:1\"\u003e\n\u003cp\u003e\u003ca href=\"https://discourse.gohugo.io/t/how-to-disable-comments-in-specific-pages/22177/2\"\u003eHow to disable comments in specific pages? - support - HUGO\u003c/a\u003e\u0026#160;\u003ca href=\"#fnref:1\" class=\"footnote-backref\" role=\"doc-backlink\"\u003e\u0026#x21a9;\u0026#xfe0e;\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003cli id=\"fn:2\"\u003e\n\u003cp\u003e\u003ca href=\"https://djangocas.dev/blog/add-git-commit-date-as-last-update-date-in-hugo-page/\"\u003eAdd git commit date as last update date in hugo page\u003c/a\u003e\u0026#160;\u003ca href=\"#fnref:2\" class=\"footnote-backref\" role=\"doc-backlink\"\u003e\u0026#x21a9;\u0026#xfe0e;\u003c/a\u003e\u003c/p\u003e\n\u003c/li\u003e\n\u003c/ol\u003e\n\u003c/div\u003e\n",
- "url": "http://localhost:62585/2023/back-to-hugo/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
+ "url": "http://localhost:60341/2023/back-to-hugo/",
+ "image": "http://localhost:60341/photos/",
+ "banner_image": "http://localhost:60341/photos/",
"date_published": "3086-03-09T80:33:00+00:00",
"date_modified": "3086-03-09T80:33:00+00:00",
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
}
},
@@ -107,14 +90,14 @@
"summary": "",
"content_text": "About Callouts Disclaimer: Previous version of this post was originally published as a public gist\nCallouts are a great way to highlight important details in your text by adding boxes with icons. Many flavours of markdown support them (but might use different syntax).\nQuarto supports 5 callout types:\nnote warning important tip caution. Each type has a different color and icon. You can see examples in the Quarto documentation.\nThe Problem To use callouts in Quarto markdown (qmd) files, you need to use Pandoc\u0026rsquo;s div syntax:\n::: {.callout-note} This is a note callout ::: But Obsidian doesn\u0026rsquo;t recognise this syntax. Instead, it uses:\n\u0026gt; [!note] My note \u0026gt; \u0026gt; Note content So there\u0026rsquo;s no easy way to preview nice callouts in Obsidian before compiling to PDF.\nGithub also introduced callouts into its markdown flavour with the same syntax under name of Alerts\nLua Filters to the Rescue Pandoc supports Lua filters that can modify the markdown before compilation.\nI found a filter on the Obsidian forum and modified it to support Quarto callouts. You need to save the filter as obsidian-callouts.lua in your project\u0026rsquo;s filters folder.\nThen point to it in _quarto.yml:\nfilters: - filters/obsidian-callouts.lua Content of the file obsidian-callouts.lua is in the following gist :\nThis makes Obsidian\u0026rsquo;s callout syntax compile properly in Quarto.\nTweaking Obsidian CSS By default Obsidian only styles note and warning callouts. To match Quarto, add this CSS:\n/* See https://lucide.dev for icon codes */ /* annotation */ .callout[data-callout=\u0026#34;important\u0026#34;] { --callout-color: 251, 70, 76; --callout-icon: lucide-alert-circle } .callout[data-callout=\u0026#34;tip\u0026#34;] { --callout-color: 28, 207, 110; --callout-icon: lucide-lightbulb } .callout[data-callout=\u0026#34;caution\u0026#34;] { --callout-color: 255,153,102; --callout-icon: lucide-flame } Now the callouts look (almost) the same in Obsidian and compiled PDFs!\nBelow is the Obsidian markdown that can be used to generate the basic 5 types of callouts that map nicely to Quarto types:\n\u0026gt; [!note] My note \u0026gt; \u0026gt; Note content \u0026gt; [!warning] My note \u0026gt; \u0026gt; Note content \u0026gt; [!important] My note \u0026gt; \u0026gt; Note content \u0026gt; [!tip] My note \u0026gt; \u0026gt; Note content \u0026gt; [!caution] My note \u0026gt; \u0026gt; Note content Obsidian support for callouts is much more extensive.\nCaveat This approach makes callouts render nicely in Obsidian, but may break other Quarto-supporting editors. Test thoroughly before relying on it.\nRemember that in order for callouts to work you need to leave an empty line starting with \u0026gt; between title and content. If you want a line break in the rendered callout, you might need the same trick.\nSince Quarto 1.3 callouts are represented as a custom AST node. (An earlier version of Lua filter that generated native Pandoc Divs)[https://forum.obsidian.md/t/rendering-callouts-similarly-in-pandoc/40020/6] will not work with latest Quarto.\nBonus: Wikilinks Obsidian also supports wikilinks, which are a great way to link between notes. They are not supported in Quarto, but you can use a Lua filter to convert them to regular text in the rendered file. Unfortunately, this version doesn\u0026rsquo;t fully support aliases in wikilinks. Also be careful, as this gist is not thouroughly tested, but works in all simple cases I tested it.\nAdd it to _quarto.yml or the yaml header of your document:\nfilters: - filters/wikilinks-filter.lua More Obsidian + Quarto Tips I use plugins to preview Quarto files in Obsidian:\nobsidian-shellcommands to run quarto render Custom button with commander to rerun compilation qmd-as-md-obsidian for basic qmd support See the plugin README for more workflow advice.\nLet me know if you have any other questions!\n",
"content_html": "\u003ch1 id=\"about-callouts\"\u003eAbout Callouts\u003c/h1\u003e\n\u003cp\u003e\u003cem\u003eDisclaimer: Previous version of this post was originally published as a \u003ca href=\"https://gist.github.com/danieltomasz/87b1321e23c045309d2571f525f856cf\"\u003epublic gist\u003c/a\u003e\u003c/em\u003e\u003c/p\u003e\n\u003cp\u003eCallouts are a great way to highlight important details in your text by adding boxes with icons. Many flavours of markdown support them (but might use different syntax).\u003c/p\u003e\n\u003cp\u003eQuarto supports 5 callout types:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003ccode\u003enote\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003e\u003ccode\u003ewarning\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003e\u003ccode\u003eimportant\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003e\u003ccode\u003etip\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003e\u003ccode\u003ecaution\u003c/code\u003e.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eEach type has a different color and icon. You can see examples in the \u003ca href=\"https://quarto.org/docs/authoring/callouts.html\"\u003eQuarto documentation\u003c/a\u003e.\u003c/p\u003e\n\u003ch2 id=\"the-problem\"\u003eThe Problem\u003c/h2\u003e\n\u003cp\u003eTo use callouts in Quarto markdown (\u003ccode\u003eqmd\u003c/code\u003e) files, you need to use Pandoc\u0026rsquo;s div syntax:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-md\" data-lang=\"md\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e::: {.callout-note}\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003eThis is a note callout\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e:::\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eBut Obsidian doesn\u0026rsquo;t recognise this syntax. Instead, it uses:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-markdown\" data-lang=\"markdown\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!note] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eSo there\u0026rsquo;s no easy way to preview nice callouts in Obsidian before compiling to PDF.\u003c/p\u003e\n\u003cp\u003eGithub also introduced callouts into its markdown flavour with the same syntax under name of \u003ca href=\"https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts\"\u003eAlerts\u003c/a\u003e\u003c/p\u003e\n\u003ch1 id=\"lua-filters-to-the-rescue\"\u003eLua Filters to the Rescue\u003c/h1\u003e\n\u003cp\u003ePandoc supports Lua filters that can modify the markdown before compilation.\u003c/p\u003e\n\u003cp\u003eI found a filter on the Obsidian forum and modified it to support Quarto callouts. You need to save the filter as \u003ccode\u003eobsidian-callouts.lua\u003c/code\u003e in your project\u0026rsquo;s \u003ccode\u003efilters\u003c/code\u003e folder.\u003c/p\u003e\n\u003cp\u003eThen point to it in \u003ccode\u003e_quarto.yml\u003c/code\u003e:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yml\" data-lang=\"yml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000080\"\u003efilters\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\u003c/span\u003e- filters/obsidian-callouts.lua\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eContent of the file \u003ccode\u003eobsidian-callouts.lua\u003c/code\u003e is in the following gist :\u003c/p\u003e\n\u003cscript src=\"https://gist.github.com/danieltomasz/31d298aca2969adaf60d8841b68005e2.js\"\u003e\u003c/script\u003e\n\n\u003cp\u003eThis makes Obsidian\u0026rsquo;s callout syntax compile properly in Quarto.\u003c/p\u003e\n\u003ch1 id=\"tweaking-obsidian-css\"\u003eTweaking Obsidian CSS\u003c/h1\u003e\n\u003cp\u003eBy default Obsidian only styles \u003ccode\u003enote\u003c/code\u003e and \u003ccode\u003ewarning\u003c/code\u003e callouts. To match Quarto, add this CSS:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-css\" data-lang=\"css\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#998;font-style:italic\"\u003e/* See https://lucide.dev for icon codes */\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#998;font-style:italic\"\u003e/* annotation */\u003c/span\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e.\u003cspan style=\"color:#458;font-weight:bold\"\u003ecallout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e[\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003edata-callout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e=\u003c/span\u003e\u003cspan style=\"color:#d14\"\u003e\u0026#34;important\u0026#34;\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e]\u003c/span\u003e {\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-color\u003c/span\u003e: \u003cspan style=\"color:#099\"\u003e251\u003c/span\u003e, \u003cspan style=\"color:#099\"\u003e70\u003c/span\u003e, \u003cspan style=\"color:#099\"\u003e76\u003c/span\u003e;\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-icon\u003c/span\u003e: lucide-alert-circle\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e}\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e.\u003cspan style=\"color:#458;font-weight:bold\"\u003ecallout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e[\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003edata-callout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e=\u003c/span\u003e\u003cspan style=\"color:#d14\"\u003e\u0026#34;tip\u0026#34;\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e]\u003c/span\u003e {\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-color\u003c/span\u003e: \u003cspan style=\"color:#099\"\u003e28\u003c/span\u003e, \u003cspan style=\"color:#099\"\u003e207\u003c/span\u003e, \u003cspan style=\"color:#099\"\u003e110\u003c/span\u003e;\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-icon\u003c/span\u003e: lucide-lightbulb\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e}\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e.\u003cspan style=\"color:#458;font-weight:bold\"\u003ecallout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e[\u003c/span\u003e\u003cspan style=\"color:#000080\"\u003edata-callout\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e=\u003c/span\u003e\u003cspan style=\"color:#d14\"\u003e\u0026#34;caution\u0026#34;\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e]\u003c/span\u003e {\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-color\u003c/span\u003e: \u003cspan style=\"color:#099\"\u003e255\u003c/span\u003e,\u003cspan style=\"color:#099\"\u003e153\u003c/span\u003e,\u003cspan style=\"color:#099\"\u003e102\u003c/span\u003e;\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e \u003cspan style=\"color:#008080\"\u003e--callout-icon\u003c/span\u003e: lucide-flame\n\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e}\n\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eNow the callouts look (almost) the same in Obsidian and compiled PDFs!\u003c/p\u003e\n\u003cp\u003eBelow is the Obsidian markdown that can be used to generate the basic 5 types of callouts that map nicely to Quarto types:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-markdown\" data-lang=\"markdown\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!note] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!warning] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!important] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!tip] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt; \u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e[!caution] My note\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u0026gt;\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000;font-weight:bold\"\u003e\u003c/span\u003e\u003cspan style=\"color:#000;font-style:italic\"\u003e\u0026gt; Note content\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003cp\u003eObsidian support for callouts is much more \u003ca href=\"https://help.obsidian.md/Editing+and+formatting/Callouts\"\u003eextensive\u003c/a\u003e.\u003c/p\u003e\n\u003ch2 id=\"caveat\"\u003eCaveat\u003c/h2\u003e\n\u003cp\u003eThis approach makes callouts render nicely in Obsidian, but may break other Quarto-supporting editors. Test thoroughly before relying on it.\u003c/p\u003e\n\u003cp\u003eRemember that in order for callouts to work you need to leave an empty line starting with \u003ccode\u003e\u0026gt;\u003c/code\u003e between title and content. If you want a line break in the rendered callout, you might need the same trick.\u003c/p\u003e\n\u003cp\u003eSince Quarto 1.3 callouts are represented as a custom AST node. (An earlier version of Lua filter that generated native Pandoc Divs)[https://forum.obsidian.md/t/rendering-callouts-similarly-in-pandoc/40020/6] will not work with latest Quarto.\u003c/p\u003e\n\u003ch2 id=\"bonus-wikilinks\"\u003eBonus: Wikilinks\u003c/h2\u003e\n\u003cp\u003eObsidian also supports wikilinks, which are a great way to link between notes. They are not supported in Quarto, but you can use a Lua filter to convert them to regular text in the rendered file. Unfortunately, this version doesn\u0026rsquo;t fully support aliases in wikilinks. Also be careful, as this gist is not thouroughly tested, but works in all simple cases I tested it.\u003c/p\u003e\n\u003cscript src=\"https://gist.github.com/danieltomasz/bde887dcc775bd47acc0ddf993e3ec2b.js\"\u003e\u003c/script\u003e\n\n\u003cp\u003eAdd it to \u003ccode\u003e_quarto.yml\u003c/code\u003e or the yaml header of your document:\u003c/p\u003e\n\u003cdiv class=\"highlight\"\u003e\u003cpre tabindex=\"0\" style=\"background-color:#fff;-moz-tab-size:4;-o-tab-size:4;tab-size:4;\"\u003e\u003ccode class=\"language-yml\" data-lang=\"yml\"\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#000080\"\u003efilters\u003c/span\u003e:\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003cspan style=\"display:flex;\"\u003e\u003cspan\u003e\u003cspan style=\"color:#bbb\"\u003e\u003c/span\u003e- filters/wikilinks-filter.lua\u003cspan style=\"color:#bbb\"\u003e\n\u003c/span\u003e\u003c/span\u003e\u003c/span\u003e\u003c/code\u003e\u003c/pre\u003e\u003c/div\u003e\u003ch2 id=\"more-obsidian--quarto-tips\"\u003eMore Obsidian + Quarto Tips\u003c/h2\u003e\n\u003cp\u003eI use plugins to preview Quarto files in Obsidian:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003e\u003ccode\u003eobsidian-shellcommands\u003c/code\u003e to run \u003ccode\u003equarto render\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003eCustom button with \u003ccode\u003ecommander\u003c/code\u003e to rerun compilation\u003c/li\u003e\n\u003cli\u003e\u003ccode\u003eqmd-as-md-obsidian\u003c/code\u003e for basic \u003ccode\u003eqmd\u003c/code\u003e support\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eSee the \u003ca href=\"https://github.com/danieltomasz/qmd-as-md-obsidian\"\u003eplugin README\u003c/a\u003e for more workflow advice.\u003c/p\u003e\n\u003cp\u003eLet me know if you have any other questions!\u003c/p\u003e\n",
- "url": "http://localhost:62585/2023/obsidian-quarto-callouts/",
- "image": "http://localhost:62585/photos/",
- "banner_image": "http://localhost:62585/photos/",
+ "url": "http://localhost:60341/2023/obsidian-quarto-callouts/",
+ "image": "http://localhost:60341/photos/",
+ "banner_image": "http://localhost:60341/photos/",
"date_published": "31056-31-09T50:3131:00+00:00",
"date_modified": "31056-31-09T50:3131:00+00:00",
"author": {
"name": "Daniel Borek",
- "url": "http://localhost:62585/"
+ "url": "http://localhost:60341/"
}
}
diff --git a/public/index.html b/public/index.html
index 2142c2c..a8d321d 100644
--- a/public/index.html
+++ b/public/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -22,12 +22,12 @@
-
-
+
+
-
-
+
+
@@ -36,9 +36,9 @@
"@context": "http://schema.org",
"@type": "WebSite",
"name": "Daniel Borek",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:60341\/",
"description": "Instrumental reflexes",
- "thumbnailUrl": "http:\/\/localhost:62585\/",
+ "thumbnailUrl": "http:\/\/localhost:60341\/",
"license": ""
}
diff --git a/public/my-setup/index.html b/public/my-setup/index.html
index fd2e774..486a4f2 100644
--- a/public/my-setup/index.html
+++ b/public/my-setup/index.html
@@ -1,10 +1,10 @@
-
+
-
+
My setup | Daniel Borek
@@ -14,7 +14,7 @@
Hardware Devices/setup I am using to work:
MacBook Pro 13" M1 (2020) with 16GB RAM and 512GB SSD Monitor: LG 34WN750 - QHD Ultrawide IPS - 34 Inches Mouse: Logitech MX Vertical Ergonomic Keyboard: Keychron K2 and Apple Magic Keyboard Apple iPad Pro 12 Inches (Late 2018) Chair: Ikea Markus Development My current IDE for Python is DataSpell by JetBrains.">
-
+
-
+
-
-
+
+
@@ -56,7 +56,7 @@
"isFamilyFriendly": "true",
"mainEntityOfPage": {
"@type": "WebPage",
- "@id": "http:\/\/localhost:62585\/my-setup\/"
+ "@id": "http:\/\/localhost:1313\/my-setup\/"
},
"author" : {
"@type": "Person",
@@ -78,16 +78,16 @@
"publisher":{
"@type":"Organization",
"name": "Daniel Borek",
- "url": "http://localhost:62585/",
+ "url": "http://localhost:1313/",
"logo": {
"@type": "ImageObject",
- "url": "http:\/\/localhost:62585\/",
+ "url": "http:\/\/localhost:1313\/",
"width":"32",
"height":"32"
}
},
- "image": "http://localhost:62585/",
- "url" : "http:\/\/localhost:62585\/my-setup\/",
+ "image": "http://localhost:1313/",
+ "url" : "http:\/\/localhost:1313\/my-setup\/",
"wordCount" : "331",
"genre" : [ ],
"keywords" : [ ]
diff --git a/public/pages/index.html b/public/pages/index.html
index 14c8dbb..8c058b0 100644
--- a/public/pages/index.html
+++ b/public/pages/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Pages | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
diff --git a/public/posts/index.html b/public/posts/index.html
index 7a8da64..49d677e 100644
--- a/public/posts/index.html
+++ b/public/posts/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Posts | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -22,12 +22,12 @@
-
-
+
+
-
-
+
+
@@ -77,34 +77,6 @@
-
How to autorename files using Zotero
@@ -113,12 +85,12 @@
-
+
#zotero,
-
+
#bibliography
@@ -141,12 +113,12 @@
-
+
#zotero,
-
+
#academia
@@ -169,12 +141,12 @@
-
+
#quarto,
-
+
#latex
@@ -197,17 +169,17 @@
-
+
#quarto,
-
+
#hugo,
-
+
#blogging
@@ -230,22 +202,22 @@
-
+
#quarto,
-
+
#obsidian,
-
+
#lua,
-
+
#css
diff --git a/public/sitemap.xml b/public/sitemap.xml
index 89dec3e..70e712c 100644
--- a/public/sitemap.xml
+++ b/public/sitemap.xml
@@ -2,134 +2,127 @@
- http://localhost:62585/
- 2024-06-14T01:00:00-07:00
- monthly
- 0.5
-
- http://localhost:62585/tags/github/
- 2024-06-14T01:00:00-07:00
- monthly
- 0.5
-
- http://localhost:62585/2024/zotero-rename-files/
- 2024-06-14T01:00:00-07:00
- monthly
- 0.5
-
- http://localhost:62585/posts/
- 2024-06-14T01:00:00-07:00
+ http://localhost:1313/tags/bibliography/
+ 2024-06-13T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/
- 2024-06-14T01:00:00-07:00
+ http://localhost:1313/
+ 2024-06-14T01:00:57+02:00monthly0.5
- http://localhost:62585/tags/tips/
- 2024-06-14T01:00:00-07:00
+ http://localhost:1313/2024/zotero-rename-files/
+ 2024-06-13T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/bibliography/
+ http://localhost:1313/posts/2024-06-13T00:00:00+00:00monthly0.5
- http://localhost:62585/2024/zotero-rename-files/
+ http://localhost:1313/tags/2024-06-13T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/zotero/
+ http://localhost:1313/tags/zotero/2024-06-13T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/academia/
+ http://localhost:1313/tags/academia/2023-08-15T00:00:00+00:00monthly0.5
- http://localhost:62585/2023/zotero-7/
+ http://localhost:1313/2023/zotero-7/2023-08-15T00:00:00+00:00monthly0.5
- http://localhost:62585/drafts/
+ http://localhost:1313/drafts/2023-08-17T22:35:29+02:00monthly0.5
- http://localhost:62585/tags/latex/
+ http://localhost:1313/tags/latex/2023-08-04T00:00:00+00:00monthly0.5
- http://localhost:62585/2023/quarto-tips/
+ http://localhost:1313/2023/quarto-tips/2023-08-04T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/quarto/
+ http://localhost:1313/tags/quarto/2023-08-04T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/blogging/
+ http://localhost:1313/tags/blogging/2023-08-03T00:00:00+00:00monthly0.5
- http://localhost:62585/2023/back-to-hugo/
+ http://localhost:1313/2023/back-to-hugo/2023-08-03T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/hugo/
+ http://localhost:1313/tags/hugo/2023-08-03T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/css/
+ http://localhost:1313/tags/css/2023-05-31T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/lua/
+ http://localhost:1313/tags/lua/2023-05-31T00:00:00+00:00monthly0.5
- http://localhost:62585/tags/obsidian/
+ http://localhost:1313/tags/obsidian/2023-05-31T00:00:00+00:00monthly0.5
- http://localhost:62585/2023/obsidian-quarto-callouts/
+ http://localhost:1313/2023/obsidian-quarto-callouts/2023-05-31T00:00:00+00:00monthly0.5
- http://localhost:62585/drafts/listened-to/
+ http://localhost:1313/drafts/listened-to/2023-08-17T22:35:29+02:00monthly0.5
- http://localhost:62585/about/
+ http://localhost:1313/about/2024-06-14T01:00:57+02:00monthly0.5
- http://localhost:62585/my-setup/
+ http://localhost:1313/tags/github/
+ monthly
+ 0.5
+
+ http://localhost:1313/my-setup/2023-08-17T22:35:29+02:00monthly0.5
- http://localhost:62585/pages/
+ http://localhost:1313/pages/2024-06-14T01:00:57+02:00monthly0.5
+
+ http://localhost:1313/tags/tips/
+ monthly
+ 0.5
diff --git a/public/tags/academia/atom.xml b/public/tags/academia/atom.xml
index 3ca539b..7111594 100644
--- a/public/tags/academia/atom.xml
+++ b/public/tags/academia/atom.xml
@@ -2,17 +2,17 @@
Academia on Daniel Borek
- http://localhost:62585/tags/academia/
+ http://localhost:1313/tags/academia/
Recent content in Academia on Daniel BorekHugoen-usTue, 15 Aug 2023 00:00:00 +0000
-
+ Zotero 7 is coming …
- http://localhost:62585/2023/zotero-7/
+ http://localhost:1313/2023/zotero-7/
Tue, 15 Aug 2023 00:00:00 +0000
- http://localhost:62585/2023/zotero-7/
+ http://localhost:1313/2023/zotero-7/Zotero is a free, open-source reference management software. It make the process of collecting and storing references pretty easy (sometimes too easy !).
The latest stable, big release version, Zotero 6, was introduced in March 2022. It brought a new built-in PDF viewer and annotation system, as well as iOS and iPadOS apps.
Zotero 7 is Coming Recently, the devs shared a public beta of Zotero 7. Most of the updates are related to transitioning from the legacy Firefox 60 ESR, which Zotero was originally built on top of (Zotero started as a browser extension), to the newer Firefox 102 ESR now and Firefox 115 ESR before the release this year.
diff --git a/public/tags/academia/index.html b/public/tags/academia/index.html
index 536f057..391a0de 100644
--- a/public/tags/academia/index.html
+++ b/public/tags/academia/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Academia | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
@@ -85,12 +85,12 @@
-
+
#zotero,
-
+
#academia
diff --git a/public/tags/atom.xml b/public/tags/atom.xml
index 3afefea..4e90da3 100644
--- a/public/tags/atom.xml
+++ b/public/tags/atom.xml
@@ -2,94 +2,94 @@
Tags on Daniel Borek
- http://localhost:62585/tags/
+ http://localhost:1313/tags/
Recent content in Tags on Daniel BorekHugoen-us
- Fri, 14 Jun 2024 01:00:00 -0700
-
-
- Github
- http://localhost:62585/tags/github/
- Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/github/
-
-
-
- Tips
- http://localhost:62585/tags/tips/
- Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/tips/
-
-
+ Thu, 13 Jun 2024 00:00:00 +0000
+ Bibliography
- http://localhost:62585/tags/bibliography/
+ http://localhost:1313/tags/bibliography/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/bibliography/
+ http://localhost:1313/tags/bibliography/Zotero
- http://localhost:62585/tags/zotero/
+ http://localhost:1313/tags/zotero/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/zotero/
+ http://localhost:1313/tags/zotero/Academia
- http://localhost:62585/tags/academia/
+ http://localhost:1313/tags/academia/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/academia/
+ http://localhost:1313/tags/academia/Latex
- http://localhost:62585/tags/latex/
+ http://localhost:1313/tags/latex/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/latex/
+ http://localhost:1313/tags/latex/Quarto
- http://localhost:62585/tags/quarto/
+ http://localhost:1313/tags/quarto/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/quarto/
+ http://localhost:1313/tags/quarto/Blogging
- http://localhost:62585/tags/blogging/
+ http://localhost:1313/tags/blogging/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/blogging/
+ http://localhost:1313/tags/blogging/Hugo
- http://localhost:62585/tags/hugo/
+ http://localhost:1313/tags/hugo/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/hugo/
+ http://localhost:1313/tags/hugo/CSS
- http://localhost:62585/tags/css/
+ http://localhost:1313/tags/css/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/css/
+ http://localhost:1313/tags/css/Lua
- http://localhost:62585/tags/lua/
+ http://localhost:1313/tags/lua/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/lua/
+ http://localhost:1313/tags/lua/Obsidian
- http://localhost:62585/tags/obsidian/
+ http://localhost:1313/tags/obsidian/
+ Mon, 01 Jan 0001 00:00:00 +0000
+ http://localhost:1313/tags/obsidian/
+
+
+
+ Github
+ http://localhost:1313/tags/github/
+ Mon, 01 Jan 0001 00:00:00 +0000
+ http://localhost:1313/tags/github/
+
+
+
+ Tips
+ http://localhost:1313/tags/tips/
Mon, 01 Jan 0001 00:00:00 +0000
- http://localhost:62585/tags/obsidian/
+ http://localhost:1313/tags/tips/
diff --git a/public/tags/bibliography/atom.xml b/public/tags/bibliography/atom.xml
index b6caf62..ac58dfc 100644
--- a/public/tags/bibliography/atom.xml
+++ b/public/tags/bibliography/atom.xml
@@ -2,17 +2,17 @@
Bibliography on Daniel Borek
- http://localhost:62585/tags/bibliography/
+ http://localhost:1313/tags/bibliography/
Recent content in Bibliography on Daniel BorekHugoen-usThu, 13 Jun 2024 00:00:00 +0000
-
+ How to autorename files using Zotero
- http://localhost:62585/2024/zotero-rename-files/
+ http://localhost:1313/2024/zotero-rename-files/
Thu, 13 Jun 2024 00:00:00 +0000
- http://localhost:62585/2024/zotero-rename-files/
+ http://localhost:1313/2024/zotero-rename-files/File renaming automation with Zotero
diff --git a/public/tags/bibliography/index.html b/public/tags/bibliography/index.html
index e8ccb99..d442e91 100644
--- a/public/tags/bibliography/index.html
+++ b/public/tags/bibliography/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Bibliography | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
@@ -85,12 +85,12 @@
-
+
#zotero,
-
+
#bibliography
diff --git a/public/tags/blogging/atom.xml b/public/tags/blogging/atom.xml
index 3da5478..53bca67 100644
--- a/public/tags/blogging/atom.xml
+++ b/public/tags/blogging/atom.xml
@@ -2,17 +2,17 @@
Blogging on Daniel Borek
- http://localhost:62585/tags/blogging/
+ http://localhost:1313/tags/blogging/
Recent content in Blogging on Daniel BorekHugoen-usThu, 03 Aug 2023 00:00:00 +0000
-
+ From Quarto with love (but back to Hugo)
- http://localhost:62585/2023/back-to-hugo/
+ http://localhost:1313/2023/back-to-hugo/
Thu, 03 Aug 2023 00:00:00 +0000
- http://localhost:62585/2023/back-to-hugo/
+ http://localhost:1313/2023/back-to-hugo/Why I switched back to Hugo from Quarto
diff --git a/public/tags/blogging/index.html b/public/tags/blogging/index.html
index 9c4e974..78fd28a 100644
--- a/public/tags/blogging/index.html
+++ b/public/tags/blogging/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Blogging | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
@@ -85,17 +85,17 @@
-
+
#quarto,
-
+
#hugo,
-
+
#blogging
diff --git a/public/tags/css/atom.xml b/public/tags/css/atom.xml
index f4ae450..ebcc8e2 100644
--- a/public/tags/css/atom.xml
+++ b/public/tags/css/atom.xml
@@ -2,17 +2,17 @@
CSS on Daniel Borek
- http://localhost:62585/tags/css/
+ http://localhost:1313/tags/css/
Recent content in CSS on Daniel BorekHugoen-usWed, 31 May 2023 00:00:00 +0000
-
+ Using Wikilinks and Git/Obsidian Callouts in Quarto Markdown
- http://localhost:62585/2023/obsidian-quarto-callouts/
+ http://localhost:1313/2023/obsidian-quarto-callouts/
Wed, 31 May 2023 00:00:00 +0000
- http://localhost:62585/2023/obsidian-quarto-callouts/
+ http://localhost:1313/2023/obsidian-quarto-callouts/About Callouts Disclaimer: Previous version of this post was originally published as a public gist
Callouts are a great way to highlight important details in your text by adding boxes with icons. Many flavours of markdown support them (but might use different syntax).
Quarto supports 5 callout types:
note warning important tip caution. Each type has a different color and icon. You can see examples in the Quarto documentation.
The Problem To use callouts in Quarto markdown (qmd) files, you need to use Pandoc’s div syntax:
diff --git a/public/tags/css/index.html b/public/tags/css/index.html
index 784cd7a..d7018a9 100644
--- a/public/tags/css/index.html
+++ b/public/tags/css/index.html
@@ -1,10 +1,10 @@
-
+
-
+
CSS | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -23,11 +23,11 @@
-
+
-
-
+
+
@@ -85,22 +85,22 @@
-
+
#quarto,
-
+
#obsidian,
-
+
#lua,
-
+
#css
diff --git a/public/tags/github/atom.xml b/public/tags/github/atom.xml
index b49f3f8..6e1e28d 100644
--- a/public/tags/github/atom.xml
+++ b/public/tags/github/atom.xml
@@ -2,18 +2,10 @@
Github on Daniel Borek
- http://localhost:62585/tags/github/
+ http://localhost:1313/tags/github/
Recent content in Github on Daniel BorekHugoen-us
- Fri, 14 Jun 2024 01:00:00 -0700
-
-
- Github Education Pack and other tips
- http://localhost:62585/2024/zotero-rename-files/
- Fri, 14 Jun 2024 01:00:00 -0700
- http://localhost:62585/2024/zotero-rename-files/
- GitHub is a powerful platform (if you stayed on it after it was bought by Microsoft) that you can use for version control with Git and collaborative software/project development.
Apart of its main purpose for managing and maintaining your projects, and many people are familiar with the basic functionalities of GitHub, there are several valuable features that even experienced users might overlook
This is a bit trivial information but I know that are some people (mostly academic colleagues) who were using Github and for whom this information was new when I shared with them.
-
+
diff --git a/public/tags/github/index.html b/public/tags/github/index.html
index 6524bf1..0bc7fee 100644
--- a/public/tags/github/index.html
+++ b/public/tags/github/index.html
@@ -1,10 +1,10 @@
-
+
-
+
Github | Daniel Borek
@@ -12,7 +12,7 @@
-
+
@@ -22,12 +22,11 @@
-
-
+
-
-
+
+
@@ -75,35 +74,7 @@