Skip to content

Latest commit

 

History

History
168 lines (153 loc) · 7.52 KB

README.md

File metadata and controls

168 lines (153 loc) · 7.52 KB
draft
true

Hướng dẫn đóng góp Blog

Các thành viên đăng các bài Writeup từ CTF, Wargames, Flare-on, NSUCryptos, những bài article chủ đề security, bug-bounty report,....
Mọi người có thể xem ví dụ ở đây nha (ở chế độ raw)

Tạo thư mục và file

Thành viên có nickname là Bkisc muốn viết bài Sekai CTF 2022: Bottle Poem sẽ tạo thư mục /content/blog/bkisc/sekai-ctf-2022-bottle-poem, thêm vào đó một file index.md và nhiều file ảnh khác nhau. Trong đó đặt 1 file ảnh chính featured.jpg để hiện ảnh này trên trang list các blog /blog. Sau đây là lưu ý cho file index.md

Các field cần lưu ý trên Front Matter (YAML)

Mọi người có thể tham khảo thêm hướng dẫn đầy đủ tại đây 0. draft - Cái này để set true/false nếu file này chỉ là nháp, không xuất hiện trên blog khi publish, field này mọi người để là false nha

draft: false
  1. title
    • Tên bài blog
  2. author
    • Tác giả bài blog, một bài blog có thể có nhiều tác giả
    • Tên tác giả cần phải khớp với tên đã ghi cho field authors trong hướng dẫn thêm member
authors:
  - bkisc
  - hdthinh1012
  1. date
    • Ngày đăng bài
    • Format: <YYYY>-<MM>-<DD>T<HH>:<MM>:<SS>Z
date: '2023-01-12T00:00:00Z'
  1. doi
    • Field này mình chưa rõ
  2. publishDate
    • Ngày bài đăng được hiện lên trên trang blog, giá trị này ảnh hưởng đến bài blog có xuất hiện trên web hay chưa
    • Note: Do đến đúng publish date bài đăng mới xuất hiện trên blogs và hiện đang tính theo giờ GMT nên mong mọi người dời về trước 7 giờ hoặc trước hẳn 1 ngày để blog xuất hiện ngay lập tức sau khi pull request
publishDate: '2023-01-12T00:00:00Z'
  1. publication_types
    • Kiểu phát hành: do template mình lấy vốn để đăng bài báo khoa học nên kiểu ở đây sẽ liên quan đến các kiểu tạp chí khoa học nhiều hơn
    • Đối với bài CTF Writeup, mọi người chọn ['9'] là writeups nha. Mọi người tham khảo kiểu publication và số index tương ứng trong file data/publication_types.toml
# Publication type.
# Legend: 0 = Uncategorized; 1 = Conference paper; 2 = Journal article;
# 3 = Preprint / Working Paper; 4 = Report; 5 = Book; 6 = Book section;
# 7 = Thesis; 8 = Patent; 9 = Writeups
publication_types: ['9']
  1. publication, publication_short
    • Hai mục này liên quan bài báo khoa học hơn, mọi người có thể bỏ qua
publication: ''
publication_short: ''
  1. abstract
    • Mục này liên quan bài báo khoa học hơn, mọi người có thể viết tóm gọn nội dung bài blog
abstract: Write up for a challenge from Sekai CTF 2022
  1. summary
    • Tóm tắt nội dung bài blog, sẽ được hiện thị trên trang list các blog /blog
# Summary. An optional shortened abstract.
summary: Deserialization attack with Python Bottle.
  1. (Nên có) tags
    • Các tags để nhấn mạnh chủ đề bài viết của mọi người, các tags sẽ hiện ở trang /blog để người đọc có thể browse nhóm bài blog mong muốn nên mọi người nên để nha.
    • Mọi người nên xem kỹ các tag đã có khi mở url /blog trên web, để không tạo các tags trùng nghĩa nhưng khác spelling, tránh gây loãng.
    • Một số tags gợi ý như
      • ctf
      • root-me
      • wsa
      • burp-suite
      • ida
      • writeup
      • web
      • crypto
      • re
      • pwn
      • forensic
      • steganography
      • nsucrypto-<số năm>
      • isitdtu-<số năm>
      • ascis-<số năm>
tags:
  - ctf
  - writeup
  - web exploitation
  1. links
    • Link liên quan đến bài viết, mọi người có thể đăng link bài blog trên trang cá nhân của mình.
# Mọi người có thể đăng link từ original page của mình
links:
  - name: Original Link
    url: http://example.org
  1. url_[upload-format]
    • Đối với các bài blog hay bài báo khoa học mọi người đăng trên đây còn tồn tại dưới các định dạng khác như PDF, Code (source code liên quan), Dataset (dữ liệu liên qua), Poster (???), Project (???), slides (trên slideshare hay google presentation), Source (???), video. Mọi người có thể đính kèm online url link cho các resource trên với format tương ứng
# Link đính kèm với format tương ứng
url_pdf: ''
url_code: ''
url_dataset: ''
url_poster: ''
url_project: ''
url_slides: ''
url_source: ''
url_video: ''
  1. image
    • Config cho featured.png image mọi người đã thêm ở trên
image:
  caption: 'Image credit: [**Sekai CTF**](https://unsplash.com/photos/s9CC2SKySJM)'
  focal_point: ''
  preview_only: false
  1. Bỏ qua (Cho chuỗi bài viết series) projects
    • Note: Hiện giờ do field này mọi người set là projects: [] nha.
    • Field này dùng nếu như mọi người muốn liên hệ một vài bài viết chung series
    • Ví dụ mọi người muốn viết bài blog Linux Kernel Exploitation part 1 cho projects/series Linux-kernel-exploitation mọi người có thể điền field này là project: linux-kernel-exploitation rồi tạo một thư mục content/project/linux-kernel-exploitation/index.md để hiển thị tên project/series đó sử dụng command: hugo new --kind project project/linux-kernel-exploitation.
    • Tuy nhiên, dù bài blog có thể reference projects thông qua field này, nhưng projects lại không có field references blogs và Wowchemy chưa hỗ trợ render tự động giúp các blogs khi mở project nên trên đường dẫn content/projects/linux-kernel-exploitation/index.md mong mọi người viết thêm nội dung, add các bài blog có liên quan đến project một cách thủ công nha. Một ví dụ về projects mọi người có thể xem ở đường dẫn content/project/ctf-2022-writeups/index.md
# Associated Projects (optional).
#   Associate this publication with one or more of your projects.
#   Simply enter your project's folder or file name without extension.
#   E.g. `internal-project` references `content/project/internal-project/index.md`.
#   Otherwise, set `projects: []`.
projects: []
  1. slides
    • field này dành cho ai đăng blog dưới dạng markdown slides
# Slides (optional).
#   Associate this publication with Markdown slides.
#   Simply enter your slide deck's filename without extension.
#   E.g. `slides: "example"` references `content/slides/example/index.md`.
#   Otherwise, set `slides: ""`.
slides: ""
  1. featured
    • Nếu true sẽ được để trên trang home
featured: true

Phần nội dung (Markdown)

Mọi người viết blog theo cú pháp Markdown với một số shortcodes hỗ trợ bới Hugo mặc định và shortcodes mở rộng hỗ trợ bởi theme Wowchemy

  • Shortcode mặc định bởi Hugo tại đây (không nhiều)
  • Shortcode mở rộng bởi Wowchemy theme tại đây (có cả hỗ trợ Latex với math)