Hướng dẫn viết bài · Writing a post
Gửi tên GitHub, rồi viết bài đầu tiên của bạn · Send your GitHub username, then write your first post.
Viết bài cho MIDVIEWriting a post for MIDVIE
Bạn muốn chia sẻ một ghi chú, một hướng dẫn hay một góc nhìn về mô hình hóa bệnh truyền nhiễm? Đây là cách bắt đầu, chỉ trong vài phút. Would you like to share a note, a tutorial or a perspective on infectious disease modelling? Here is how to begin, in just a few minutes.
Cho chúng tôi biết, và gửi tên GitHubTell us, and send your GitHub username
Trước tiên, hãy nhắn cho chúng tôi biết bạn muốn viết bài, kèm theo tên người dùng GitHub của bạn. Chúng tôi sẽ thêm bạn vào kho lưu trữ của MIDVIE trên GitHub để bạn có quyền đăng bài. Cách nhanh nhất là nhắn cho chúng tôi trong kênh Zulip.
First, let us know you would like to write, along with your GitHub username. We will add you to the MIDVIE repository on GitHub so you have access to publish. The quickest way is to send us a message in our Zulip chat.
Tạo bài viếtCreate the post
Trong thư mục blog/, tạo một thư mục mới cho bài của bạn (ví dụ blog/bai-cua-toi/) rồi thêm một file tên index.qmd. Mở đầu file bằng một khối “front matter” nhỏ nằm giữa hai dòng ---:
Inside the blog/ folder, create a new folder for your post (for example blog/my-post/) and add a file named index.qmd. Begin the file with a small “front matter” block between two --- lines:
---
title: "Tiêu đề bài viết của bạn"
subtitle: "Một câu mô tả ngắn gọn"
date: 2026-07-22
author: "Tên của bạn"
categories: [note]
------
title: "Your post title"
subtitle: "A short one-line description"
date: 2026-07-22
author: "Your name"
categories: [note]
---Hãy viết bằng ngôn ngữ mà bạn thấy thoải mái nhất. Một bài chỉ có một thứ tiếng là hoàn toàn ổn. Nếu muốn có cả hai, hãy đặt mỗi bản trong một khối .l-vi (tiếng Việt) và .l-en (tiếng Anh) như ví dụ sau:
Write in whichever language you are most comfortable with. A post in a single language is completely fine. If you would like both, put each version inside an .l-vi (Vietnamese) and .l-en (English) block, like this:
::: {.l-vi}
Đoạn văn của bạn bằng tiếng Việt.
:::
::: {.l-en}
Your paragraph in English.
:::Vài thứ bạn có thể làmA few things you can do
Phần nội dung viết bằng Markdown. Đây là những cú pháp hay dùng nhất:
The body is written in Markdown. Here are the pieces you will use most:
## Một tiêu đề, và một tiêu đề nhỏ hơn ###
**In đậm**, *in nghiêng*, và `mã trong dòng`.
- một gạch đầu dòng
- kèm một [đường dẫn](https://midvie.github.io)
1. hoặc một danh sách đánh số
2. theo thứ tự
> Một câu trích dẫn hoặc ghi chú.
Công thức toán viết giữa hai dấu $, ví dụ $R_0 = \beta / \gamma$.## A heading, and a smaller one ###
**Bold**, *italic*, and `inline code`.
- a bullet point
- with a [link](https://midvie.github.io)
1. or a numbered list
2. in order
> A quote or a note.
Maths goes between dollar signs, e.g. $R_0 = \beta / \gamma$.Vì trang chạy trên Quarto, bạn còn có thêm vài thứ đẹp hơn. Ví dụ một hộp gợi ý, và một công thức tách riêng ra một dòng:
Because the site runs on Quarto, you also get a few nicer things. For example a callout box, and a formula on its own line:
Một hộp như thế này được tạo bằng ba dấu hai chấm kèm nhãn callout-tip.A box like this is made with three colons and the label callout-tip.
\[ \frac{dI}{dt} = \beta S I - \gamma I \]
Nếu bài viết nhắc đến một thành viên MIDVIE, bạn có thể biến tên đó thành một liên kết mở hồ sơ của thành viên ngay trên trang (giống thẻ hồ sơ ở trang Thành viên). Dùng id của thành viên trong data/people.json:
If your post mentions a MIDVIE member, you can turn the name into a link that opens their profile right on the page (the same card as on the People page). Use the member’s id from data/people.json:
<a class="mv-member" data-person="tran"
href="../../people.html#member-tran">Trân</a>Viết xong, hãy lưu file và mở một pull request trên GitHub. Chúng tôi sẽ xem lại và đăng giúp bạn. Cảm ơn bạn đã góp một tiếng nói cho MIDVIE.
When you are done, save the file and open a pull request on GitHub. We will review it and publish it for you. Thank you for adding your voice to MIDVIE.