إنتقل إلى المحتوى الرئيسي

Editing Content

This guide is for everyone—whether you're a developer or just here to share your knowledge. You don't need to know how to code to contribute!

How to Edit a Page​

Every page on this site has an "Edit this page" link at the bottom. Clicking it will take you to the source file on GitHub.

  1. Click the Edit (pencil) icon on GitHub.
  2. Make your changes using Markdown (it's like simplified text formatting).
  3. Scroll down, add a short description of what you changed, and click Commit changes.

Basics of Markdown​

Markdown is a simple way to format text:

  • # Heading 1
  • ## Heading 2
  • **Bold text**
  • *Italic text*
  • [Link text](https://link-url.com)
  • - List item
  • 1. Numbered list item

Admonitions (Callouts)​

You can add special callout boxes to highlight important information:

ملاحظة

This is a simple note.

تلميح

This is a helpful tip!

معلومات

This is useful information.

warning

This is a warning—be careful!

خطر

This is a critical danger warning.

Adding Images​

To add an image, simply place the image file in the static/img/ folder and link to it like this:

![Image description](/img/your-image.png)

Blog Posts​

To add a new blog post, simply add a new .md file in the blog/ folder. The file name should follow the format YYYY-MM-DD-title.md (e.g., 2026-04-13-welcome.md).

Translating Content​

This site supports multiple languages! To translate a page:

  1. Find the file you want to translate in docs/ or blog/.
  2. Create a copy of it in the corresponding i18n/ directory:
    • Docs: i18n/es/docusaurus-plugin-content-docs/current/filename.md
    • Blog: i18n/es/docusaurus-plugin-content-blog/filename.md
  3. Translate the content of the file.
  4. Commit your changes!