Adjabkhanian

Example Talk

Sat, 01 Jun 2030 13:00:00 +0000

Click on the Slides button above to view the built-in slides feature.

Slides can be added in a few ways:

Create slides using Hugo Blox Builder’s Slides feature and link using slides parameter in the front matter of the talk file
Upload an existing slide deck to static/ and link using url_slides parameter in the front matter of the talk file
Embed your slides (e.g. Google Slides) or presentation video on this page using shortcodes.

Further event details, including page elements such as image galleries, can be added to the body of this page.

PulseVPN-X

Wed, 28 Jan 2026 00:00:00 +0000

🔐 PulseVPN-X — VPN via Telegram in 1 Minute

PulseVPN-X is a high-speed WireGuard VPN delivered entirely through Telegram.

No dashboards.
No manual configuration.
No technical knowledge required.

Open the bot → press a button → scan QR → connected.

⚡ Performance

Built on pure WireGuard with optimized server routing.

In real-world usage PulseVPN-X performs up to 3x faster than HitVPN,
while keeping connection stable and latency low.

Fast handshake.
Minimal overhead.
Clean routing.

💳 Simple Payments

⭐ Telegram Stars integration
🪙 Optional crypto payments
🎁 One-click trial activation

Stars payments make it extremely simple: no external gateways, no card forms — just Telegram native checkout.

Affordable pricing with instant activation.

👉 Launch the bot:
https://t.me/pulsevpnx_bot

🎯 Goal

Create a VPN service where:

setup takes less than a minute
every user gets one secure personal config
subscription logic is automated
admin has full visibility of active peers
expired users are revoked automatically

✅ Implemented Features

⚡ WireGuard-based VPN
📲 QR + config file delivery
🎁 Trial period (button-based activation)
💳 Telegram Stars payments
🪙 Crypto support (optional)
⏳ Automatic peer revocation on expiration
📡 Live peer monitoring (wg show)
📊 Admin statistics dashboard
🔁 Restore peers on bot restart

🧩 Tech Stack

Python 3.12
Aiogram 3
SQLite (aiosqlite)
WireGuard (wg / wg-quick)
Linux VPS
Systemd service

🖼 Visuals

Hero

Screenshots

🧠 UX Flow

User activates Trial or purchases subscription
Presses “Get Config”
Bot generates personal WireGuard peer
User scans QR → enables toggle → connected

Everything happens inside Telegram.

📌 Result

PulseVPN-X transforms VPN setup into a product experience:

Fast.
Minimal.
Controlled.
Scalable.

Telegram becomes the interface. WireGuard becomes the engine.

RealtyHelpReBot — Telegram Bot for Real Estate Assistance

Fri, 10 Oct 2025 00:00:00 +0000

🏙 About the Project

RealtyHelpReBot is a Telegram bot designed to automate real estate selection and handle client applications.
It allows users to choose a city, property type, receive up-to-date offers, and submit applications directly to the manager.

💡 Project Idea

Instead of long phone calls and manual forms, the bot simplifies the process:
clients select their preferences, and the bot automatically generates and sends the application to Google Sheets, where the manager can immediately view it.

The project was developed on a client request for a real estate agency to reduce routine work and speed up client interactions.

🔧 Core Features

🏘 Select city and property type
📩 Submit application to Google Sheets
🧠 Smart welcome message — admins can change text and photo via JSON
👨‍💼 Notify manager about new applications
⚙️ Flexible welcome message configuration without changing code

⚙️ Technologies Used

Area	Technologies
Programming	Python 3.9
Framework	Aiogram 3
Database/API	Google Sheets API (via gspread)
Hosting	Local server / Railway
Configuration	JSON + dotenv

📁 Project Structure

realtyhelprebot/
│
├── main.py            # Main bot logic
├── config.py          # Settings and tokens
├── data/start_data.json  # Dynamic welcome message (text + photo)
├── utils/
│   └── google_api.py  # Google Sheets integration
└── requirements.txt   # Dependencies

🔗 Bot Link

👉 @AN_MowKznRussia_bot

🧩 Code Preview

The main bot logic can be found here:
main.py — contains the implementation of all bot scenarios, including dynamic welcome messages, form processing, and Google Sheets integration.

💬 Conclusion

RealtyHelpReBot is a practical tool for real estate agencies.
It saves managers time and makes client communication smooth and modern.

The bot can be easily adapted for other niches — from rentals to consultations.
If you want a similar project for your business, just contact me 😉

Telegram Bot “Dialog of Truth”

Tue, 15 Jul 2025 00:00:00 +0000

🧠 Project Idea

This Telegram bot was developed for the spiritual and educational initiative “Dialog of Truth” to:

Automate contact collection from Instagram users
Understand participant motivation through a short survey
Enable admins to broadcast messages to the entire database
Seamlessly integrate with Airtable

🔍 What Does the Bot Do?

A user joins the bot via a link from Instagram
They are asked to provide:
- 📱 Phone number (via a button)
- 📧 Email address
- 👤 First and last name
- ❓ Answer to: “Do you want religious knowledge?”
The bot saves all the data to Airtable
Sends a link to the main Telegram channel
The admin can send a broadcast with the /sendall command

📊 Survey Inside the Bot

Do you want religious knowledge?
• To receive and apply it for myself
• To receive, apply, and share it with others
• I just want to observe for now

All responses are also saved in Airtable.

🛠 Technologies Used

Python 3.11
Aiogram 3.x — asynchronous Telegram bot framework
Airtable — external database for storing structured user data
Railway — deployment without exposing tokens (via ENV)
GitHub — source code is private, available upon request

🖼 Project Cover

📂 Airtable Data Structure

Telegram ID
Username
Phone
Email
First Name
Last Name
Survey Answer
Registration Date

📦 Admin Features

✅ /sendall Hello! — sends a message to all users
🔐 Only specified Telegram IDs can broadcast
🧑‍💻 All collected data is stored in Airtable and can be exported easily

💡 Who Is This For?

Online schools and educational communities
Projects growing from Instagram or Telegram
Small teams without complex CRM systems

📥 How to Deploy

Create an Airtable base with the required fields
Add secret variables in Railway:
- BOT_TOKEN
- AIRTABLE_API_KEY
- AIRTABLE_BASE_ID
- AIRTABLE_TABLE_NAME
Deploy the bot on Railway
Connect a domain and share the link in your Instagram bio

🎯 Results

A clean Telegram-based form that acts as a mini landing page
All user data in Airtable for future communication and analysis
Quick survey for audience segmentation

📎 Want to Collaborate?

If you want to create a custom Telegram bot for your project —
Contact me →

🛠 Additional Resources

Telegram Subscription Management Bot

Sat, 21 Jun 2025 00:00:00 +0000

Project Overview

This Telegram bot was created for my client — an educational club aiming to simplify the subscription and management process.

The bot allows users to:

Choose subscription periods (1, 3, 6, or 12 months)
Submit payment confirmation (screenshot)
Receive a link to a private group after payment approval
Access personal cabinet with subscription details

Administrators have handy tools for:

Approving or denying payments
Viewing subscriber lists and subscription statuses
Cancelling subscriptions
Broadcasting messages to all subscribers
Searching users by username

Target Audience

Educational clubs and courses looking to automate subscription processes
Small businesses working with paid access via Telegram
Admins on a budget who want a simple and reliable bot

Technologies Used

Python 3.11+ — primary programming language
Aiogram — asynchronous framework for Telegram bots
SQLite — lightweight built-in database for subscriber storage
Asynchronous programming — efficient request handling without blocking

Key Features

User interaction via friendly keyboards and finite state machine (FSM)
Admin panel protected by a list of admins (supports multiple admins)
Automatic reminders 2 days before subscription expiration
Access control to private group: the bot bans/unbans Telegram users accordingly

Bot Screenshots

Main menu with action choices

Subscription flow and period selection

Admin menu for subscription management

How to Run

Requires Python 3.11+ installed
Install dependencies from requirements.txt
Set the TOKEN environment variable with your Telegram bot token
Run the bot using:
For continuous operation, deploy the bot on a server or cloud (Heroku, VPS, etc.)

Repository

GitHub

If interested or want to customize it further — feel free to contact me!

UBORKA Bot — Cleaning Management Automation

Tue, 10 Jun 2025 00:00:00 +0000

About the Project

UBORKA Bot is a project aimed at automating the distribution of cleaning tasks within a team. Using a Telegram bot, users receive reminders, mark task completion, and help maintain order in the group.

📋 Features

Task automation: Assigning cleaning duties to groups at scheduled times.
Interactivity: Users confirm task completion via Telegram.
Flexibility: Group shifts are automatically managed.
Scheduler: Uses APScheduler library for regular reminders.

📦 Technologies

Programming language: Python
Telegram API: Bot interaction via aiogram library
Scheduler: APScheduler for task scheduling
Hosting: Railway

🛠️ Key Functions

1. Reminder Broadcast

Daily notifications sent specifying which group should clean the computers.

2. Interactive Feedback

After cleaning, participants press the “✅ Done” button to confirm completion.

3. Reporting

The bot records who completed the task by adding the user’s name to the message.

🎯 Results

Improved discipline: Clear task assignments.
Time saving: No manual reminders needed.
Ease of use: Users interact via a convenient Telegram interface.

📅 Development Stages

Creating task logic
Bot development using aiogram
Scheduler integration
Deployment on Railway
Testing and launch

📸 Project Screenshots

Cleaning reminder with task completion confirmation.

Telegram bot interface for confirming cleaning.

🌐 Links

GitHub repository

💡 Conclusion

The UBORKA Bot project demonstrated how simple tasks can be effectively automated. This solution can be adapted for other purposes like event management, duty assignments, and more.

If you have ideas needing automation, I’m ready to build a user-friendly Telegram bot for you!

📩 Contact Me

Email: adjabkhanian@gmail.com
Telegram: @adjabkhanyan

ZarplataBot — Telegram Bot for Shift, Bar, and Report Management

Mon, 09 Jun 2025 00:00:00 +0000

🔍 About the Project

ZarplataBot is a Telegram bot designed to automate financial tracking in small teams such as baristas, shift workers, support staff, and administrators. It replaces manual spreadsheet entries and helps track:

