Correct the China docs and move .cn twins in the rc repository migration

This commit is contained in:
ZacharyZhang-NY committed 2026-10-06 01:02:03 -04:00
1 parent e1471efa42
commit 4eafef5025
5 files changed
+17 -7

No files matched your search

+4 -4
View File
@@ -1,6 +1,6 @@
# China
Omarchy works out of the box in mainland China without a VPN. Pick _China_ on the first screen of the installer, the region picker that comes before the keyboard layout, and the machine comes up ready: Chinese menus and system language, a Chinese input method, Chinese package mirrors, and the Chinese software people actually need.
Omarchy is built to work in mainland China without a VPN. Pick _China_ on the first screen of the installer, the region picker that comes before the keyboard layout, and the machine comes up ready: Chinese menus and system language, a Chinese input method, Chinese package mirrors, and the Chinese software people actually need.
## What China sets up
@@ -14,7 +14,7 @@ Omarchy works out of the box in mainland China without a VPN. Pick _China_ on th
Chinese text renders in the right Noto CJK variant everywhere: Simplified for Chinese, Traditional for Taiwan and Hong Kong, Japanese and Korean for those languages. That works in both regions.
Every package mirror lists the `.cn` server first and the `.org` server second. If the `.cn` mirror is unreachable, or a package is missing there, pacman falls through to `.org`, which works for anyone with their own VPN.
Every package mirror lists the `.cn` server first and the `.org` server second. If the `.cn` mirror is unreachable, or a package is missing there, pacman falls through to `.org`, which works for anyone with their own VPN. `pkgs.omarchy.cn` serves the Omarchy packages today; until the Arch mirrors on `stable-mirror.omarchy.cn` and friends come online, Arch packages come from the `.org` servers.
## Input
@@ -22,7 +22,7 @@ The installer sets up Rime Ice offline, from data bundled on the ISO, so Chinese
## Developer mirrors
China machines point the common package managers at mirrors inside China through drop-ins Omarchy owns: `/etc/environment.d/90-omarchy-china.conf` (npm, PyPI and uv, Go, rustup, Bundler, Maven), `/.cargo/config.toml` (crates.io) and `/etc/gemrc` (RubyGems). They take effect from your next login. A project's own configuration still wins, and Omarchy never replaces one of those files if you created it yourself.
China machines point the common package managers at mirrors inside China. Environment variables in `/etc/environment.d/90-omarchy-china.conf` cover npm, PyPI and uv, Go, rustup, Bundler and Maven; they reach everything started from the desktop after your next login (not SSH or TTY shells), and they take precedence over npm, pip, uv and Go config files, so unset the variable in a shell to opt out. `/.cargo/config.toml` (crates.io) and `/etc/gemrc` (RubyGems) are system-wide defaults that a project's own config overrides. Omarchy never replaces one of those two files if it is a regular file you created. Toolchain downloads by mise, such as Node.js or Go themselves, still come from upstream.
## China Apps
@@ -38,4 +38,4 @@ _Setup > Region_ switches an installed machine either way, or run `omarchy regio
Switching to Global moves packages back to the `.org` servers, the language back to English, and removes the developer mirrors, China Apps and the Claude Code API setup. It keeps the input method and the CJK fonts, so you can still type and read Chinese. `omarchy update` never changes the region or the language; only these switches do.
A machine prepared for another owner, or reset to factory settings, keeps its region but doesn't carry the input method's offline data. Pick _Setup > Region > China_ once it's online to set Rime Ice up.
A machine prepared for another owner keeps the region picked in the installer, and a factory reset returns a machine to the region it was installed with. Neither carries the input method's offline data, so pick _Setup > Region > China_ once the machine is online; that setup downloads Rime Ice from GitHub.