diff --git a/config/_default/hugo.yaml b/config/_default/hugo.yaml index 19769c0..459e4f3 100644 --- a/config/_default/hugo.yaml +++ b/config/_default/hugo.yaml @@ -31,8 +31,6 @@ enableEmoji: true enableRobotsTXT: true footnotereturnlinkcontents: ^ ignoreFiles: [\.ipynb$, .ipynb_checkpoints$, \.Rmd$, \.Rmarkdown$, _cache$] -permalinks: - authors: '/author/:slug/' disableAliases: true outputs: home: [HTML, RSS, headers, redirects, backlinks] diff --git a/config/_default/menus.yaml b/config/_default/menus.yaml index f70c391..5c5c959 100644 --- a/config/_default/menus.yaml +++ b/config/_default/menus.yaml @@ -23,5 +23,5 @@ main: url: projects/ weight: 30 - name: Teaching - url: teaching/ + url: courses/ weight: 40 diff --git a/content/_index.md b/content/_index.md index 5f943d8..322ef2a 100644 --- a/content/_index.md +++ b/content/_index.md @@ -47,7 +47,7 @@ sections: title: Featured Publications filters: folders: - - publication + - publications featured_only: true design: view: article-grid @@ -58,7 +58,7 @@ sections: text: '' filters: folders: - - publication + - publications exclude_featured: false design: view: citation @@ -68,7 +68,7 @@ sections: title: Recent & Upcoming Talks filters: folders: - - event + - events design: view: card - block: collection @@ -78,7 +78,7 @@ sections: subtitle: '' text: '' # Page type to display. E.g. post, talk, publication... - page_type: post + page_type: blog # Choose how many pages you would like to display (0 = all pages) count: 5 # Filter on criteria diff --git a/content/post/_index.md b/content/blog/_index.md similarity index 100% rename from content/post/_index.md rename to content/blog/_index.md diff --git a/content/post/data-visualization/featured.jpg b/content/blog/data-visualization/featured.jpg similarity index 100% rename from content/post/data-visualization/featured.jpg rename to content/blog/data-visualization/featured.jpg diff --git a/content/post/data-visualization/index.md b/content/blog/data-visualization/index.md similarity index 100% rename from content/post/data-visualization/index.md rename to content/blog/data-visualization/index.md diff --git a/content/post/data-visualization/line-chart.json b/content/blog/data-visualization/line-chart.json similarity index 100% rename from content/post/data-visualization/line-chart.json rename to content/blog/data-visualization/line-chart.json diff --git a/content/post/data-visualization/results.csv b/content/blog/data-visualization/results.csv similarity index 100% rename from content/post/data-visualization/results.csv rename to content/blog/data-visualization/results.csv diff --git a/content/post/get-started/featured.jpg b/content/blog/get-started/featured.jpg similarity index 100% rename from content/post/get-started/featured.jpg rename to content/blog/get-started/featured.jpg diff --git a/content/post/get-started/index.md b/content/blog/get-started/index.md similarity index 90% rename from content/post/get-started/index.md rename to content/blog/get-started/index.md index 4dd445c..578179d 100644 --- a/content/post/get-started/index.md +++ b/content/blog/get-started/index.md @@ -35,6 +35,9 @@ Welcome 👋 ### Get Started +> [!TIP]+ Quick Start Guide +> New to Hugo Blox? Follow these steps to get your site up and running in minutes! + - 👉 [**Create a new site**](https://hugoblox.com/templates/) - 📚 [**Personalize your site**](https://docs.hugoblox.com/) - 💬 [Chat with the **Hugo Blox community**](https://discord.gg/z8wNYzb) or [**Hugo community**](https://discourse.gohugo.io) @@ -42,6 +45,9 @@ Welcome 👋 - 💡 [Request a **feature** or report a **bug** for _Hugo Blox_](https://github.com/HugoBlox/hugo-blox-builder/issues) - ⬆️ **Updating Hugo Blox?** View the [Update Guide](https://docs.hugoblox.com/reference/update/) and [Release Notes](https://github.com/HugoBlox/hugo-blox-builder/releases) +> [!IMPORTANT] +> Remember to backup your site before making major updates! + ## Crowd-funded open-source software To help us develop this template and software sustainably under the MIT license, we ask all individuals and businesses that use it to help support its ongoing maintenance and development via sponsorship. @@ -60,6 +66,9 @@ As a token of appreciation for sponsoring, you can **unlock [these](https://hugo ## Features +> [!NOTE]+ Enhanced Markdown Support +> Hugo Blox now supports GitHub and Obsidian-style callouts! Use standard Markdown alert syntax like `> [!NOTE]` for better portability. + - **Page builder** - Create _anything_ with no-code [**blocks**](https://hugoblox.com/blocks/) and [**elements**](https://docs.hugoblox.com/reference/markdown/) - **Edit any type of content** - Blog posts, publications, talks, slides, projects, and more! - **Create content** in [**Markdown**](https://docs.hugoblox.com/reference/markdown/), [**Jupyter**](https://docs.hugoblox.com/getting-started/cms/), or [**RStudio**](https://docs.hugoblox.com/getting-started/cms/) @@ -76,6 +85,9 @@ As a token of appreciation for sponsoring, you can **unlock [these](https://hugo - **Stand Out** - Bring your site to life with animation, parallax backgrounds, and scroll effects - **One-Click Deployment** - No servers. No databases. Only files. +> [!WARNING]+ Version Requirements +> The new Markdown alert syntax requires Hugo v0.132.0 or later. Make sure you're using a compatible version! + ## Themes Hugo Blox and its templates come with **automatic day (light) and night (dark) mode** built-in. Visitors can choose their preferred mode by clicking the sun/moon icon in the header. diff --git a/content/post/project-management/featured.jpg b/content/blog/project-management/featured.jpg similarity index 100% rename from content/post/project-management/featured.jpg rename to content/blog/project-management/featured.jpg diff --git a/content/post/project-management/index.md b/content/blog/project-management/index.md similarity index 100% rename from content/post/project-management/index.md rename to content/blog/project-management/index.md diff --git a/content/post/second-brain/featured.jpg b/content/blog/second-brain/featured.jpg similarity index 100% rename from content/post/second-brain/featured.jpg rename to content/blog/second-brain/featured.jpg diff --git a/content/post/second-brain/index.md b/content/blog/second-brain/index.md similarity index 100% rename from content/post/second-brain/index.md rename to content/blog/second-brain/index.md diff --git a/content/post/teach-courses/ambient-piano.mp3 b/content/blog/teach-courses/ambient-piano.mp3 similarity index 100% rename from content/post/teach-courses/ambient-piano.mp3 rename to content/blog/teach-courses/ambient-piano.mp3 diff --git a/content/post/teach-courses/featured.jpg b/content/blog/teach-courses/featured.jpg similarity index 100% rename from content/post/teach-courses/featured.jpg rename to content/blog/teach-courses/featured.jpg diff --git a/content/post/teach-courses/index.md b/content/blog/teach-courses/index.md similarity index 97% rename from content/post/teach-courses/index.md rename to content/blog/teach-courses/index.md index 67eb5d8..eb41246 100644 --- a/content/post/teach-courses/index.md +++ b/content/blog/teach-courses/index.md @@ -23,11 +23,11 @@ On this page, you'll find some examples of the types of technical content that c Here's an example of citing a publication using the cite shortcode: -{{< cite page="/publication/preprint" view="citation" >}} +{{< cite page="/publications/preprint" view="citation" >}} You can also use the default view by omitting the view parameter: -{{< cite page="/publication/conference-paper" >}} +{{< cite page="/publications/conference-paper" >}} ## Video diff --git a/content/teaching/_index.md b/content/courses/_index.md similarity index 76% rename from content/teaching/_index.md rename to content/courses/_index.md index f8e6bfa..2d5dd43 100644 --- a/content/teaching/_index.md +++ b/content/courses/_index.md @@ -1,5 +1,5 @@ --- -title: Teaching +title: Courses summary: My courses type: landing @@ -11,12 +11,12 @@ cascade: sections: - block: collection - id: teaching + id: courses content: - title: Teaching + title: Courses filters: folders: - - teaching + - courses design: view: article-grid columns: 2 diff --git a/content/teaching/js/ambient-piano.mp3 b/content/courses/js/ambient-piano.mp3 similarity index 100% rename from content/teaching/js/ambient-piano.mp3 rename to content/courses/js/ambient-piano.mp3 diff --git a/content/teaching/js/featured.jpg b/content/courses/js/featured.jpg similarity index 100% rename from content/teaching/js/featured.jpg rename to content/courses/js/featured.jpg diff --git a/content/teaching/js/index.md b/content/courses/js/index.md similarity index 100% rename from content/teaching/js/index.md rename to content/courses/js/index.md diff --git a/content/teaching/python/ambient-piano.mp3 b/content/courses/python/ambient-piano.mp3 similarity index 100% rename from content/teaching/python/ambient-piano.mp3 rename to content/courses/python/ambient-piano.mp3 diff --git a/content/teaching/python/featured.jpg b/content/courses/python/featured.jpg similarity index 100% rename from content/teaching/python/featured.jpg rename to content/courses/python/featured.jpg diff --git a/content/teaching/python/index.md b/content/courses/python/index.md similarity index 58% rename from content/teaching/python/index.md rename to content/courses/python/index.md index afe8b20..d093ec8 100644 --- a/content/teaching/python/index.md +++ b/content/courses/python/index.md @@ -71,9 +71,8 @@ Hugo Blox Builder supports a Markdown extension for $\LaTeX$ math. You can enabl To render _inline_ or _block_ math, wrap your LaTeX math with `{{}}$...${{}}` or `{{}}$$...$${{}}`, respectively. -{{% callout note %}} -We wrap the LaTeX math in the Hugo Blox _math_ shortcode to prevent Hugo rendering our math as Markdown. -{{% /callout %}} +> [!NOTE] +> We wrap the LaTeX math in the Hugo Blox _math_ shortcode to prevent Hugo rendering our math as Markdown. This callout now uses the standard Markdown alert syntax! Example **math block**: @@ -141,4 +140,99 @@ renders as {{< icon name="python" >}} Python +## Callouts & Alerts + +Hugo Blox Builder now supports GitHub and Obsidian-style Markdown alerts for better content portability! These replace the old `callout` shortcode. + +### Basic Callout Types + +**Note** - For general information: + +```markdown +> [!NOTE] +> This is a note callout with important information that users should know. +``` + +> [!NOTE] +> This is a note callout with important information that users should know. + +**Tip** - For helpful advice: + +```markdown +> [!TIP] +> Here's a helpful tip to make your workflow more efficient! +``` + +> [!TIP] +> Here's a helpful tip to make your workflow more efficient! + +**Important** - For critical information: + +```markdown +> [!IMPORTANT] +> This is critical information that users must understand to proceed. +``` + +> [!IMPORTANT] +> This is critical information that users must understand to proceed. + +**Warning** - For potential issues: + +```markdown +> [!WARNING] +> Be careful! This action might have unexpected consequences. +``` + +> [!WARNING] +> Be careful! This action might have unexpected consequences. + +**Caution** - For dangerous actions: + +```markdown +> [!CAUTION] +> Danger! This operation is irreversible and could cause data loss. +``` + +> [!CAUTION] +> Danger! This operation is irreversible and could cause data loss. + +### Custom Titles + +You can customize the title of any callout: + +```markdown +> [!WARNING]+ Custom Warning Title +> This warning has a custom title instead of just "Warning". +``` + +> [!WARNING]+ Custom Warning Title +> This warning has a custom title instead of just "Warning". + +### Legacy Syntax (Deprecated) + +The old shortcode syntax still works but shows a deprecation warning: + +```markdown +{{}} +This still works but is deprecated. Use the Markdown syntax above! +{{}} +``` + +{{% callout note %}} +This still works but is deprecated. Use the Markdown syntax above! +{{% /callout %}} + +### Benefits of the New Syntax + +- **Portable**: Works with GitHub, Obsidian, and other Markdown processors +- **Standard**: Uses widely-adopted Markdown alert syntax +- **Clean**: No Hugo-specific shortcodes needed +- **Future-proof**: Supported by the latest Hugo versions (0.132.0+) +- **Multilingual**: Callout titles are automatically translated based on your site's language + - English: "Note", "Tip", "Important", "Warning", "Caution" + - Spanish: "Nota", "Consejo", "Importante", "Advertencia", "Precaución" + - French: "Note", "Conseil", "Important", "Attention", "Prudence" + - German: "Hinweis", "Tipp", "Wichtig", "Warnung", "Vorsicht" + - Chinese: "注意", "提示", "重要", "警告", "小心" + ## Did you find this page helpful? Consider sharing it 🙌 diff --git a/content/event/_index.md b/content/events/_index.md similarity index 100% rename from content/event/_index.md rename to content/events/_index.md diff --git a/content/event/example/featured.jpg b/content/events/example/featured.jpg similarity index 100% rename from content/event/example/featured.jpg rename to content/events/example/featured.jpg diff --git a/content/event/example/index.md b/content/events/example/index.md similarity index 100% rename from content/event/example/index.md rename to content/events/example/index.md diff --git a/content/projects.md b/content/projects/_index.md similarity index 95% rename from content/projects.md rename to content/projects/_index.md index 3447b6a..45fba71 100644 --- a/content/projects.md +++ b/content/projects/_index.md @@ -15,7 +15,7 @@ sections: text: I enjoy making things. Here are a selection of projects that I have worked on over the years. filters: folders: - - project + - projects design: view: article-grid fill_image: false diff --git a/content/project/pandas/featured.png b/content/projects/pandas/featured.png similarity index 100% rename from content/project/pandas/featured.png rename to content/projects/pandas/featured.png diff --git a/content/project/pandas/index.md b/content/projects/pandas/index.md similarity index 100% rename from content/project/pandas/index.md rename to content/projects/pandas/index.md diff --git a/content/project/pytorch/featured.png b/content/projects/pytorch/featured.png similarity index 100% rename from content/project/pytorch/featured.png rename to content/projects/pytorch/featured.png diff --git a/content/project/pytorch/index.md b/content/projects/pytorch/index.md similarity index 100% rename from content/project/pytorch/index.md rename to content/projects/pytorch/index.md diff --git a/content/project/scikit/featured.png b/content/projects/scikit/featured.png similarity index 100% rename from content/project/scikit/featured.png rename to content/projects/scikit/featured.png diff --git a/content/project/scikit/index.md b/content/projects/scikit/index.md similarity index 100% rename from content/project/scikit/index.md rename to content/projects/scikit/index.md diff --git a/content/publication/_index.md b/content/publications/_index.md similarity index 100% rename from content/publication/_index.md rename to content/publications/_index.md diff --git a/content/publication/conference-paper/cite.bib b/content/publications/conference-paper/cite.bib similarity index 100% rename from content/publication/conference-paper/cite.bib rename to content/publications/conference-paper/cite.bib diff --git a/content/publication/conference-paper/conference-paper.pdf b/content/publications/conference-paper/conference-paper.pdf similarity index 100% rename from content/publication/conference-paper/conference-paper.pdf rename to content/publications/conference-paper/conference-paper.pdf diff --git a/content/publication/conference-paper/featured.jpg b/content/publications/conference-paper/featured.jpg similarity index 100% rename from content/publication/conference-paper/featured.jpg rename to content/publications/conference-paper/featured.jpg diff --git a/content/publication/conference-paper/index.md b/content/publications/conference-paper/index.md similarity index 100% rename from content/publication/conference-paper/index.md rename to content/publications/conference-paper/index.md diff --git a/content/publication/journal-article/cite.bib b/content/publications/journal-article/cite.bib similarity index 100% rename from content/publication/journal-article/cite.bib rename to content/publications/journal-article/cite.bib diff --git a/content/publication/journal-article/featured.jpg b/content/publications/journal-article/featured.jpg similarity index 100% rename from content/publication/journal-article/featured.jpg rename to content/publications/journal-article/featured.jpg diff --git a/content/publication/journal-article/index.md b/content/publications/journal-article/index.md similarity index 100% rename from content/publication/journal-article/index.md rename to content/publications/journal-article/index.md diff --git a/content/publication/preprint/featured.jpg b/content/publications/preprint/featured.jpg similarity index 100% rename from content/publication/preprint/featured.jpg rename to content/publications/preprint/featured.jpg diff --git a/content/publication/preprint/index.md b/content/publications/preprint/index.md similarity index 98% rename from content/publication/preprint/index.md rename to content/publications/preprint/index.md index 6132e00..7ff6461 100644 --- a/content/publication/preprint/index.md +++ b/content/publications/preprint/index.md @@ -73,7 +73,7 @@ projects: slides: "" --- -This work is driven by the results in my [previous paper](/publication/conference-paper/) on LLMs. +This work is driven by the results in my [previous paper](/publications/conference-paper/) on LLMs. {{% callout note %}} Create your slides in Markdown - click the *Slides* button to check out the example. diff --git a/go.mod b/go.mod index 14a2533..0b54845 100644 --- a/go.mod +++ b/go.mod @@ -3,6 +3,6 @@ module github.com/HugoBlox/hugo-blox-builder/starters/academic-cv go 1.19 require ( - github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-netlify v0.0.0-20231109145828-d9695efa098f - github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind v0.0.0-20250917021738-d5d2f04c2d97 + github.com/HugoBlox/hugo-blox-builder/modules/blox-plugin-netlify v1.1.2 + github.com/HugoBlox/hugo-blox-builder/modules/blox-tailwind v0.8.0 )