💼 Work shifts (day and night)
🍷 Bar income with dynamic percentages
💸 Expenses with comments
🚫 Fines and deductions
📊 Monthly reports with filtering

The project was developed as a personal internal automation solution but can scale to any team.

💡 Why I created this?

Working in a team where tracking was often done manually, I noticed:

Shift records were forgotten
Expenses got lost
Income was estimated roughly
Reports had to be collected piecemeal

To remove routine and errors, I decided to automate the process via Telegram, which everyone uses daily.

🔧 Features

🕑 Adding shifts: day or night (with fixed rates)
🍷 Bar accounting: income percentage depends on the amount (dynamic)
- up to 3500 — 5%
- 3500 to 4000 — 6%
- 4000 to 4500 — 7%
- …
- from 10,000 — 15%
💸 Entering expenses with comments (e.g., “300 food”)
🚫 Fines with explanations (“500 late”)
📊 Monthly reports — current, previous, and manually selected
🗃 All data stored in Airtable — easy manual editing
⏱ Instant response — via Telegram bot, no need to open spreadsheets

🔌 Integrations

Telegram Bot API — user communication
Airtable API — database editable manually if needed
SQLite — local storage fallback
Railway — deployment and 24/7 uptime
GitHub — project storage and updates

🚀 Deployment

The bot is deployed on Railway, allowing 24/7 operation without relying on local machines. Code updates are done by git push to GitHub, and Railway automatically rebuilds and restarts the bot.

🖼 Interface

Users interact with the bot via buttons:

▶️ Start
🕑 Day / 🌙 Night shift
🍷 Bar
💸 Expense
🚫 Fine
📊 Report

Each action is accompanied by confirmations and interactive messages. The interface is adapted to Telegram UX.

🛠 Technologies Used

Area	Technologies
Language	Python 3.11
Framework	Aiogram 3
APIs	Telegram Bot API, Airtable REST
Hosting	Railway
Storage	SQLite + Airtable
CI/CD	GitHub + Railway Integration

📦 Project Repository

Code available on GitHub:

👉 github.com/adjabkhanian/zarplata-bot

📈 Future Plans

User authorization
Google Sheets integration
PDF reports
Analytics with charts
Admin panel via web interface

💬 Conclusion

ZarplataBot is not just a bot but a working tool for accounting and transparency. It removes chaos and makes routine pleasant.

If you want to adapt this bot for your team — contact me 😉

Infographics for W Furniture Studio / Avito Packs

Thu, 29 May 2025 00:00:00 +0000

A clean, responsive landing page for a supplier of building materials with fast delivery of bulk materials such as sand, gravel, and more.

🚀 Telegram Bot for Task Management with Airtable

Fri, 16 May 2025 00:00:00 +0000

📱 Telegram Bot for Field Tasks

Project: a smart Telegram bot that helps field teams efficiently complete tasks and report on them in just a few clicks.

❓ Why do you need this bot?

Many companies face problems like:

🚫 Tasks get lost, employees forget to report
📉 Managers find it hard to track task status
🕒 Photo reports are collected manually and slowly

Solution: a bot that handles it all. Simple, fast, and clear.

⚙️ How does it work?

👤 Employee starts /start, selects their role and enters their name
🔘 Gets a “Go to tasks” button
🗺️ Selects a region (e.g., “North” or “Center”)
📋 Sees a task list:
- 🔧 Fix the network
- 📶 Install Wi-Fi
📸 Clicks “Complete task” and sends a photo report
🤖 Bot:
- saves the photo and executor’s name
- 💾 updates Airtable
- sends “✅ Task completed”
- automatically returns to region selection

🌟 Why is this convenient?

Features:

🧠 FSM: bot “remembers” user’s current step
🖱️ Intuitive buttons: “Back,” “Select region,” “Complete”
🎨 Emojis: add visual logic and make interaction pleasant
📷 Photo required: task cannot be completed without a photo
☁️ Airtable link: tasks live in the cloud and update in real time
🔄 Auto navigation: no manual return needed — bot does it automatically

📊 Airtable as a database

Uses an Airtable base where:

🗂️ Tasks are stored by roles and locations
📸 Photos and executor names are saved
✔️ Status updates after task completion

Integration via API — everything happens automatically.

🚚 Where is it useful?

📦 Courier services
🛠️ Installation teams
👷 Engineers and service teams
🏢 Internal company task management

💡 Advantages of the solution

🖱️ Minimal clicks — maximum results
📲 No separate app needed — works in Telegram
🌍 Scalable and flexible
👥 Easy to add new employees

🖥️ 24/7 Deployment

Bot hosted on a server:

🌐 VPS rental (e.g., Timeweb Cloud)
🐍 Installing Python, Git, pip
📂 Cloning the code repository
⚙️ Setting up .env file with keys
▶️ Running: python3 main.py
📟 Using tmux — bot works even when terminal is closed

📩 Want a bot like this?

Write to us — and we’ll automate your team’s tasks together!

Contact:

Telegram: @adjabkhanian
Email: adjabkhanian@gmail.com

⚡ Automate tasks. Free up time. Grow faster.

Website for Selling and Delivering Bulk Construction Materials

Tue, 08 Apr 2025 00:00:00 +0000

A clean, mobile-friendly landing page for a construction supplier offering fast delivery of bulk materials like sand, gravel, and more.

