tiennm99/HugoBlox-kit
1
0 Fork 0
mirror of https://github.com/tiennm99/HugoBlox-kit.git synced 2026-10-20 02:16:40 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
HugoBlox-kit/templates/data-science-blog/README.md
T
George Cushen a034cf7dbe docs: edit
2026-04-29 10:29:48 +01:00

239 lines
10 KiB
Markdown
Raw Permalink Blame History

# [The Technical Blog That Builds Your Reputation](https://github.com/HugoBlox/hugo-theme-data-science-blog)
[![Screenshot](.github/preview.png)](https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=preview)
<!-- TODO: Replace with a short demo video showing Hugo Chat generating a blog post -->
<!-- https://github.com/user-attachments/assets/REPLACE_ME -->
<h1 align="center">Publish Notebooks, Not Screenshots</h1>
<p align="center">
<strong>Your analysis deserves better than a Medium post.</strong><br/>
Publish Jupyter notebooks, LaTeX equations, and code-heavy articles as beautiful blog posts — with proper metadata, syntax highlighting, and SEO. All from Markdown files you own.<br/>
Built on <a href="https://github.com/HugoBlox/kit">HugoBlox</a> — the open-source framework where AI generates your pages and you own everything as Markdown.
</p>
<p align="center">
<a href="https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=cta_top"><b>Deploy Free (60s)</b></a>
&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://hugo.chat/?utm_source=github&utm_medium=readme&utm_content=cta_top_data-science-blog"><b>Customize with AI</b></a>
&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=demo">Live Demo</a>
</p>
<div align="center">
<a href="https://github.com/HugoBlox/hugo-theme-data-science-blog">
<img src="https://img.shields.io/github/stars/HugoBlox/hugo-theme-data-science-blog?label=Star&logo=github&style=flat-square&color=181717" alt="GitHub Stars">
</a>
<a href="https://discord.gg/z8wNYzb">
<img src="https://img.shields.io/discord/722225264733716590?label=Discord&logo=discord&logoColor=white&style=flat-square&color=5865F2" alt="Discord">
</a>
<a href="https://github.com/HugoBlox/kit">
<img src="https://img.shields.io/github/stars/HugoBlox/kit?label=HugoBlox&logo=github&style=flat-square&color=181717" alt="HugoBlox Stars">
</a>
</div>
<p align="center">
<sub>Part of the <a href="https://github.com/HugoBlox/kit"><strong>HugoBlox</strong></a> ecosystem · <strong>150,000+</strong> sites · Rated <strong>4.9/5</strong> (official survey) · Since <strong>2016</strong></sub>
</p>
---
## Why This Template?
Most blogging platforms butcher code formatting, strip metadata, and lock your content in a database. This is a **technical blog built for people who write code**, not just about it:
- **Data scientists & ML engineers** who want to publish Jupyter notebooks as blog posts — code, outputs, and narrative intact
- **Technical writers** who need proper syntax highlighting, LaTeX math, and Mermaid diagrams
- **Researchers** publishing analyses with citations, BibTeX references, and reproducible content
- **Developers** who want a blog that loads fast, ranks well, and doesn't cost $20/month to host
> *"I moved my blog from Medium to this template and my organic traffic doubled in three months. Turns out owning your own domain and having proper SEO metadata makes a difference."*
> — **Priya Sharma**, Senior Data Scientist
> *"I publish my Jupyter notebooks directly as blog posts. No screenshots of code, no copy-paste formatting disasters. Just drop the .ipynb and it renders beautifully."*
> — **Tom Eriksson**, ML Engineer, Stockholm
<p align="center">
<a href="https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=cta_mid">
<img src="https://img.shields.io/badge/⚡️%20Deploy%20Your%20Blog%20in%2060s-7c3aed?style=for-the-badge" alt="Deploy this template" width="400">
</a>
</p>
---
## Features
| Feature | Benefit |
| :--- | :--- |
| **Jupyter & RMarkdown** | Publish `.ipynb` notebooks as beautiful posts — code, outputs, and narrative intact. |
| **LaTeX math** | Native rendering for equations and technical writing. Drop in `$E=mc^2$` and it just works. |
| **Syntax highlighting** | 100+ languages with proper code blocks. No screenshots of your IDE. |
| **Mermaid diagrams** | Flowcharts, sequence diagrams, and architecture drawings in text. |
| **Tags, categories & authors** | Organize posts with structured metadata. Multi-author support included. |
| **SEO & AI-ready** | Optimized for search engines and LLMs — your work gets found and recommended. |
| **AI page generation** | Describe what you need to [Hugo Chat](https://hugo.chat/?utm_source=github&utm_medium=readme&utm_content=features_data-science-blog) — get structured pages with correct front matter instantly. |
| **Visual editor** | Drag-and-drop blocks in VS Code with [Ownable CMS](https://marketplace.visualstudio.com/items?itemName=ownable.ownable). No coding needed. |
| **Plain Markdown** | Every file is human-readable. No database, no lock-in, take your content anywhere. |
| **Free hosting** | Deploy to GitHub Pages, Netlify, Vercel, or Cloudflare — all free tier. |
---
## 🚀 Get Started
### Step 1: Deploy Your Site
**Option A: Launch in browser** (fastest — no install needed)
> [!TIP]
> Deploy a live site in 60 seconds — no software to install:
> [**Deploy Data Science Blog free**](https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=get_started)
**Option B: Use the CLI**
```bash
# Requires Hugo Extended & Node.js
npx hugoblox create site --template data-science-blog
```
### Step 2: Customize With AI + Visual Editing
<table>
<tr>
<td width="50%">
**✨ Hugo Chat** — AI customization
Tell Hugo Chat what you want in plain English. It generates structured pages with the right front matter, shortcodes, and blocks for this template.
> *"Create a blog post about fine-tuning LLMs with a code walkthrough and results section"*
[**Try Hugo Chat — free**](https://hugo.chat/?utm_source=github&utm_medium=readme&utm_content=step2_data-science-blog)
</td>
<td width="50%">
**Ownable CMS** — visual editing in VS Code
1. Install [Ownable CMS](https://marketplace.visualstudio.com/items?itemName=ownable.ownable)
2. Open your project in VS Code
3. Click the Ownable icon to start editing visually
</td>
</tr>
</table>
![Ownable CMS in Action](https://raw.githubusercontent.com/HugoBlox/kit/main/.github/media/studio/slide-1.webp)
*Ownable CMS: Drag-and-drop page builder inside VS Code.*
> [!NOTE]
> **New to Hugo?** No problem. You don't need to know Hugo — edit visually or write Markdown. Hugo is the engine under the hood that makes your site fast, secure, and free to host. [Learn more →](https://docs.ownable.dev/?utm_source=github&utm_medium=readme&utm_content=docs_data-science-blog)
---
## 💎 Go Premium
Love the free version? **Blog Pro** takes it further:
- Premium designs that make your content stand out
- Advanced post layouts and reading experience
- Enhanced category and series navigation
- Remove attribution, priority support
| | **Data Science Blog** (Free) | **Blog Pro** |
| :--- | :---: | :---: |
| Design | Clean & professional | **Premium designs** |
| Post layouts | Standard | **Advanced layouts** |
| Navigation | Tags & categories | **Series & collections** |
| Support | Community | **Priority** |
<p align="center">
<a href="https://hugoblox.com/pricing?utm_source=github&utm_medium=readme&utm_content=premium_data-science-blog"><b>Compare plans</b></a>
&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://hugoblox.com/templates/blog-pro?utm_source=github&utm_medium=readme&utm_content=premium_deploy_data-science-blog"><b>Deploy Blog Pro</b></a>
</p>
---
## 🏆 Why HugoBlox?
> *Why not just use WordPress, Webflow, or an AI builder like Lovable?*
| | **AI builders** (Lovable, v0) | **CMS platforms** (WordPress, Webflow) | **HugoBlox** |
| :--- | :---: | :---: | :---: |
| AI generates your pages | Yes | No | **Yes** |
| You own the output as readable files | No — React code | No — database | **Yes — Markdown** |
| Free to host forever | No | No | **Yes** |
| Human-editable without the tool | Barely | No | **Yes — it's Markdown** |
| Open source | No | No | **Yes — MIT licensed** |
> [!IMPORTANT]
> Your content is plain Markdown files. No lock-in, no database, no vendor dependency. If you ever want to leave, take your files and go.
---
## FAQ
<details>
<summary><b>Do I need to know Hugo?</b></summary>
No. Edit visually with Ownable CMS or write Markdown. Hugo is the build engine — you don't need to touch it.
</details>
<details>
<summary><b>Can I publish Jupyter notebooks directly?</b></summary>
Yes. Drop a <code>.ipynb</code> file into your content folder and it renders as a blog post with code cells, outputs, and narrative intact.
</details>
<details>
<summary><b>Can I migrate from Medium or WordPress?</b></summary>
Yes. Export your posts as Markdown (tools exist for both platforms) and drop them into the content folder. Your site is just Markdown files.
</details>
<details>
<summary><b>Can I host for free?</b></summary>
Yes. GitHub Pages, Netlify, Vercel, and Cloudflare Pages all have free tiers for static sites.
</details>
<details>
<summary><b>What's Hugo Chat?</b></summary>
An AI assistant trained on Hugo and HugoBlox docs. Describe what you want and it generates the right pages with correct front matter. <a href="https://hugo.chat/?utm_source=github&utm_medium=readme&utm_content=faq_data-science-blog">Free to try.</a>
</details>
<details>
<summary><b>Can I cancel Pro anytime?</b></summary>
Yes. No questions asked.
</details>
---
<h2 align="center">🚀 Ready to launch?</h2>
<p align="center">
Deploy in 60 seconds. Customize with AI. Own it as Markdown forever.
</p>
<p align="center">
<a href="https://hugoblox.com/templates/data-science-blog?utm_source=github&utm_medium=readme&utm_content=cta_final"><b>Deploy Data Science Blog — free</b></a>
&nbsp;&nbsp;|&nbsp;&nbsp;
<a href="https://hugo.chat/?utm_source=github&utm_medium=readme&utm_content=cta_final_data-science-blog"><b>Customize with AI</b></a>
</p>
---
## Community & Support
- 💬 [**Discord**](https://discord.gg/z8wNYzb) — ask questions, share your site
- 📚 [**Docs**](https://docs.ownable.dev/?utm_source=github&utm_medium=readme&utm_content=community_data-science-blog)
- ⭐ [**Star HugoBlox**](https://github.com/HugoBlox/kit) — help others find it
- 🐦 [**Follow on X**](https://x.com/GoOwnable)
### Sponsors
[**❤️ Sponsor on GitHub**](https://github.com/sponsors/gcushen) | [**🏢 Become a Partner**](https://github.com/sponsors/gcushen)
---
MIT © 2016-present [**Lore Labs**](https://lore.tech/?utm_source=github&utm_medium=readme)
Reference in new issue View Git Blame Copy Permalink