About
Write Content

Write Content

Welcome to the Beginner Privacy content guide!

Getting Started

Choose your editing method:

Check out what to write:

Head over to our Article Status Board on GitHub to see what articles haven’t been done.

Create Your Article

  1. Navigate to the content/articles/ folder.
  2. Create a new folder with a URL-friendly name (e.g., why-privacy-matters for “Why Privacy Matters”).
  3. Inside this folder, create three files:
    • index.md (English)
    • index.es.md (Spanish)
    • index.zh-cn.md (Chinese Simplified)

🖼️ Need images?

Article Template

Include this at the top of your article.

---
title: [Article Title Here]
date: 2025-02-25
authors:
  - name: [Your Name]
    link: https://github.com/[Your GitHub Username]
    image: https://github.com/[Your GitHub Username].png
excludeSearch: false
---

Writing Style

Audience: Adults using technology – avoid oversimplification but explain jargon.

Style:

  • Use American English.
  • Be concise while covering key details (e.g., why a tool is recommended).
  • Structure content with Markdown headers (##, ###).

Translating Article

Beginner Privacy is available in 3 languages: English, Spanish, and Chinese (Simplified).

  1. Translate the English version using a tool like LibreTranslate or any other translator you prefer into Spanish and Chinese (Simplified).
  2. Translation Verification: Translate the article that has already been translated back into English, and then compare it to the original English article to:
    • Catch mistranslated technical terms
    • Verify sentence structure matches the intended meaning
    • Identify missing context
  3. Adjust image paths for non-English articles:
    • Add ../ to paths (e.g., ../../images/... → ../../../images/... for the Spanish/Chinese articles).
  4. Proofread: Fix formatting issues and ensure clarity.

Markdown & Shortcodes

Check out the Hextra documentation on markdown and shortcodes. If there is a certain tool or piece of software that you want to recommend in the article, you can use this shortcode.

<div class="recommendations">
  <div class="grid">
    {{< hextra/recommendation-card title="MullvadVPN" link="https://mullvad.net/en/vpn" logo="../../../../images/articles/what-is-a-vpn-and-should-you-use-one/mullvadvpn.webp" text="Paid, open source" platformIcon="linux android ios macos windows" buttonText="Visit Website" >}}
  </div>
</div>

MullvadVPN

Paid, open source

Visit Website
Last updated on
Translate