Week Summary: Studies, Work, and New Achievements

Tue, 01 Apr 2025 12:00:00 +0000

Week Summary 🎯

The past week was productive and eventful. I worked on several projects, made progress in my studies, and found time for personal development. 🔥

📚 Studies

This week, the main focus was on:

Mathematical Analysis – studying series and their convergence, solving complex problems.
Programming – writing code in Python, working with algorithms and data structures.
Databases – studying SQL queries and query optimization.

💼 Work

Worked at Colizeum, carrying out standard duties:

Monitored the equipment and gaming systems.
Ensured order in the hall and maintained the PCs in good working condition.
Handled customer requests and managed booking systems.

🚀 Personal Projects and Development

Improved my profile on freelancing platforms and continued searching for orders.
Developed a strategy for attracting investors for the business.
Started developing a landing page for a new project, experimenting with animations in Tilda.

🔥 Life Hacks of the Week

Clear Planning – broke down tasks for the day, which helped avoid procrastination.
Mastering New Tools – explored advanced SQL features and working with Django.
Competitor Analysis – studied how other freelancers work, what projects are popular, and the mistakes they make.

🎯 Conclusion

The week was productive and diverse. New goals were set, promising projects were started, and self-development continues! 🚀

My portfolio on Behance

How to Format a Report: Best Practices and Tips

Tue, 01 Apr 2025 00:00:00 +0000

📑 How to Format a Report: Best Practices and Tips

A report is not just a document; it is an important tool for transmitting information. Proper formatting helps make it clear, structured, and professional. Let’s go over the key principles for preparing a quality report. 📋

📌 Key Principles for Report Formatting:

1. Clear Structure

Divide the report into logical sections: introduction, main body, analysis, and conclusions.

Example structure:

# Project Report
## Introduction
- Objective of the work
- Main tasks

## Main Body
### Data Analysis
- Process and method description
- Technologies used

## Conclusion
- Summary and recommendations

### 2. Visual presentation
- Use **bold text** and *italics* to highlight important points.
- Include **tables** to present data easily.
- Add **graphs and charts** for clarity.

Table example:
md
| Stage | Activities | Time |
|------|---------|-------|
| 1 | Data collection | 3 days |
| 2 | Data analysis | 2 days |
| 3 | Final conclusion | 1 day |

### 3. Minimalism and readability
- Use short paragraphs.
- Leave spaces between blocks.
- Avoid complex wording and overloaded phrases.

### 4. Check for errors
Before sending the report:
✅ Double-check the text for grammatical errors.
✅ Make sure the data is logically structured.
✅ Use spell check tools (Grammarly, LanguageTool).

### 5. Heading Design
Use headings of different levels to clearly navigate the report.
md
# Main Heading (H1)
## Subsection (H2)
### Nested Subsection (H3)

## 🔥 Additional Tips
✅ Add a table of contents at the beginning of long reports.
✅ Use readable fonts (Arial, Roboto, Open Sans).
✅ Include links to additional materials and sources.
✅ If the report contains code, format it as blocks:
md
python
print("Sample code in the report")

## 📌 Summary
Following these tips, you will be able to prepare a report that is clear, informative and professionally designed. A good report is the key to a successful presentation of your work! 📝

Weekly Recap: March 17–23

Sun, 23 Mar 2025 13:16:48 +0300

✨ Weekly Recap (March 17–23)

📅 What I accomplished:

✅ Finished a web design project for a client — happy with the result, now waiting for feedback.
💻 Built a landing page on Tilda — fully responsive and followed the brand guidelines.
🎨 Designed several business cards and product cards — clients were satisfied.
📚 Successfully passed a discrete math test — felt great to see the results!
🏋️‍♂️ Went to the gym twice — progress is steady and motivating.
🎮 Worked the weekend shift at Colizeum — busy, energetic, and fun!

🧠 What I learned:

Mastered using grid layouts in Tilda more efficiently.
Explored new ways to showcase a portfolio in Notion.
Improved my skills in typography and spacing — designs feel more clean and professional now.

🔥 Goals for next week:

Launch a mini promo campaign for business card design services.
Update and improve 2 older portfolio projects.
Stick to 3+ workouts during the week.
Develop the Colizeum franchise idea — create a detailed mindmap.

It was a productive and inspiring week.
I’m slowly building the kind of system I want to live and work in.
Let’s keep the momentum going 🚀

📘 What is Markdown and Why Use It?

Sun, 23 Mar 2025 00:00:00 +0000

In the third lab on computer architecture, we got familiar with a lightweight and convenient markup language — Markdown. Its goal is to simplify formatting reports and documentation without the complexity of Word or LaTeX.

🛠 What I Learned

Markdown allows you to:

Create headings using #, ##, ###, and so on
Format text: **bold**, *italic*, ***bold italic***
Make lists:
- Bulleted
- And numbered:
  1. First item
  2. Second item
