Skip to content

Update Spanish translation - #607

Merged
Aarrayy merged 1 commit into
CachyOS:nextfrom
cantosun99:es
Aug 8, 2026
Merged

Update Spanish translation#607
Aarrayy merged 1 commit into
CachyOS:nextfrom
cantosun99:es

Conversation

@cantosun99

Copy link
Copy Markdown
Contributor

Updating languages with local AI: Spanish

As discussed in Issue #550 I will be starting to AI-translate the languages that don't have anyone translating them by hand like I'm doing with the German one. As most of the existing translations are done by AI anyway, this will just be an update, rather than a step back in quality.

This is the third language by priority after Russian and Portuguese. Next up is simplified Chinese as the Steam hardware survey lists a ton of Chinese people using Linux but their capability to understand a Wiki is fairly low. That one will be one hell of a task tho since it's a completely new but absolutely needed language. I might drop down from Q6 to Q4 so I can fit 262k instead of 131k KV-cache for that one, let's see.

I ran the wiki page local with bun and while I obviously can't verify the translation itself, I always try to verify if the site is visually identical to the English one to spot syntax errors and if things are or aren't translated. @Aarrayy didn't you mention you are from Argentinia? Maybe you can verify if my GPU is producing slop or not haha.

As I have strong critical opinions on AI-use myself, I want the process to be ran on local hardware and as transparent as possible, which is why I'm listing prompt, model, soft- and hardware that were used. Feel free to suggest any changes or request any clarification of my approach.

Prompt used:

"Today we are going to translate technical documentation for the CachyOS wiki (Arch-based Linux distro).

TRANSLATION RULES:

TRANSLATE:

  • Body text and explanatory content
  • Headings, titles, section labels
  • UI labels (TabItem labels, button text, etc.)
  • Link display text (visible text, not the URL itself)
  • Explanatory comments (in code blocks and around terminal output)

DO NOT TRANSLATE:

  • Actual commands and code
  • Terminal output
  • Program/package/file names and paths (pacman, gcc, /etc/pacman.conf, etc.)
  • URLs
  • Technical terms (bootloader, kernel, PGO, LTO, BOLT, etc.)
  • External link URLs

GOAL: Translate the context so a native reader understands what to do, without over-translating. Users are expected to know basic Linux concepts by their English names.

INTERNAL LINKS: English files live at /src/content/docs/.mdx, translations at /src/content/docs//.mdx. When a link points to another wiki page, add the language code (e.g., /ru/installation/...) so users stay on the translated site. External links stay unchanged.

UPDATING EXISTING TRANSLATIONS:

  • Translated pages usually exist but are outdated; keep existing translation for unchanged content
  • Apply all differences from English: add new content, remove deleted content, update changed content
  • Minimal changes only; do not rewrite unchanged sections
  • Match English formatting EXACTLY: same line breaks, same punctuation marks (' stays ', not ` or "), same spacing
  • At the top of the file there usually is a field seperated by a --- at the top and bottom. Always add an ai_translated: true as the last line above the bottom ---

VERIFYING CHANGES:
There already is a local build running with bun, you can verify the changes live at http://localhost:4321/ if needed.

HOW TO WRITE CHANGES:

  • Start with the first file and translate/update them one by one. Only when you are done with the first one, proceed to the second and so on.
  • If unchecked, you like to write 1000+ lines at once which will result in the tool-call failing. Only write up to 500 lines at once, save the file, then continue with the next batch.

FILES THAT NEED TO BE TRANSLATED/UPDATED TO SPANISH (es):

OUTDATED:
cachyos_basic/faq.mdx
configuration/automount_with_fstab.mdx
configuration/boot_manager_configuration.mdx
configuration/btrfs_snapshots.mdx
configuration/desktop_environments/switch_desktop.mdx
configuration/dual_gpu.mdx
configuration/enabling_hardware_acceleration_in_google_chrome.mdx
configuration/gaming.mdx
configuration/general_system_tweaks.mdx
configuration/post_install_setup.mdx
configuration/sched-ext.mdx
configuration/secure_boot_setup.mdx
features/cachy_chroot.mdx
features/cachyos_settings.mdx
features/chwd/chwd.mdx
features/kernel.mdx
features/optimized_repos.mdx
installation/boot_managers.mdx
installation/desktop_environments.mdx
installation/filesystem.md
installation/installation_handheld.mdx
installation/installation_on_root.mdx
installation/installation_t2macbook.mdx
policy/code_of_conduct.md
policy/repository_policy.md
support/donation.md

MISSING:
configuration/desktop_environments/hyprland.mdx"

Model used:

A Qwen3.6 27B finetune at Q6_K with Q8_0 KV-cache

Software used:

My own AUR packages llama.cpp-sycl and intel-deep-learning-essentials to run the model, Pi Coding Agent as the harness, running on CachyOS of course

Hardware used:

Sparkle Intel Arc Pro B70 with 32GB VRAM

@Aarrayy
Aarrayy merged commit a5e61f6 into CachyOS:next Aug 8, 2026
@cantosun99
cantosun99 deleted the es branch August 9, 2026 06:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants