chore(templates): update modules to latest commits
This commit is contained in:
@@ -8,6 +8,21 @@ tags:
|
||||
- Hugo
|
||||
- Hugo Blox
|
||||
- Markdown
|
||||
cover:
|
||||
image: "https://images.unsplash.com/photo-1557682250-33bd709cbe85?q=80&w=2560"
|
||||
position:
|
||||
x: 50
|
||||
y: 40
|
||||
overlay:
|
||||
enabled: true
|
||||
type: "gradient"
|
||||
opacity: 0.4
|
||||
gradient: "bottom"
|
||||
fade:
|
||||
enabled: true
|
||||
height: "80px"
|
||||
icon:
|
||||
name: "✨"
|
||||
image:
|
||||
caption: 'Image credit: [**Unsplash**](https://unsplash.com)'
|
||||
---
|
||||
|
||||
@@ -8,6 +8,22 @@ date: 2023-10-27
|
||||
image:
|
||||
caption: 'Image credit: [**Unsplash**](https://unsplash.com)'
|
||||
|
||||
cover:
|
||||
image: "https://images.unsplash.com/photo-1557682250-33bd709cbe85?q=80&w=2560"
|
||||
position:
|
||||
x: 50
|
||||
y: 40
|
||||
overlay:
|
||||
enabled: true
|
||||
type: "gradient"
|
||||
opacity: 0.4
|
||||
gradient: "bottom"
|
||||
fade:
|
||||
enabled: true
|
||||
height: "80px"
|
||||
icon:
|
||||
name: "✨"
|
||||
|
||||
authors:
|
||||
- admin
|
||||
- Ted
|
||||
@@ -41,7 +57,7 @@ Welcome 👋
|
||||
- 👉 [**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)
|
||||
- 🐦 Twitter: [@GetResearchDev](https://x.com/BuildLore) [@GeorgeCushen](https://twitter.com/GeorgeCushen) #MadeWithHugoBlox
|
||||
- 🐦 Twitter: [@BuildLore](https://x.com/BuildLore) [@GeorgeCushen](https://x.com/GeorgeCushen) #MadeWithHugoBlox
|
||||
- 💡 [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)
|
||||
|
||||
|
||||
BIN
content/blog/notebook-onboarding/cover.jpg
Normal file
BIN
content/blog/notebook-onboarding/cover.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 220 KiB |
BIN
content/blog/notebook-onboarding/featured.jpg
Normal file
BIN
content/blog/notebook-onboarding/featured.jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 114 KiB |
161
content/blog/notebook-onboarding/hugoblox-onboarding.ipynb
Normal file
161
content/blog/notebook-onboarding/hugoblox-onboarding.ipynb
Normal file
@@ -0,0 +1,161 @@
|
||||
{
|
||||
"cells": [
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "2f21e4c5",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"# Ship Notebook Stories in Minutes\n",
|
||||
"Hugo Blox Notebook renderer turns your `.ipynb` experiments into beautiful long-form posts.\n",
|
||||
"Use this sample to see how markdown, code, and outputs flow together."
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "3078072c",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"1. Drop notebooks inside `assets/notebooks/` (or import them as page resources).\n",
|
||||
"2. Reference them with `{{</* notebook src=\"your.ipynb\" */>}}`.\n",
|
||||
"3. Control code, outputs, metadata badges, and download links via shortcode params."
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 1,
|
||||
"id": "7b29b28a",
|
||||
"metadata": {
|
||||
"tags": [
|
||||
"demo",
|
||||
"quickstart"
|
||||
]
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
"name": "stdout",
|
||||
"output_type": "stream",
|
||||
"text": [
|
||||
"Collecting data...\n",
|
||||
"Training notebook-ready block...\n",
|
||||
"Done!\n"
|
||||
]
|
||||
},
|
||||
{
|
||||
"data": {
|
||||
"text/plain": [
|
||||
"0.982"
|
||||
]
|
||||
},
|
||||
"execution_count": 1,
|
||||
"metadata": {},
|
||||
"output_type": "execute_result"
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"import math\n",
|
||||
"accuracy = 0.982\n",
|
||||
"print(\"Collecting data...\")\n",
|
||||
"print(\"Training notebook-ready block...\")\n",
|
||||
"print(\"Done!\")\n",
|
||||
"accuracy"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 2,
|
||||
"id": "ceecfe89",
|
||||
"metadata": {},
|
||||
"outputs": [
|
||||
{
|
||||
"data": {
|
||||
"text/html": [
|
||||
"<div style='font-family:Inter,ui-sans-serif;'><strong>Launch Readiness:</strong> <span style='color:#22c55e;'>98.2% confidence</span><br><em>Notebook blocks are theme-aware and dark-mode friendly.</em></div>"
|
||||
],
|
||||
"text/plain": [
|
||||
"<IPython.core.display.HTML object>"
|
||||
]
|
||||
},
|
||||
"metadata": {},
|
||||
"output_type": "display_data"
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"from IPython.display import HTML\n",
|
||||
"HTML(\"<div style='font-family:Inter,ui-sans-serif;'><strong>Launch Readiness:</strong> <span style='color:#22c55e;'>98.2% confidence</span><br><em>Notebook blocks are theme-aware and dark-mode friendly.</em></div>\")"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "code",
|
||||
"execution_count": 3,
|
||||
"id": "664e49ca",
|
||||
"metadata": {
|
||||
"tags": [
|
||||
"metrics"
|
||||
]
|
||||
},
|
||||
"outputs": [
|
||||
{
|
||||
"data": {
|
||||
"application/json": {
|
||||
"metrics": {
|
||||
"engagement_rate": 0.73,
|
||||
"read_time_minutes": 4.6,
|
||||
"subscribers": 1280
|
||||
}
|
||||
},
|
||||
"text/plain": [
|
||||
"{'metrics': {'engagement_rate': 0.73, 'read_time_minutes': 4.6, 'subscribers': 1280}}"
|
||||
]
|
||||
},
|
||||
"execution_count": 3,
|
||||
"metadata": {},
|
||||
"output_type": "execute_result"
|
||||
}
|
||||
],
|
||||
"source": [
|
||||
"metrics = {\n",
|
||||
" 'metrics': {\n",
|
||||
" 'engagement_rate': 0.73,\n",
|
||||
" 'read_time_minutes': 4.6,\n",
|
||||
" 'subscribers': 1280\n",
|
||||
" }\n",
|
||||
"}\n",
|
||||
"metrics"
|
||||
]
|
||||
},
|
||||
{
|
||||
"cell_type": "markdown",
|
||||
"id": "0f761ba1",
|
||||
"metadata": {},
|
||||
"source": [
|
||||
"> Tip: Pair this block with Call-to-Action cards or the Embed shortcode to link to GitHub repos, datasets, or ARXIV preprints."
|
||||
]
|
||||
}
|
||||
],
|
||||
"metadata": {
|
||||
"authors": [
|
||||
{
|
||||
"name": "HugoBlox Studio"
|
||||
}
|
||||
],
|
||||
"kernelspec": {
|
||||
"display_name": "Python 3",
|
||||
"language": "python",
|
||||
"name": "python3"
|
||||
},
|
||||
"language_info": {
|
||||
"codemirror_mode": {
|
||||
"name": "ipython",
|
||||
"version": 3
|
||||
},
|
||||
"file_extension": ".py",
|
||||
"mimetype": "text/x-python",
|
||||
"name": "python",
|
||||
"nbconvert_exporter": "python",
|
||||
"pygments_lexer": "ipython3",
|
||||
"version": "3.11"
|
||||
}
|
||||
},
|
||||
"nbformat": 4,
|
||||
"nbformat_minor": 5
|
||||
}
|
||||
70
content/blog/notebook-onboarding/index.md
Normal file
70
content/blog/notebook-onboarding/index.md
Normal file
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: ⚡️ Turn Jupyter Notebooks into Blog Posts
|
||||
summary: Publish your data science and research directly from Jupyter Notebooks. No screenshots required.
|
||||
date: 2024-07-15
|
||||
authors:
|
||||
- admin
|
||||
tags:
|
||||
- Hugo Blox
|
||||
- Jupyter
|
||||
- Open Science
|
||||
- Tutorials
|
||||
cover:
|
||||
# image: cover.jpg # Auto-detected from cover image in this folder
|
||||
icon:
|
||||
name: "📔"
|
||||
image:
|
||||
caption: "Image credit: [HugoBlox](https://hugoblox.com)"
|
||||
focal_point: Center
|
||||
placement: 1
|
||||
content_meta:
|
||||
trending: true
|
||||
---
|
||||
|
||||
As a researcher or data scientist, your work often lives in Jupyter Notebooks. But sharing those insights effectively usually means taking screenshots, messy copy-pasting, or exporting to PDF.
|
||||
|
||||
Hugo Blox changes that. With the `{{</* notebook */>}}` shortcode, you can render your actual `.ipynb` files directly as beautiful, interactive blog posts or project pages. Keep your code, outputs, and narrative in one place.
|
||||
|
||||
{{< toc mobile_only=true is_open=true >}}
|
||||
|
||||
## Why publish notebooks?
|
||||
|
||||
> [!TIP]
|
||||
> **Reproducible Research**: By publishing the actual notebook, you allow others to download and run your code, verifying your results and building upon your work.
|
||||
|
||||
- **No more screenshots** – Render crisp code and vector plots directly from your source.
|
||||
- **Theme consistent** – Notebooks automatically adapt to your site's theme (including dark mode).
|
||||
- **Flexible sourcing** – Display notebooks from your `assets/` folder, page bundles, or even directly from a remote GitHub URL.
|
||||
- **Interactive** – Users can copy code blocks or download the full notebook to run locally.
|
||||
|
||||
## Example: Data Science Workflow
|
||||
|
||||
Below is a live example of a notebook rendered right here in this post. Notice how the markdown, code, and outputs (text, HTML, and JSON) are all preserved and styled.
|
||||
|
||||
{{< notebook
|
||||
src="hugoblox-onboarding.ipynb"
|
||||
title="Launch Readiness Analysis"
|
||||
show_metadata=true
|
||||
line_numbers=true
|
||||
dense=false
|
||||
download_label="Download notebook"
|
||||
show_outputs=true
|
||||
>}}
|
||||
|
||||
## How to add a notebook
|
||||
|
||||
1. **Save your notebook.** Place your `.ipynb` file in `assets/notebooks/` (for global access) or inside a page bundle (like `content/blog/my-post/analysis.ipynb`).
|
||||
2. **Add the shortcode.** In any Markdown page, simply use:
|
||||
`{{</* notebook src="analysis.ipynb" */>}}`
|
||||
3. **Customize.** You can hide code cells for non-technical audiences (`show_code=false`) or just show the output (`show_outputs=true`).
|
||||
|
||||
> [!IMPORTANT]
|
||||
> Hugo Blox respects your privacy. Notebook rendering happens statically at build time—no third-party services required.
|
||||
|
||||
## Next steps
|
||||
|
||||
- **Try it out:** Drop one of your existing notebooks into this site and see how it looks.
|
||||
- **Link your papers:** Use the Embed shortcode to link your notebook to your latest arXiv preprint or GitHub repository.
|
||||
- **Get help:** Join the community on [Discord](https://discord.gg/z8wNYzb) or check the [documentation](https://docs.hugoblox.com).
|
||||
|
||||
Happy researching! 🚀
|
||||
@@ -9,6 +9,21 @@ tags:
|
||||
- Markdown
|
||||
image:
|
||||
caption: 'Image credit: [**Unsplash**](https://unsplash.com)'
|
||||
cover:
|
||||
image: "https://images.unsplash.com/photo-1557682250-33bd709cbe85?q=80&w=2560"
|
||||
position:
|
||||
x: 50
|
||||
y: 40
|
||||
overlay:
|
||||
enabled: true
|
||||
type: "gradient"
|
||||
opacity: 0.4
|
||||
gradient: "bottom"
|
||||
fade:
|
||||
enabled: true
|
||||
height: "80px"
|
||||
icon:
|
||||
name: "✨"
|
||||
---
|
||||
|
||||
Easily manage your projects - create ideation mind maps, Gantt charts, todo lists, and more!
|
||||
|
||||
@@ -9,6 +9,21 @@ tags:
|
||||
- Markdown
|
||||
image:
|
||||
caption: 'Image credit: [**Unsplash**](https://unsplash.com)'
|
||||
cover:
|
||||
image: "https://images.unsplash.com/photo-1557682250-33bd709cbe85?q=80&w=2560"
|
||||
position:
|
||||
x: 50
|
||||
y: 40
|
||||
overlay:
|
||||
enabled: true
|
||||
type: "gradient"
|
||||
opacity: 0.4
|
||||
gradient: "bottom"
|
||||
fade:
|
||||
enabled: true
|
||||
height: "80px"
|
||||
icon:
|
||||
name: "✨"
|
||||
---
|
||||
|
||||
Create a personal knowledge base and share your knowledge with your peers.
|
||||
|
||||
@@ -11,6 +11,21 @@ tags:
|
||||
- Markdown
|
||||
image:
|
||||
caption: 'Embed rich media such as videos and LaTeX math'
|
||||
cover:
|
||||
image: "https://images.unsplash.com/photo-1557682250-33bd709cbe85?q=80&w=2560"
|
||||
position:
|
||||
x: 50
|
||||
y: 40
|
||||
overlay:
|
||||
enabled: true
|
||||
type: "gradient"
|
||||
opacity: 0.4
|
||||
gradient: "bottom"
|
||||
fade:
|
||||
enabled: true
|
||||
height: "80px"
|
||||
icon:
|
||||
name: "✨"
|
||||
---
|
||||
|
||||
[Hugo Blox Builder](https://hugoblox.com) is designed to give technical content creators a seamless experience. You can focus on the content and the Hugo Blox Builder which this template is built upon handles the rest.
|
||||
|
||||
Reference in New Issue
Block a user