Add links:
[link example](https://example.com)
Insert images: ![caption](/path/to/image.jpg "tooltip")
Write formulas (like in LaTeX):
$\sin^2(x) + \cos^2(x) = 1$
Add code blocks:
```
git pull
make
```

⚙️ How We Used Markdown in Practice

During the lab, I:

Navigated to the target directory in the terminal:

cd ~/work/study/2023-2024/"Computer Architecture"/labs/lab03/report

Pulled the latest changes from the remote repository:
```
git pull
```
Compiled the report template using make, which generated .pdf and .docx files:
```
make
```
Filled out the report in Markdown format (report.md) and recompiled it:
```
make clean
make
```

Uploaded the result to GitHub:

git add .
git commit -m "feat: add lab3 report in Markdown"
git push

📸 Along the Way…

I added screenshots to the report
Included links to documentation
Wrote formulas and formatted them nicely
Used code blocks to show commands

Markdown makes all of this simple, readable, and clean.

🧠 What I Got From It

I learned how Markdown makes documentation easier.
I found it works great with Git and Pandoc.
With Makefile, I can automate report generation — saves tons of time.
I improved my skills with the terminal and Git — essential tools for any developer.

📚 Tip for Students

Everyone writing reports, articles, or blogs should learn Markdown.

It’s a fast, simple, and universal way to format text that works everywhere:
from GitHub and Notion to Tilda and Hugo.

🧑‍💻 Lab work completed by Hovik, first-year programming student

Weekly Report: Version Control (Git)

Wed, 19 Mar 2025 00:00:00 +0000

Introduction

This week, I actively studied Git version control system. In this post, I will discuss Git setup, working with repositories, and essential commands, along with presenting my lab report.

📌 Git Basics

Git is a distributed version control system (VCS) that allows tracking file changes, managing different project versions, and collaborating on software development.

🔹 Key Terms:

Repository — a project storage with a change history.
Commit — a saved state of files with a description of changes.
Branch — an isolated code version for working on new functionality.
Merge — integrating changes from different branches.
Remote Repository — a repository on a server (e.g., GitHub).

⚙️ Git Setup

🔑 Generating SSH Key

To work with remote repositories without entering a password, create an SSH key:

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

Add the key to the SSH agent:

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_rsa

Copy the key and add it to GitHub:

cat ~/.ssh/id_rsa.pub

📌 Add key to GitHub: Go to SSH key settings

🛠️ Basic Git Configuration

Set up name and email:

git config --global user.name "Hovik Adjabkhanyan"
git config --global user.email "your_email@example.com"

Enable convenient encoding for Russian language support:

git config --global core.quotepath false

📂 Working with Repositories

🏗️ Creating a New Repository

Create a local repository and link it to GitHub:

mkdir my_project && cd my_project
git init
git remote add origin git@github.com:username/my_project.git

Add files and make the first commit:

echo "# My Project" > README.md
git add .
git commit -m "Initial commit"
git push -u origin main

📌 GitHub Repository: Open Project

🔄 Cloning an Existing Repository

git clone git@github.com:username/my_project.git

🌿 Working with Branches

Create a new branch:

git checkout -b feature-branch

Merge a branch:

git checkout main
git merge feature-branch

Delete a branch:

git branch -d feature-branch

📜 Lab Report

🔹 Course Directory Setup

📸 Creating Project Structure:

mkdir -p ~/work/study/2023-2024/Computer_Architecture
cd ~/work/study/2023-2024/Computer_Architecture
git clone --recursive git@github.com:username/study_2023-2024_arch-pc.git archpc

🖼️ Created Structure:

🔹 Independent Work Assignment

Add files to the repository:

git add .
git commit -m "feat: added lab report"
git push origin main

📌 View Repository: GitHub Repository

🎯 Conclusion

During the lab work, I: ✅ Set up Git and GitHub ✅ Created an SSH key for secure connection ✅ Organized the repository and learned essential commands

🔗 Useful Links

📖 Official Git Documentation 📚 GitHub Docs

Projects

Sun, 19 May 2024 00:00:00 +0000

🎉 Easily create your own simple yet highly customizable blog

Fri, 27 Oct 2023 00:00:00 +0000

Welcome 👋

Table of Contents

Overview

The Hugo Blox website builder for Hugo, along with its starter templates, is designed for professional creators, educators, and teams/organizations - although it can be used to create any kind of site
The template can be modified and customised to suit your needs. It’s a good platform for anyone looking to take control of their data and online identity whilst having the convenience to start off with a no-code solution (write in Markdown and customize with YAML parameters) and having flexibility to later add even deeper personalization with HTML and CSS
You can work with all your favourite tools and apps with hundreds of plugins and integrations to speed up your workflows, interact with your readers, and much more

Get Started

👉 Create a new site
📚 Personalize your site
💬 Chat with the Hugo Blox community or Hugo community
🐦 Twitter: @GetResearchDev @GeorgeCushen #MadeWithHugoBlox
💡 Request a feature or report a bug for Hugo Blox
⬆️ Updating Hugo Blox? View the Update Guide and Release Notes

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.

As a token of appreciation for sponsoring, you can unlock these awesome rewards and extra features 🦄✨

Ecosystem

Bibtex To Markdown: Automatically import publications from BibTeX

Inspiration

Learn what other creators are building with this template.

Features

Page builder - Create anything with no-code blocks and elements
Edit any type of content - Blog posts, publications, talks, slides, projects, and more!
Create content in Markdown, Jupyter, or RStudio
Plugin System - Fully customizable color and font themes
Display Code and Math - Code syntax highlighting and LaTeX math supported
Integrations - Google Analytics, Disqus commenting, Maps, Contact Forms, and more!
Beautiful Site - Simple and refreshing one-page design
Industry-Leading SEO - Help get your website found on search engines and social media
Media Galleries - Display your images and videos with captions in a customizable gallery
Mobile Friendly - Look amazing on every screen with a mobile friendly version of your site
Multi-language - 35+ language packs including English, 中文, and Português
Multi-user - Each author gets their own profile page
Privacy Pack - Assists with GDPR
Stand Out - Bring your site to life with animation, parallax backgrounds, and scroll effects
One-Click Deployment - No servers. No databases. Only files.

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.

Choose a stunning theme and font for your site. Themes are fully customizable.

License

Released under the MIT license.

Pandas

Thu, 26 Oct 2023 00:00:00 +0000

Flexible and powerful data analysis / manipulation library for Python, providing labeled data structures.

PyTorch

Thu, 26 Oct 2023 00:00:00 +0000

PyTorch is a Python package that provides tensor computation (like NumPy) with strong GPU acceleration.

🧠 Sharpen your thinking with a second brain

Thu, 26 Oct 2023 00:00:00 +0000

Create a personal knowledge base and share your knowledge with your peers.

Hugo Blox web framework empowers you with one of the most flexible note-taking capabilities out there.

Create a powerful knowledge base that works on top of a local folder of plain text Markdown files.

Use it as your second brain, either publicly sharing your knowledge with your peers via your website, or via a private GitHub repository and password-protected site just for yourself.

Mindmaps

Hugo Blox supports a Markdown extension for mindmaps.

With this open format, can even edit your mindmaps in other popular tools such as Obsidian.

Simply insert a Markdown code block labelled as markmap and optionally set the height of the mindmap as shown in the example below.

Mindmaps can be created by simply writing the items as a Markdown list within the markmap code block, indenting each item to create as many sub-levels as you need:


```markmap {height="200px"}
- Hugo Modules
  - Hugo Blox
  - blox-plugins-netlify
  - blox-plugins-netlify-cms
  - blox-plugins-reveal
```

renders as

- Hugo Modules
  - Hugo Blox
  - blox-plugins-netlify
  - blox-plugins-netlify-cms
  - blox-plugins-reveal

Anh here’s a more advanced mindmap with formatting, code blocks, and math:


```markmap
- Mindmaps
  - Links
    - [Hugo Blox Docs](https://docs.hugoblox.com/)
    - [Discord Community](https://discord.gg/z8wNYzb)
    - [GitHub](https://github.com/HugoBlox/hugo-blox-builder)
  - Features
    - Markdown formatting
    - **inline** ~~text~~ *styles*
    - multiline
      text
    - `inline code`
    -
      ```js
      console.log('hello');
      console.log('code block');
      ```
    - Math: $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$
```

renders as

- Mindmaps
  - Links
    - [Hugo Blox Docs](https://docs.hugoblox.com/)
    - [Discord Community](https://discord.gg/z8wNYzb)
    - [GitHub](https://github.com/HugoBlox/hugo-blox-builder)
  - Features
    - Markdown formatting
    - **inline** ~~text~~ *styles*
    - multiline
      text
    - `inline code`
    -
      ```js
      console.log('hello');
      console.log('code block');
      ```
    - Math: $x = {-b \pm \sqrt{b^2-4ac} \over 2a}$

Highlighting

Highlight important text with mark:

<mark>Highlighted text</mark>

Callouts

Use callouts (aka asides, hints, or alerts) to draw attention to notes, tips, and warnings.

By wrapping a paragraph in {{% callout note %}} ... {{% /callout %}}, it will render as an aside.

{{% callout note %}}
A Markdown aside is useful for displaying notices, hints, or definitions to your readers.
{{% /callout %}}

renders as

A Markdown aside is useful for displaying notices, hints, or definitions to your readers.

Or use the warning callout type so your readers don’t miss critical details:

A Markdown aside is useful for displaying notices, hints, or definitions to your readers.

📈 Communicate your results effectively with the best data visualizations

Wed, 25 Oct 2023 00:00:00 +0000

Hugo Blox is designed to give technical content creators a seamless experience. You can focus on the content and Hugo Blox handles the rest.

Use popular tools such as Plotly, Mermaid, and data frames.

Charts

Hugo Blox supports the popular Plotly format for interactive data visualizations. With Plotly, you can design almost any kind of visualization you can imagine!

Save your Plotly JSON in your page folder, for example line-chart.json, and then add the {{< chart data="line-chart" >}} shortcode where you would like the chart to appear.

Demo:

You might also find the Plotly JSON Editor useful.

Diagrams

Hugo Blox supports the Mermaid Markdown extension for diagrams.

An example flowchart:

```mermaid
graph TD
A[Hard] -->|Text| B(Round)
B --> C{Decision}
C -->|One| D[Result 1]
C -->|Two| E[Result 2]
```

renders as

graph TD A[Hard] -->|Text| B(Round) B --> C{Decision} C -->|One| D[Result 1] C -->|Two| E[Result 2]

An example sequence diagram:

```mermaid
sequenceDiagram
Alice->>John: Hello John, how are you?
loop Healthcheck
    John->>John: Fight against hypochondria
end
Note right of John: Rational thoughts!
John-->>Alice: Great!
John->>Bob: How about you?
Bob-->>John: Jolly good!
```

renders as

sequenceDiagram Alice->>John: Hello John, how are you? loop Healthcheck John->>John: Fight against hypochondria end Note right of John: Rational thoughts! John-->>Alice: Great! John->>Bob: How about you? Bob-->>John: Jolly good!

An example class diagram:

```mermaid
classDiagram
Class01 <|-- AveryLongClass : Cool
Class03 *-- Class04
Class05 o-- Class06
Class07 .. Class08
Class09 --> C2 : Where am i?
Class09 --* C3
Class09 --|> Class07
Class07 : equals()
Class07 : Object[] elementData
Class01 : size()
Class01 : int chimp
Class01 : int gorilla
Class08 <--> C2: Cool label
```

renders as

classDiagram Class01 <|-- AveryLongClass : Cool Class03 *-- Class04 Class05 o-- Class06 Class07 .. Class08 Class09 --> C2 : Where am i? Class09 --* C3 Class09 --|> Class07 Class07 : equals() Class07 : Object[] elementData Class01 : size() Class01 : int chimp Class01 : int gorilla Class08 <--> C2: Cool label

An example state diagram:

```mermaid
stateDiagram
[*] --> Still
Still --> [*]
Still --> Moving
Moving --> Still
Moving --> Crash
Crash --> [*]
```

renders as

stateDiagram [*] --> Still Still --> [*] Still --> Moving Moving --> Still Moving --> Crash Crash --> [*]

Data Frames

Save your spreadsheet as a CSV file in your page’s folder and then render it by adding the Table shortcode to your page:

{{< table path="results.csv" header="true" caption="Table 1: My results" >}}

renders as

Table 1: My results
customer_id	score
1	0
2	0.5
3	1

👩🏼‍🏫 Teach academic courses

Tue, 24 Oct 2023 00:00:00 +0000

Hugo Blox Builder 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.

Embed videos, podcasts, code, LaTeX math, and even test students!

On this page, you’ll find some examples of the types of technical content that can be rendered with Hugo Blox.

Video

Teach your course by sharing videos with your students. Choose from one of the following approaches:

Youtube:

{{< youtube D2vj0WcvH5c >}}

Bilibili:

{{< bilibili BV1WV4y1r7DF >}}

Video file

Videos may be added to a page by either placing them in your assets/media/ media library or in your page’s folder, and then embedding them with the video shortcode:

{{< video src="my_video.mp4" controls="yes" >}}

Podcast

You can add a podcast or music to a page by placing the MP3 file in the page’s folder or the media library folder and then embedding the audio on your page with the audio shortcode:

{{< audio src="ambient-piano.mp3" >}}

Try it out:

Test students

Provide a simple yet fun self-assessment by revealing the solutions to challenges with the spoiler shortcode:

{{< spoiler text="👉 Click to view the solution" >}}
You found me!
{{< /spoiler >}}

renders as

👉 Click to view the solution

You found me 🎉

Math

Hugo Blox Builder supports a Markdown extension for $\LaTeX$ math. Enable math by setting the math: true option in your page’s front matter, or enable math for your entire site by toggling math in your config/_default/params.yaml file:

features:
  math:
    enable: true

To render inline or block math, wrap your LaTeX math with $...$ or $$...$$, respectively.

Example math block:

$$
\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}
$$

renders as

$$\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}$$

Example inline math $\nabla F(\mathbf{x}_{n})$ renders as $\nabla F(\mathbf{x}_{n})$.

Example multi-line math using the math linebreak (\\):

$$f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\
1-p_{0}^{*} & \text{if }k=0.\end{cases}$$

renders as

$$ f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\ 1-p_{0}^{*} & \text{if }k=0.\end{cases} $$

Code

Hugo Blox Builder utilises Hugo’s Markdown extension for highlighting code syntax. The code theme can be selected in the config/_default/params.yaml file.

```python
import pandas as pd
data = pd.read_csv("data.csv")
data.head()
```

renders as

import pandas as pd
data = pd.read_csv("data.csv")
data.head()

Inline Images

{{< icon name="python" >}} Python

renders as

Python

Experience

Tue, 24 Oct 2023 00:00:00 +0000

Learn JavaScript

Tue, 24 Oct 2023 00:00:00 +0000

Hugo Blox Builder 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.

Embed videos, podcasts, code, LaTeX math, and even test students!

On this page, you’ll find some examples of the types of technical content that can be rendered with Hugo Blox.

Video

Teach your course by sharing videos with your students. Choose from one of the following approaches:

Youtube:

{{< youtube w7Ft2ymGmfc >}}

Bilibili:

{{< bilibili id="BV1WV4y1r7DF" >}}

Video file

Videos may be added to a page by either placing them in your assets/media/ media library or in your page’s folder, and then embedding them with the video shortcode:

{{< video src="my_video.mp4" controls="yes" >}}

Podcast

You can add a podcast or music to a page by placing the MP3 file in the page’s folder or the media library folder and then embedding the audio on your page with the audio shortcode:

{{< audio src="ambient-piano.mp3" >}}

Try it out:

Test students

Provide a simple yet fun self-assessment by revealing the solutions to challenges with the spoiler shortcode:

{{< spoiler text="👉 Click to view the solution" >}}
You found me!
{{< /spoiler >}}

renders as

👉 Click to view the solution

You found me 🎉

Math

Hugo Blox Builder supports a Markdown extension for $\LaTeX$ math. You can enable this feature by toggling the math option in your config/_default/params.yaml file.

To render inline or block math, wrap your LaTeX math with {{< math >}}$...${{< /math >}} or {{< math >}}$$...$${{< /math >}}, respectively.

We wrap the LaTeX math in the Hugo Blox math shortcode to prevent Hugo rendering our math as Markdown.

Example math block:

{{< math >}}
$$
\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}
$$
{{< /math >}}

renders as

Example inline math {{< math >}}$\nabla F(\mathbf{x}_{n})${{< /math >}} renders as $\nabla F(\mathbf{x}_{n})$ .

Example multi-line math using the math linebreak (\\):

{{< math >}}
$$f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\
1-p_{0}^{*} & \text{if }k=0.\end{cases}$$
{{< /math >}}

renders as

$$ f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\ 1-p_{0}^{*} & \text{if }k=0.\end{cases} $$

Code

Hugo Blox Builder utilises Hugo’s Markdown extension for highlighting code syntax. The code theme can be selected in the config/_default/params.yaml file.

```python
import pandas as pd
data = pd.read_csv("data.csv")
data.head()
```

renders as

import pandas as pd
data = pd.read_csv("data.csv")
data.head()

Inline Images

{{< icon name="python" >}} Python

renders as

Python

Learn Python

Tue, 24 Oct 2023 00:00:00 +0000

Hugo Blox Builder 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.

Embed videos, podcasts, code, LaTeX math, and even test students!

On this page, you’ll find some examples of the types of technical content that can be rendered with Hugo Blox.

Video

Teach your course by sharing videos with your students. Choose from one of the following approaches:

Youtube:

{{< youtube w7Ft2ymGmfc >}}

Bilibili:

{{< bilibili id="BV1WV4y1r7DF" >}}

Video file

Videos may be added to a page by either placing them in your assets/media/ media library or in your page’s folder, and then embedding them with the video shortcode:

{{< video src="my_video.mp4" controls="yes" >}}

Podcast

You can add a podcast or music to a page by placing the MP3 file in the page’s folder or the media library folder and then embedding the audio on your page with the audio shortcode:

{{< audio src="ambient-piano.mp3" >}}

Try it out:

Test students

Provide a simple yet fun self-assessment by revealing the solutions to challenges with the spoiler shortcode:

{{< spoiler text="👉 Click to view the solution" >}}
You found me!
{{< /spoiler >}}

renders as

👉 Click to view the solution

You found me 🎉

Math

Hugo Blox Builder supports a Markdown extension for $\LaTeX$ math. You can enable this feature by toggling the math option in your config/_default/params.yaml file.

To render inline or block math, wrap your LaTeX math with {{< math >}}$...${{< /math >}} or {{< math >}}$$...$${{< /math >}}, respectively.

We wrap the LaTeX math in the Hugo Blox math shortcode to prevent Hugo rendering our math as Markdown.

Example math block:

{{< math >}}
$$
\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}
$$
{{< /math >}}

renders as

Example inline math {{< math >}}$\nabla F(\mathbf{x}_{n})${{< /math >}} renders as $\nabla F(\mathbf{x}_{n})$ .

Example multi-line math using the math linebreak (\\):

{{< math >}}
$$f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\
1-p_{0}^{*} & \text{if }k=0.\end{cases}$$
{{< /math >}}

renders as

$$ f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\ 1-p_{0}^{*} & \text{if }k=0.\end{cases} $$

Code

Hugo Blox Builder utilises Hugo’s Markdown extension for highlighting code syntax. The code theme can be selected in the config/_default/params.yaml file.

```python
import pandas as pd
data = pd.read_csv("data.csv")
data.head()
```

renders as

import pandas as pd
data = pd.read_csv("data.csv")
data.head()

Inline Images

{{< icon name="python" >}} Python

renders as

Python

An example preprint / working paper

Sun, 07 Apr 2019 00:00:00 +0000

This work is driven by the results in my previous paper on LLMs.

Create your slides in Markdown - click the Slides button to check out the example.

Add the publication’s full text or supplementary notes here. You can use rich formatting such as including code, math, and images.

An example journal article

Tue, 01 Sep 2015 00:00:00 +0000

Click the Cite button above to demo the feature to enable visitors to import publication metadata into their reference management software.

Create your slides in Markdown - click the Slides button to check out the example.

Add the publication’s full text or supplementary notes here. You can use rich formatting such as including code, math, and images.

An example conference paper

Mon, 01 Jul 2013 00:00:00 +0000

Click the Cite button above to demo the feature to enable visitors to import publication metadata into their reference management software.

Create your slides in Markdown - click the Slides button to check out the example.

Add the publication’s full text or supplementary notes here. You can use rich formatting such as including code, math, and images.