diff --git a/docs/vi/branding.md b/docs/vi/branding.md new file mode 100644 index 00000000..ac59afb1 --- /dev/null +++ b/docs/vi/branding.md @@ -0,0 +1,426 @@ +--- +description: See the official branding & wallpapers for AtlasOS +icon: material/palette +--- + +# Bộ nhận diện thương hiệu chính thức của AtlasOS + +Chúng tôi tự hào chia sẻ bộ nhận diện thương hiệu chính thức của mình với cộng đồng. Cho dù bạn đang làm video, trang web hay bản trình chiếu, bạn đều có thể sử dụng những nội dung này để thể hiện sự ủng hộ của mình đối với AtlasOS. + +Chúng tôi cung cấp tất cả bộ nhận diện thương hiệu của mình cho cộng đồng ở nhiều định dạng và kích cỡ khác nhau, cho phép bạn sử dụng chúng theo cách của bạn. Bạn có thể tạo những tác phẩm nghệ thuật hoặc sử dụng nó trong các video review AtlasOS của mình. Giới hạn duy nhất là trí tưởng tượng của bạn! + +!!! info "Hãy nhớ các quy tắc thương hiệu" + + Vui lòng đọc [Quy tắc Thương hiệu](https://gcore.jsdelivr.net/gh/Atlas-OS/Atlas@main/img/Atlas%20-%20Brand%20Guidelines.pdf) của chúng tôi để biết cách sử dụng thương hiệu AtlasOS đúng cách. + +## Logomarks + +=== "Ice" + + ![AtlasOS Ice Logomark](assets/brand/preview/logomark/preview-logomark-ice.png){ width=250 loading=lazy } + + *Ice Logomark* + + [:material-download: Tải xuống Ice Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.png) + + [:material-download: Tải xuống Ice Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.svg) + + [:material-download: Tải xuống Ice Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Ice.pdf) + + ![AtlasOS Ice + White Logomark](assets/brand/preview/logomark/preview-logomark-ice-white.png){ width=250 loading=lazy } + + *Ice + White Logomark* + + [:material-download: Tải xuống Ice + White Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.png) + + [:material-download: Tải xuống Ice + White Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.svg) + + [:material-download: Tải xuống Ice + White Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20White.pdf) + + ![AtlasOS Ice + Black Logomark](assets/brand/preview/logomark/preview-logomark-ice-black.png){ width=250 loading=lazy } + + *Ice + Black Logomark* + + [:material-download: Tải xuống Ice + Black Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.png) + + [:material-download: Tải xuống Ice + Black Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.svg) + + [:material-download: Tải xuống Ice + Black Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/ice/Logomark%20-%20Ice%20Black.pdf) + +=== "Black & White" + + ![AtlasOS White Logomark](assets/brand/preview/logomark/preview-logomark-white.png){ width=250 loading=lazy } + + *White Logomark* + + [:material-download: Tải xuống White Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.png) + + [:material-download: Tải xuống White Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.svg) + + [:material-download: Tải xuống White Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/white/Logomark%20-%20White%20White.pdf) + + ![AtlasOS Black Logomark](assets/brand/preview/logomark/preview-logomark-black.png){ width=250 loading=lazy } + + *Black Logomark* + + [:material-download: Tải xuống Black Logomark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.png) + + [:material-download: Tải xuống Black Logomark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.svg) + + [:material-download: Tải xuống Black Logomark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/logomark/black/Logomark%20-%20Black%20Black.pdf) + +## Wordmarks + +=== "Atlas Colors" + + ![AtlasOS Ice Wordmark](assets/brand/preview/wordmark/preview-wordmark-ice.png){ width=250 loading=lazy } + + *Ice Wordmark* + + [:material-download: Tải xuống Ice Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.png) + + [:material-download: Tải xuống Ice Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.svg) + + [:material-download: Tải xuống Ice Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Ice.pdf) + + ![AtlasOS Clouds Wordmark](assets/brand/preview/wordmark/preview-wordmark-clouds.png){ width=250 loading=lazy } + + *Clouds Wordmark* + + [:material-download: Tải xuống Clouds Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.png) + + [:material-download: Tải xuống Clouds Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.svg) + + [:material-download: Tải xuống Clouds Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Clouds.pdf) + + ![AtlasOS Night Wordmark](assets/brand/preview/wordmark/preview-wordmark-night.png){ width=250 loading=lazy } + + *Night Wordmark* + + [:material-download: Tải xuống Night Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.png) + + [:material-download: Tải xuống Night Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.svg) + + [:material-download: Tải xuống Night Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/official/Wordmark%20-%20Night.pdf) + +=== "Black & White" + + ![AtlasOS White Wordmark](assets/brand/preview/wordmark/preview-wordmark-white.png){ width=250 loading=lazy } + + *White Wordmark* + + [:material-download: Tải xuống White Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.png) + + [:material-download: Tải xuống White Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.svg) + + [:material-download: Tải xuống White Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/white/Wordmark%20-%20White.pdf) + + ![AtlasOS Black Wordmark](assets/brand/preview/wordmark/preview-wordmark-black.png){ width=250 loading=lazy } + + *Black Wordmark* + + [:material-download: Tải xuống Black Wordmark .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.png) + + [:material-download: Tải xuống Black Wordmark .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.svg) + + [:material-download: Tải xuống Black Wordmark .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wordmark/black/Wordmark%20-%20Black.pdf) + +## Icon + +=== "Atlas Colors" + + ![AtlasOS Ice Icon](assets/brand/preview/icons/preview-icon-ice.png){ width=128 loading=lazy } + + *Ice Icon* + + [:material-download: Tải xuống Ice Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.png) + + [:material-download: Tải xuống Ice Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.svg) + + [:material-download: Tải xuống Ice Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Ice.pdf) + + ![AtlasOS Clouds Icon](assets/brand/preview/icons/preview-icon-cloud.png){ width=128 loading=lazy } + + *Clouds Icon* + + [:material-download: Tải xuống Clouds Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.png) + + [:material-download: Tải xuống Clouds Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.svg) + + [:material-download: Tải xuống Clouds Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Clouds.pdf) + + ![AtlasOS Night Icon](assets/brand/preview/icons/preview-icon-night.png){ width=128 loading=lazy } + + *Night Icon* + + [:material-download: Tải xuống Night Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.png) + + [:material-download: Tải xuống Night Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.svg) + + [:material-download: Tải xuống Night Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/official/Icon%20-%20Night.pdf) + +=== "Black & White" + + ![AtlasOS White Icon](assets/brand/preview/icons/preview-icon-white.png){ width=128 loading=lazy } + + *White Icon* + + [:material-download: Tải xuống White Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.png) + + [:material-download: Tải xuống White Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.svg) + + [:material-download: Tải xuống White Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/white/Icon%20-%20White.pdf) + + ![AtlasOS Black Icon](assets/brand/preview/icons/preview-icon-black.png){ width=128 loading=lazy } + + *Black Icon* + + [:material-download: Tải xuống Black Icon .png](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.png) + + [:material-download: Tải xuống Black Icon .svg](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.svg) + + [:material-download: Tải xuống Black Icon .pdf](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/icons/black/Icon%20-%20Black.pdf) + +## Hình nền + +### Atlas v0.3 + +#### Version 1 + +=== "v0.3 Version 1" + + ![AtlasOS v0.3 Version 1 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper%2016_9%20-%20v0.3-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3.png) + + [:material-download: Tải xuống v0.3 Version 1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3.png) + + [:material-download: Tải xuống v0.3 Version 1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3.png) + + [:material-download: Tải xuống v0.3 Version 1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3.png) + +=== "v0.3 Version 1.1" + + ![AtlasOS v0.3 Version 1.1 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper%2016_9%20-%20v0.3%20v2-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 1.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3%20v2.png) + + [:material-download: Tải xuống v0.3 Version 1.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3%20v2.png) + + [:material-download: Tải xuống v0.3 Version 1.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3%20v2.png) + + [:material-download: Tải xuống v0.3 Version 1.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3%20v2.png) + +=== "v0.3 Version 1.2" + + ![AtlasOS v0.3 Version 1.2 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v1/preview/Wallpapper%2016_9%20-%20v0.3%20v3-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 1.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v1/Wallpapper%2016_9%20-%20v0.3%20v3.png) + + [:material-download: Tải xuống v0.3 Version 1.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v1/Wallpapper%2016_10%20-%20v0.3%20v3.png) + + [:material-download: Tải xuống v0.3 Version 1.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v1/Wallpapper%2021_9%20-%20v0.3%20v3.png) + + [:material-download: Tải xuống v0.3 Version 1.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v1/Wallpapper%204_3%20-%20v0.3%20v3.png) + +#### Version 2 + +=== "v0.3 Version 2" + + ![AtlasOS v0.3 Version 2 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper%2016_9%20-%20v0.3%20v4-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v2/Wallpapper%2016_9%20-%20v0.3%20v4.png) + + [:material-download: Tải xuống v0.3 Version 2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v2/Wallpapper%2016_10%20-%20v0.3%20v4.png) + + [:material-download: Tải xuống v0.3 Version 2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v2/Wallpapper%2021_9%20-%20v0.3%20v4.png) + + [:material-download: Tải xuống v0.3 Version 2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v2/Wallpapper%2014_3%20-%20v0.3%20v4.png) + +=== "v0.3 Version 2.1" + + ![AtlasOS v0.3 Version 2.1 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v2/preview/Wallpapper%2016_9%20-%20v0.3%20v7-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 2.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v2/Wallpapper%2016_9%20-%20v0.3%20v7.png) + + [:material-download: Tải xuống v0.3 Version 2.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v2/Wallpapper%2016_10%20-%20v0.3%20v7.png) + + [:material-download: Tải xuống v0.3 Version 2.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v2/Wallpapper%2021_9%20-%20v0.3%20v7.png) + + [:material-download: Tải xuống v0.3 Version 2.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v2/Wallpapper%2014_3%20-%20v0.3%20v7.png) + +#### Version 3 + +=== "v0.3 Version 3" + + ![AtlasOS v0.3 Version 3 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper%2016_9%20-%20v0.3%20v5-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v5.png) + + [:material-download: Tải xuống v0.3 Version 3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v5.png) + + [:material-download: Tải xuống v0.3 Version 3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v5.png) + + [:material-download: Tải xuống v0.3 Version 3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v5.png) + +=== "v0.3 Version 3.1" + + ![AtlasOS v0.3 Version 3.1 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper%2016_9%20-%20v0.3%20v6-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 3.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v6.png) + + [:material-download: Tải xuống v0.3 Version 3.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v6.png) + + [:material-download: Tải xuống v0.3 Version 3.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v6.png) + + [:material-download: Tải xuống v0.3 Version 3.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v6.png) + +=== "v0.3 Version 3.2" + + ![AtlasOS v0.3 Version 3.2 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper%2016_9%20-%20v0.3%20v8-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 3.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v8.png) + + [:material-download: Tải xuống v0.3 Version 3.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v8.png) + + [:material-download: Tải xuống v0.3 Version 3.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v8.png) + + [:material-download: Tải xuống v0.3 Version 3.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v8.png) + +=== "v0.3 Version 3.3" + + ![AtlasOS v0.3 Version 3.3 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v3/preview/Wallpapper%2016_9%20-%20v0.3%20v9-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 3.3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v3/Wallpapper%2016_9%20-%20v0.3%20v9.png) + + [:material-download: Tải xuống v0.3 Version 3.3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v3/Wallpapper%2016_10%20-%20v0.3%20v9.png) + + [:material-download: Tải xuống v0.3 Version 3.3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v3/Wallpapper%2021_9%20-%20v0.3%20v9.png) + + [:material-download: Tải xuống v0.3 Version 3.3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v3/Wallpapper%204_3%20-%20v0.3%20v9.png) + +#### Version 4 + +=== "v0.3 Version 4" + + ![AtlasOS v0.3 Version 4 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper%2016_9%20-%20v0.3%20v10-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 4 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v10.png) + + [:material-download: Tải xuống v0.3 Version 4 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v10.png) + + [:material-download: Tải xuống v0.3 Version 4 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v10.png) + + [:material-download: Tải xuống v0.3 Version 4 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v10.png) + +=== "v0.3 Version 4.1" + + ![AtlasOS v0.3 Version 4.1 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper%2016_9%20-%20v0.3%20v11-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 4.1 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v11.png) + + [:material-download: Tải xuống v0.3 Version 4.1 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v11.png) + + [:material-download: Tải xuống v0.3 Version 4.1 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v11.png) + + [:material-download: Tải xuống v0.3 Version 4.1 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v11.png) + +=== "v0.3 Version 4.2" + + ![AtlasOS v0.3 Version 4.2 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper%2016_9%20-%20v0.3%20v12-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 4.2 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v12.png) + + [:material-download: Tải xuống v0.3 Version 4.2 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v12.png) + + [:material-download: Tải xuống v0.3 Version 4.2 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v12.png) + + [:material-download: Tải xuống v0.3 Version 4.2 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v12.png) + +=== "v0.3 Version 4.3" + + ![AtlasOS v0.3 Version 4.3 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper%2016_9%20-%20v0.3%20v13-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 4.3 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v13.png) + + [:material-download: Tải xuống v0.3 Version 4.3 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v13.png) + + [:material-download: Tải xuống v0.3 Version 4.3 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v13.png) + + [:material-download: Tải xuống v0.3 Version 4.3 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v13.png) + +=== "v0.3 Version 4.4" + + ![AtlasOS v0.3 Version 4.4 Wallpaper](assets/brand/wallpapers/16_9/v0.3/v4/preview/Wallpapper%2016_9%20-%20v0.3%20v14-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống v0.3 Version 4.4 Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/v0.3/v4/Wallpapper%2016_9%20-%20v0.3%20v14.png) + + [:material-download: Tải xuống v0.3 Version 4.4 Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/v0.3/v4/Wallpapper%2016_10%20-%20v0.3%20v14.png) + + [:material-download: Tải xuống v0.3 Version 4.4 Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/v0.3/v4/Wallpapper%2021_9%20-%20v0.3%20v14.png) + + [:material-download: Tải xuống v0.3 Version 4.4 Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/v0.3/v4/Wallpapper%204_3%20-%20v0.3%20v14.png) + +### Generic + +=== "Ice Wordmark" + + ![AtlasOS Ice Wordmark Wallpaper](assets/brand/wallpapers/16_9/generic/preview/Wallpapper%2016_9%20-%20Ice%20Wordmark-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống Ice Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Ice%20Wordmark.png) + + [:material-download: Tải xuống Ice Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Ice%20Wordmark.png) + + [:material-download: Tải xuống Ice Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Ice%20Wordmark.png) + + [:material-download: Tải xuống Ice Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Ice%20Wordmark.png) + +=== "Clouds Wordmark" + + ![AtlasOS Clouds Wordmark Wallpaper](assets/brand/wallpapers/16_9/generic/preview/Wallpapper%2016_9%20-%20Clouds%20Wordmark-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống Clouds Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Clouds%20Wordmark.png) + + [:material-download: Tải xuống Clouds Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Clouds%20Wordmark.png) + + [:material-download: Tải xuống Clouds Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Clouds%20Wordmark.png) + + [:material-download: Tải xuống Clouds Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Clouds%20Wordmark.png) + +=== "Night Wordmark" + + ![AtlasOS Night Wordmark Wallpaper](assets/brand/wallpapers/16_9/generic/preview/Wallpapper%2016_9%20-%20Night%20Wordmark-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống Night Wordmark Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Night%20Wordmark.png) + + [:material-download: Tải xuống Night Wordmark Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Night%20Wordmark.png) + + [:material-download: Tải xuống Night Wordmark Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_+/generic/Wallpapper%2021_9%20-%20Night%20Wordmark.png) + + [:material-download: Tải xuống Night Wordmark Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Night%20Wordmark.png) + +=== "Night Pride" + + ![AtlasOS Night Pride Wallpaper](assets/brand/wallpapers/16_9/generic/preview/Wallpapper%2016_9%20-%20Night%20Pride-preview.png){ width=650 loading=lazy } + + [:material-download: Tải xuống Night Pride Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Night%20Pride.png) + + [:material-download: Tải xuống Night Pride Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Night%20Pride.png) + + [:material-download: Tải xuống Night Pride Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Night%20Pride.png) + + [:material-download: Tải xuống Night Pride Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Night%20Pride.png) + +=== "Setup" + + ![AtlasOS Setup Wallpaper](assets/brand/wallpapers/16_9/generic/preview/Wallpapper%2016_9%20-%20Setup-preview.png){ width=650 loading=lazy } + + *Photo taken by [Roberto Nickson (@rpnickson)](https://unsplash.com/@rpnickson) via Unsplash.* + + [:material-download: Tải xuống Setup Wallpaper 16:9 (3840x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_9/generic/Wallpapper%2016_9%20-%20Setup.png) + + [:material-download: Tải xuống Setup Wallpaper 16:10 (3440x2400)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/16_10/generic/Wallpapper%2016_10%20-%20Setup.png) + + [:material-download: Tải xuống Setup Wallpaper 21:9 (5120x2160)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/21_9/generic/Wallpapper%2021_9%20-%20Setup.png) + + [:material-download: Tải xuống Setup Wallpaper 4:3 (3072x2304)](https://gcore.jsdelivr.net/gh/Atlas-OS/branding@main/wallpapers/4_3/generic/Wallpapper%204_3%20-%20Setup.png) diff --git a/docs/vi/contributions.md b/docs/vi/contributions.md new file mode 100644 index 00000000..49f21fd0 --- /dev/null +++ b/docs/vi/contributions.md @@ -0,0 +1,93 @@ +--- +description: The official contribution guidelines for the AtlasOS playbook +icon: material/handshake +--- + +# Hướng dẫn đóng góp + +This page provides guidelines on how to contribute to Atlas. All contributions are much appreciated! + +Atlas uses Git to manage everything on the platform [:simple-github: GitHub](https://github.com/Atlas-OS). To more easily interact with Git, you can use: + +* An IDE like [:simple-visualstudiocode: Visual Studio Code](https://code.visualstudio.com/) or [:simple-vscodium: VSCodium](https://vscodium.com) +* [:simple-github: GitHub Desktop](https://desktop.github.com/) (recommended) + +Alternatively, you can use the [:simple-git: Git](https://git-scm.com/) command-line. Use whichever Git interface you find most familiar and easiest. Before contributing, you should [research](https://docs.github.com/en/get-started/quickstart) about Git first. + +## :octicons-git-commit-24: How you can contribute + +* [:material-pen-plus: **Atlas Playbook**](https://github.com/Atlas-OS/Atlas) - The Atlas playbook (`.apbx`) that is used in AME Wizard ([GPL-3.0](https://github.com/Atlas-OS/Atlas/blob/main/LICENSE)) ([:octicons-code-of-conduct-16: CoC](https://github.com/Atlas-OS/Atlas/blob/main/.github/CODE_OF_CONDUCT.md)) + * Refer to the AME Wizard [:material-file-document: Documentation](https://docs.ameliorated.io/developers.html) for help + * You can also contribute to the `README.md` and its translations, which is the only exclusion for committing to the `main` branch +* [:material-language-rust: **Atlas Utilities**](https://github.com/Atlas-OS/Atlas-Utilities) - General tools used in Atlas like `filepicker.exe`, made in Rust ([GPLv3](https://github.com/Atlas-OS/Atlas-Utilities/blob/main/LICENSE)) +* [:material-book-plus-multiple: **Atlas Documentation**](https://github.com/Atlas-OS/docs) - The website that you are looking at ([CC-BY-SA-4.0](https://github.com/Atlas-OS/docs/blob/master/LICENSE)) ([:octicons-code-of-conduct-16: CoC](https://github.com/Atlas-OS/docs/blob/master/.github/CODE_OF_CONDUCT.md)) + * Read [this](https://github.com/Atlas-OS/docs/blob/master/.github/CONTRIBUTING.md) documentation-specific contribution guide as well as these contribution guidelines to setup a development environment + * Reading the [GitHub documentation contribution guide](https://github.com/github/docs/blob/main/CONTRIBUTING.md) might also be useful + +These are the three main repositories to contribute to. There might also may be other repositories that fits your expertise. [Check out our GitHub organisation](https://github.com/Atlas-OS). + +If a repository has a specified template for pull requests or issues, please use them. Otherwise, your pull request could be closed. + +## :material-chat-question: How it works + +Each repository has a `dev` branch and a `main` or `master` branch for development. + +!!! warning + Make **all of your changes** to the `dev` branch of the respective repositories! + + Never commit or pull request directly to the `main` branches, with the **only exception** being committing to the `main` branch on the main repository for translations. + +The `dev` branch exists to ensure that only approved and high-quality changes are merged into the `main` branch. + +A pull request **every week** will be automatically created to merge the `dev` branch into the `main` branch, where the changes can be properly reviewed by **5 contributors** before the pull request is merged. The only exclusion to having less than 5 reviews is if there's not enough people reviewing, e.g. 4 reviews for documentation. + +This ensures that all changes are thoroughly reviewed and agreed upon collectively, resulting in fewer bugs, improved code quality, and a more organized development process. + +You will have to make your own fork of the respective Atlas repository, and then make a pull request to merge your modified fork's branch into the `dev` branch. + +### :material-git: People with write access + +!!! note + This only applies to people with direct access to commit to the repositories, without the need to do a pull request. + + This list is from our [GitHub organisation's member list](https://github.com/orgs/Atlas-OS/people). + +For any significant changes, consider creating a pull request for the `dev` branch instead of committing directly. + +This means less potential headache in the future if the change is disagreed upon, as you can avoid reverting all of the disliked changes for the automatic pull request every week. + +If you want to, you can also manually trigger the automatic pull request to merge `dev` into `main` early, but the 5 reviews will still be in effect. As a note, if you need to urgently fix something, you can use the `bypass` label to bypass your pull request being automatically closed by the pull request filter. + +For regular pull requests, you can make your own branch in the Atlas repository or make a fork, it is your choice. + +## :material-format-letter-case: Formatting + +Before each commit, ensure that: + +* Your changes comply with the overall formatting of a repository +* There are the most minimal amount of mistakes, check grammar and anything else important + * For any YAML changed, please verify that it is valid before committing with [YAML Lint](https://www.yamllint.com/) +* People would generally agree with the change + * If you don't know, ask people in the [Discord](https://discord.gg/atlasos) or [GitHub issues](https://github.com/Atlas-OS/Atlas/issues) + +Making sure that your commits are already to a high standard means that development will be faster and more organised. However, keep in mind that it's okay to make mistakes sometimes, as people will give feedback/reviews in your pull requests, so don't worry about it too much. + +### :octicons-verified-16: Commit Signature Verification +We highly recommend setting up [commit signature verification](https://docs.github.com/en/authentication/managing-commit-signature-verification). This marks your commits as 'Verified', indicating they come from a trusted source. + +You can install [:simple-gnuprivacyguard: GPG](https://gnupg.org/) (used for signing) in Windows with [Scoop](https://scoop.sh/) with the following command: +``` +scoop install gpg +``` +Check out this [detailed guide on setting up verified commits](https://gist.github.com/Beneboe/3183a8a9eb53439dbee07c90b344c77e#file-how-to-setup-verified-commits-md). + +### :octicons-git-branch-16: Conventional Commits + +We recommend using [:simple-conventionalcommits: Conventional Commits](https://www.conventionalcommits.org/) in Atlas repositories for consistency and more descriptive commits. You can also take a look at [Angular's Conventional Commits](https://github.com/angular/angular/blob/68a6a07/CONTRIBUTING.md#commit) for more guidance. + +Conventional Commits are a type of commit message format that helps to make the commit history more readable and easier to navigate. + +*Example*: [`feat: ✨ add fAllowFullControl`](https://github.com/Atlas-OS/Atlas/commit/72cdcc7b327df19fd07e9c6eb0a10812ac6936b0) + +- [**Extension for Visual Studio Code**](https://github.com/vivaxy/vscode-conventional-commits) +- [**Emoji reference**](https://gitmoji.dev) (optional) diff --git a/docs/vi/faq-and-troubleshooting/atlas-and-security.md b/docs/vi/faq-and-troubleshooting/atlas-and-security.md new file mode 100644 index 00000000..071bcb22 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/atlas-and-security.md @@ -0,0 +1,10 @@ +--- +description: Atlas bảo mật đến đâu? +icon: material/shield +--- + +# Atlas bảo mật đến đâu? + +**Atlas bảo mật như cách bạn muốn, với khả năng bật hoặc tắt Defender, bật hoặc tắt Core isolation và tương thích với Windows Update.** + +Ngoài ra Atlas cũng thực hiện các cải tiến về bảo mật trong Windows bằng cách vô hiệu hóa nhiều tính năng cũ và có nguy cơ bị tấn công cao. diff --git a/docs/vi/faq-and-troubleshooting/atlas-folder-scripts.md b/docs/vi/faq-and-troubleshooting/atlas-folder-scripts.md new file mode 100644 index 00000000..3d2132c9 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/atlas-folder-scripts.md @@ -0,0 +1,55 @@ +--- +description: All troubleshooting scripts bundled in the AtlasOS playbook +icon: material/script +--- + +# Những tập lệnh trong Atlas + +Atlas đi kèm với một số tập lệnh đơn giản để khắc phục sự cố trong thư mục "Atlas". Các tập lệnh đi kèm này có thể giúp bạn tìm ra nguyên nhân của các vấn đề mà bạn đang gặp phải và đưa Atlas trở lại trạng thái ban đầu. + +## :material-network-outline: Mạng + +!!! warning "Hãy khởi động lại thiết bị sau khi chạy các tập lệnh" + Những thay đổi đối với mạng được thực hiện bằng tập lệnh Atlas sẽ không hoạt động đúng cho đến khi bạn khởi động lại thiết bị của mình. Sau khi chạy tập lệnh mạng Atlas, hãy nhớ lưu công việc của bạn và khởi động lại máy tính. + +### Đặt lại (reset) mạng + +Nếu bạn đang loay hoay với các cài đặt mạng của mình để cố gắng khắc phục hoặc cải thiện chúng thì việc đặt lại chúng về cài đặt mặc định của Windows hoặc Atlas có thể hữu ích. + +Nếu bạn gặp sự cố với kết nối mạng sau khi cài đặt Atlas lần đầu tiên, có thể việc đặt lại cài đặt mạng về mặc định của Windows sẽ hữu ích. Sử dụng cài đặt mạng mặc định trong Windows có thể giúp bạn biết rằng liệu những tối ưu hóa mạng của Atlas có phải là nguyên nhân gây ra sự cố Internet của bạn hay không. + +Nếu bạn đã thay đổi cài đặt mạng nhưng muốn quay lại sử dụng những cài đặt mạng và tối ưu hóa của Atlas ban đầu, bạn có thể đặt lại cài đặt mạng của mình về mặc định của Atlas. Thao tác này sẽ khôi phục tất cả cài đặt Internet từ bản cài đặt Atlas mới. + +## :material-shield-lock-outline: Chế độ An toàn (Safe Mode) + +Chế độ an toàn khởi động Windows theo cách rất đơn giản, chỉ với một vài tệp và driver. Nếu sự cố không xảy ra ở chế độ an toàn, điều đó có nghĩa là sự cố đó không phải do cài đặt mặc định hoặc driver cơ bản gây ra. Xem cách Windows hoạt động ở chế độ an toàn có thể giúp bạn tìm ra nguyên nhân sự cố để bạn có thể khắc phục sự cố trên máy tính của mình. + +!!! danger "Chế độ an toàn có thể gây nhầm lẫn" + Chế độ an toàn là trạng thái trong Windows chỉ có những thành phần cần thiết và cơ bản nhất để chạy Windows. Vì vậy, bạn có thể gặp khó khăn về những gì bạn cần làm để vào chế độ an toàn. Bạn không cần phải sử dụng chế độ an toàn trừ khi bạn biết mình đang làm gì hoặc đang làm theo hướng dẫn đáng tin cậy. + + Chế độ an toàn có thể giúp trong việc: + + * Gỡ cài đặt hoặc sửa lỗi driver. + * Cố gắng diệt virus. + +### Chế độ An toàn (Safe Mode) + +Chế độ an toàn khởi động máy tính của bạn trong chế độ an toàn mặc định mà chỉ có những driver và file cần thiết để Windows chạy. Bạn sẽ KHÔNG thể kết nối internet ở chế độ này. + +### Chế độ an toàn với Command Prompt (Safe Mode with Command Prompt) + +Command Prompt (CMD) có sẵn ở tất cả các chế độ của chế độ an toàn, nhưng "Chế độ an toàn với Command Prompt" chỉ cung cấp cho bạn cửa sổ Command Prompt. Bạn sẽ không có giao diện người dùng để giúp bạn điều hướng hệ thống của mình. Thay vào đó, bạn sẽ có dấu nhắc lệnh cấp quản trị viên (Administrator). + +### Chế độ an toàn có kết nối mạng (Safe Mode with Networking) + +Chế độ An toàn có Kết nối mạng có chức năng tương tự như chế độ an toàn không có kết nối mạng. Thế nhưng Chế độ an toàn có kết nối mạng sẽ bổ sung thêm driver mạng và dịch vụ bạn cần để kết nối với internet. + +## :material-cog-outline: Dịch vụ + +*Chúng tôi rất tiếc nhưng tài liệu cho việc này vẫn chưa được viết. Bạn có thể đóng góp cho chúng tôi tại [https://github.com/Atlas-OS/docs](https://github.com/Atlas-OS/docs).* + +## :material-brain: Visual C++ Redistributables + +Microsoft Visual C++ Redistributables là một phần quan trọng của bất kỳ máy tính Windows nào. Visual C++ Redistributables phải được cài đặt trên máy tính của bạn để nhiều game và phần mềm hoạt động. Đây là lý do tại sao hầu hết các bản Visual C++ Redistributable đã được cài đặt trên Atlas. + +Tập lệnh "Reinstall Visual C++ Redistributables" sử dụng một bản đóng gói tất-cả-trong-một của Visual C++ Redistributables có tên là [abbodi1406/vcredist](https://github.com/abbodi1406/vcredist). Điều này sẽ giúp bạn có thể dễ dàng cài đặt các bản Visual C++ Redistributable mới hoặc cài đặt lại những cái bị hỏng. diff --git a/docs/vi/faq-and-troubleshooting/common-questions/adobe-acrobat.md b/docs/vi/faq-and-troubleshooting/common-questions/adobe-acrobat.md new file mode 100644 index 00000000..f87f7943 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/adobe-acrobat.md @@ -0,0 +1,14 @@ +--- +description: How to fix Adobe Acrobat fails to install on AtlasOS +icon: simple/adobe +--- + +# How to fix Adobe Acrobat not installing? + +**Printing must be enabled (via the Atlas folder) to install Adobe Acrobat correctly** + +This can be found in the Atlas folder, under configuration. + +This is because Adobe installs the "Adobe PDF" printer on your system. Adobe PDF is a printer driver that saves documents in a format called Adobe PDF. + + diff --git a/docs/vi/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md b/docs/vi/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md new file mode 100644 index 00000000..37fd2148 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/ame-wizard-virus-detection.md @@ -0,0 +1,12 @@ +--- +description: Why is AME Wizard being detected as a virus? +icon: material/virus +--- + +# Why is AME Wizard being detected as a virus? + +**AME Wizard can be falsely flagged as a virus when a new version is published. To avoid it being detected, add it to your Windows Defender exclusions list.** + +Windows Security may automatically flag AME Wizard as malicious when trying to run it, or may even delete it before running it. + +To avoid these problems you can temporarily disable **Real Time Protection** or follow [AME's Security Exceptions Documentation (recommended)](https://docs.ameliorated.io/guides/security-exceptions.html). diff --git a/docs/vi/faq-and-troubleshooting/common-questions/atlas-folder-missing.md b/docs/vi/faq-and-troubleshooting/common-questions/atlas-folder-missing.md new file mode 100644 index 00000000..2837d12e --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/atlas-folder-missing.md @@ -0,0 +1,12 @@ +--- +description: Làm cách nào để sửa lỗi thư mục Atlas bị thiếu +icon: material/folder-question +--- + +# Làm cách nào để sửa lỗi thư mục Atlas bị thiếu? + +**Nếu không có lối tắt đến thư mục trên màn hình chính (Desktop), bạn có thể tìm nó ở đây: `C:/Windows/AtlasDesktop`.** + +Nếu bạn muốn có thư mục trên màn hình chính của mình thì thay vì di chuyển thư mục chính, chúng tôi khuyên bạn nên tạo một lối tắt và đặt nó trên màn hình của mình. + + diff --git a/docs/vi/faq-and-troubleshooting/common-questions/atlas-iso-files.md b/docs/vi/faq-and-troubleshooting/common-questions/atlas-iso-files.md new file mode 100644 index 00000000..f43a1d2e --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/atlas-iso-files.md @@ -0,0 +1,14 @@ +--- +description: Where can I find the Atlas ISO file? +icon: material/disc +--- + +# Where is the Atlas ISO file? + +**Atlas doesn't have an ISO file. It uses AME Wizard to modify Windows on a new live installation, applying configurations like an ISO file.** + +Distributing ISO files violates Microsoft's End-User License Agreement (EULA) and poses safety risks due to uncertainty about the contents. To ensure compliance and safety, we use AME Wizard and release updates directly from our GitHub repository. We also include a checksum with each release so you can verify the integrity of your download. + +> "For software downloads, unless expressly permitted in the accompanying License Terms or End-User License Agreement (EULA), Microsoft does not allow redistribution. You may link to the download page, but not directly to the download, from your product or website." + +🔗 [https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions](https://www.microsoft.com/en-us/legal/intellectualproperty/copyright/permissions) diff --git a/docs/vi/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md b/docs/vi/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md new file mode 100644 index 00000000..f5364ae7 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/bluetooth-compatibility.md @@ -0,0 +1,23 @@ +--- +description: Does Bluetooth work on AtlasOS? +icon: material/bluetooth +--- + +# Does Bluetooth work on AtlasOS? + +**Yes, Bluetooth is fully functional on AtlasOS. You can choose to enable or disable it during the installation process.** + +If you're using AtlasOS and have not enabled Automatic Driver Installation, you will need to install the Bluetooth driver manually. + +Follow these steps to set up Bluetooth: + +1. Enable Bluetooth in the Atlas folder. + +2. Install your Bluetooth driver. You can get this from your device's OEM or follow our [SDIO guide](../../getting-started/post-installation/drivers/getting-started.md#snappy-driver-installer-origin). + - Most issues with Bluetooth are caused by installing improper drivers. Make sure to research and find the driver that is suited for your device. + +3. Turn ON Bluetooth and pair your device. + + + +If these steps did not resolve your issue, try researching further into the driver you should download for your system. These are almost always the cause and are not an issue directly with AtlasOS. diff --git a/docs/vi/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md b/docs/vi/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md new file mode 100644 index 00000000..5fef5525 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md @@ -0,0 +1,18 @@ +--- +description: A guide on how to decrypt your system drive using BitLocker +icon: material/lock-check +--- + +# Decrypting a BitLocker Encrypted Drive + +BitLocker is a powerful encryption tool pre-installed on many retail notebooks, particularly those running Windows 11. This guide will walk you through the process of decrypting your system drive (usually the `C:` drive) using BitLocker. + +!!! warning "BitLocker data loss" + BitLocker is a powerful encryption tool, and using it improperly may result in data loss. It is safe to follow these instructions, but failure to follow steps may result in loss of data. + +1. Run Command Prompt (`CMD`) with **Administrator privileges**. You can do this by searching for **CMD** in the Start menu, right-clicking on it, and selecting **Run as administrator**. +2. Type `manage-bde -off %SystemDrive%` and press Enter. This command starts the decryption process. + - If you see the error message [ERROR: This volume stores external key(s) that can automatically unlock other volumes.](../../assets/images/bitlocker-error-decrypting.jpg), type `manage-bde -autounlock - ClearAllKeys %SystemDrive%` and press Enter to clear the keys. After completion, re-type `manage-bde -off %SystemDrive%` and press Enter to continue decrypting. +3. If you see the message **Decryption is now in progress**, you have completed the steps correctly. The decryption process will take some time. +4. You can check the progress by typing `manage-bde -status` and pressing Enter. Look for the `C:` drive and the [percentage encrypted](../../assets/images/bitlocker-decryption-progress.png). +5. When the decryption percentage reaches **0%**, you've successfully decrypted the drive! diff --git a/docs/vi/faq-and-troubleshooting/common-questions/itunes-compatibility.md b/docs/vi/faq-and-troubleshooting/common-questions/itunes-compatibility.md new file mode 100644 index 00000000..18ffffd3 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/itunes-compatibility.md @@ -0,0 +1,21 @@ +--- +description: How to fix Itunes not recognising Apple device? +icon: material/apple +--- + +**If iTunes is not recognizing your Apple device, it's likely a driver issue. You can fix this by downloading and installing the Apple USB Drivers.** + +If you're using Atlas and have not enabled [Automatic Driver Installation](../../getting-started/post-installation/atlas-folder/configuration.md#driver-updates), you will need to install the Apple USB driver manually. + +## :material-package-down: Manual Installation + +!!! tip + If you're experiencing significant issues with drivers, consider enabling [Automatic Driver Installation](../../getting-started/post-installation/atlas-folder/configuration.md#driver-updates) from the Atlas folder. + +1. Download the latest Apple USB drivers from the [Microsoft Update Catalog](https://www.catalog.update.microsoft.com/Search.aspx?q=Apple%2C%20Inc.%20-%20USBDevice) that begins with a three-digit version number. + + ![Image saying that you should only select the Apple USB driver that starts with a three digit version](../../assets/images/apple-driver-version.png) + +2. Extract the downloaded zip file using 7-Zip or Explorer. Ignore any warnings that may appear. + +3. Find the `.inf` file in the extracted folder. **Right-click** on the `.inf` file and select **Install**. diff --git a/docs/vi/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md b/docs/vi/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md new file mode 100644 index 00000000..dc51c91d --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/microsoft-store-compatibility.md @@ -0,0 +1,12 @@ +--- +description: Does Microsoft Store work on AtlasOS? +icon: material/microsoft +--- + +**Yes, the Microsoft Store works seamlessly with AtlasOS right from the start.** + +If you encounter any issues with the Microsoft Store on AtlasOS, follow these troubleshooting steps: + +1. Open the **Command Prompt** (CMD) with **Administrator Privileges**. You can do this by searching for 'CMD' in the Start menu, right-clicking on it, and selecting 'Run as administrator'. +2. In the Command Prompt, type `wsreset.exe` and press Enter. This command resets the Microsoft Store without changing your settings or apps. +3. Try opening the Microsoft Store again. diff --git a/docs/vi/faq-and-troubleshooting/common-questions/reverting-atlas.md b/docs/vi/faq-and-troubleshooting/common-questions/reverting-atlas.md new file mode 100644 index 00000000..dfde1c97 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/reverting-atlas.md @@ -0,0 +1,16 @@ +--- +description: How do I return to Windows after installing AtlasOS? +icon: material/microsoft-windows +--- + +# How do I return to Windows after installing AtlasOS? + +**You'll need to reinstall Windows to revert Atlas' modification.** + +This is required because our installation instructions on our documentation guide you to reinstall Windows (deleting your previous install), and then, install Atlas. + +If you need help reinstalling Windows, you can use Google, YouTube or follow our guide on how to install Atlas, but skip out running AME Wizard. + +This will get you to a completely stock Windows installation. + +🔗 [https://docs.atlasos.net/getting-started/installation/](../../getting-started/installation.md) diff --git a/docs/vi/faq-and-troubleshooting/common-questions/windows-build-not-supported.md b/docs/vi/faq-and-troubleshooting/common-questions/windows-build-not-supported.md new file mode 100644 index 00000000..656bead2 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/common-questions/windows-build-not-supported.md @@ -0,0 +1,44 @@ +--- +description: What to do if your Windows build is not supported by AtlasOS. +icon: material/microsoft-windows-classic +--- + +**If your current build is not supported by AtlasOS, you may need to update.** + +To see if your build matches the AtlasOS requirements, follow this guide: + +## :material-wrench-cog-outline: Checking your version + +1. Check your Windows version. You can do this by pressing ++win+r++ and typing `winver`. + +2. Compare the build number in the window that popped up with the boxes below. If it matches, try to apply the playbook again. If it doesn't match, perform the steps below. + +!!! note "Latest Windows versions" + **:material-microsoft-windows: Windows 10:** + Version 22H2 (OS Build 19045) + + **:material-microsoft: Windows 11:** + Version 23H2 (OS Build 22631) + +![winver-11](../../assets/images/winver-11.png) + +## :material-download: Updating Windows + +=== ":material-microsoft-windows: Windows 10" + Make sure all Windows updates have been completed, you should not have any Windows updates available after clicking the `Check for Updates` button in **Windows Update**. If there are any updates, install them and reboot. Then, [check your version](#checking-your-version). + + If this fails, the only way to fix it is to [reinstall Windows](../../getting-started/installation.md#reinstalling-windows) using an ISO downloaded from the [:material-cogs: Installation Guide](../../getting-started/installation.md#download-an-iso). +=== ":material-microsoft: Windows 11" + + For Windows 11, follow these instructions: + + 1. Make sure all Windows updates have been completed, you should not have any Windows updates available after clicking the `Check for Updates` button in **Windows Update**. If there are any updates, install them and reboot. Then, [check your version](#checking-your-version). + + 2. Download the offline update for Windows 11 23H2 [here](https://catalog.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/caa3ff4a-6420-4341-aeae-33b2d7f463be/public/windows11.0-kb5027397-x64_3a9c368e239bb928c32a790cf1663338d2cad472.msu). + + !!! info "For ARM64 Users" + Your update is available [here](https://catalog.sf.dl.delivery.mp.microsoft.com/filestreamingservice/files/c29dd4ea-7f6a-4636-a991-29ba8ae70658/public/windows11.0-kb5027397-arm64_bacb74fba9077a5b7ae2f74a3ebb0b506f9708f3.msu). + + 3. Open the downloaded file to install the offline update. When prompted, select `Yes` to install the update. This should take a few moments. + + 4. Once the update is complete, restart your computer. You should now be Windows 11 23H2. diff --git a/docs/vi/faq-and-troubleshooting/removed-features.md b/docs/vi/faq-and-troubleshooting/removed-features.md new file mode 100644 index 00000000..9c2c5226 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/removed-features.md @@ -0,0 +1,29 @@ +--- +description: Những tính năng của Windows bị lược bỏ trong Atlas +icon: material/file-remove +--- + +## :material-delete-off: Những tính năng bị lược bỏ trong Atlas + +Lưu ý rằng Atlas được tạo ra để tăng cường hiệu suất và quyền riêng tư nên nhiều tính năng và dịch vụ không cần thiết đã bị tắt. Vì những lý do đó nên sẽ không có cách nào dễ dàng để kích hoạt chúng. Khi các dịch vụ hoặc tính năng bị gỡ bỏ, chúng có thể gây ra sự cố với ứng dụng bạn sử dụng hoặc thậm chí với phần cứng, mặc dù rất khó xảy ra. Hãy ghi nhớ điều này trước khi cài đặt Atlas. + +Atlas loại bỏ các dịch vụ và tính năng sau: + +- :simple-opentelemetry: Telemetry (các thành phần có thể được bật/tắt cho mục đích khắc phục sự cố) +- :material-application-cog: Smart App Control +- :material-sync: Settings Sync + +### :material-application: Ứng dụng hoặc tính năng được xóa theo mặc định + +Chúng có thể được cài đặt lại sau khi cài đặt Atlas nhưng sẽ bị xóa theo mặc định. + +- :material-shopping-outline: Rất nhiều ứng dụng Microsoft Store được cài đặt sẵn +- :material-update: Microsoft Update Health Tools +- :simple-internetexplorer: Internet Explorer +- :material-heart-pulse: PC Health Check +- :simple-microsoftonedrive: OneDrive + +!!! tip "Lưu ý" + Nếu thứ gì đó không hoạt động, hãy thử bật tính năng hoặc dịch vụ trong [thư mục Atlas ngoài màn hình chính (Desktop)](file://C:/Users/default/Desktop/Atlas), và làm theo [Hướng dẫn thiết lập](../getting-started/post-installation/drivers/getting-started.md) để biết thêm thông tin. + + Atlas cho bạn lựa chọn bật/tắt rất nhiều tùy chọn khác mà bạn có thể tìm thấy trong thư mục Atlas ở trên. diff --git a/docs/vi/faq-and-troubleshooting/testing-nightly-builds.md b/docs/vi/faq-and-troubleshooting/testing-nightly-builds.md new file mode 100644 index 00000000..46d9b610 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/testing-nightly-builds.md @@ -0,0 +1,14 @@ +--- +description: Thử nghiệm các bản dựng Atlas +icon: material/test-tube +--- + +# Làm thế nào để tôi thử nghiệm các bản dựng chưa được phát hành của Atlas? + +**Nếu bạn muốn tham gia thử nghiệm các bản dựng dành cho nhà phát triển được phát hành trước, bạn có thể làm như vậy bằng cách thêm vai trò (role) Discord "Development" vào hồ sơ của mình.** + +Chúng tôi rất vui khi mọi người muốn đóng góp cho Atlas. Nếu bạn không biết cách làm việc với AME Wizard hoặc không am hiểu về mặt kỹ thuật khi nói đến registry, đây có thể là điều gì đó bạn có thể đóng góp. + +Chúng tôi thường đăng thông báo về vai trò Discord "Development" khi chúng tôi cần trợ giúp để thử nghiệm các bản phát hành trước mới gần với bản phát hành công khai. Nếu quan tâm, bạn có thể [tham gia máy chủ Discord của chúng tôi](https://discord.atlasos.net/) và áp dụng vai trò (role) "Development" cho hồ sơ của mình. + + diff --git a/docs/vi/faq-and-troubleshooting/updating-atlas.md b/docs/vi/faq-and-troubleshooting/updating-atlas.md new file mode 100644 index 00000000..62fb83bb --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/updating-atlas.md @@ -0,0 +1,10 @@ +--- +description: Làm thế nào để cập nhật Atlas lên phiên bản mới nhất? +icon: material/microsoft-windows +--- + +# Làm thế nào để cập nhật Atlas lên phiên bản mới nhất? + +**Nếu bạn đang sử dụng phiên bản Atlas cũ hơn 0.3.0, bạn KHÔNG thể cập nhật** + +Chúng tôi luôn khuyến khích người dùng mong muốn cập nhật lên phiên bản mới nhất của Atlas thực hiện một cài đặt "sạch" của Atlas (để tránh những sự cố không đáng có). Nếu bạn đang sử dụng phiên bản 0.3.0 và muốn cập nhật lên phiên bản mới hơn, bạn có thể cập nhật "đè" lên phiên bản hiện tại nếu bạn muốn - nhưng nó có thể sẽ gây ra sự cố. \ No newline at end of file diff --git a/docs/vi/faq-and-troubleshooting/who-is-atlas-for.md b/docs/vi/faq-and-troubleshooting/who-is-atlas-for.md new file mode 100644 index 00000000..5dc37d37 --- /dev/null +++ b/docs/vi/faq-and-troubleshooting/who-is-atlas-for.md @@ -0,0 +1,12 @@ +--- +description: Atlas dành cho ai? +icon: material/head-check +--- + +# Atlas dành cho ai? + +**Atlas dành cho bất kỳ người nào muốn cải thiện quyền riêng tư, hiệu suất và tính dễ sử dụng của Windows.** + +Chúng tôi đang cố gắng tạo ra bản sửa đổi Windows mà *hầu hết* mọi người đều có thể sử dụng với ít nhược điểm nhất có thể. + +Mặc dù Atlas được hướng đến với tính tương thích cao nhất, hiệu năng và những thay đổi tốt nhất, bạn có thể phải khắc phục một số sự cố với một số cấu hình Atlas nhất định mà không phải lúc nào cũng phù hợp với tất cả mọi người. diff --git a/docs/vi/getting-started/installation.md b/docs/vi/getting-started/installation.md new file mode 100644 index 00000000..34254ec9 --- /dev/null +++ b/docs/vi/getting-started/installation.md @@ -0,0 +1,216 @@ +--- +title: Cài đặt +description: The official AtlasOS playbook installation guide +icon: material/cogs +--- + +# :material-package-down: Cài đặt AtlasOS + +!!! danger "Hãy đọc trước khi bắt đầu" + + AtlasOS tuân thủ với điều khoản của Windows; việc kích hoạt bản quyền Windows không bị chỉnh sửa bởi AtlasOS. + + Chúng tôi khuyên bạn nên xem qua [những câu hỏi thường gặp](../faq-and-troubleshooting/removed-features.md). + +## :material-clipboard-list-outline: Yêu cầu + +- Thiết bị của bạn cần đáp ứng yêu cầu hệ thống cho [Windows 11](https://www.microsoft.com/en-gb/windows/windows-11-specifications#table1) hoặc [Windows 10](https://www.microsoft.com/en-gb/windows/windows-10-specifications#primaryR2) + - Điều này không bao gồm tài khoản Microsoft, TPM và Secure Boot +- CPU 64-bit ([làm thế nào để kiểm tra](https://support.microsoft.com/en-us/windows/which-version-of-windows-operating-system-am-i-running-628bec99-476a-2c13-5296-9dd081cdd808)) + - 64-bit ARM (aarch64) chỉ được hỗ trợ trên Windows 11 +- Một kết nối mạng ổn định + +## :material-disc: Tải xuống file ISO + +Một file ISO là một file đĩa ảo, giống như một chiếc đĩa DVD mà chúng ta dùng để cài đặt lại Windows trong những cách được khuyến nghị của chúng tôi. + +Trình tải xuống có trong hướng dẫn dưới đây sẽ tạo một link tải file ISO từ Microsoft. Nó sẽ tải phiên bản mới nhất của Windows dành cho CPU Intel và AMD. + +**Được dựa trên:** [Microsoft Software Download Listing](https://github.com/massgravel/msdl) + + + + + +??? grey-tip "Những cách thay thế" + === "Windows Media Creation Tool" + !!! warning "Windows 11" + Atlas chỉ hỗ trợ Windows 10 22H2 và Windows 11 23H2. + + Công cụ Media Creation Tool cho Windows 11 chỉ tải xuống phiên bản 22H2, vì vậy Media Creation Tool cho Windows 11 hiện tại không thể sử dụng được cho Atlas. + + 1. Tải xuống [Windows 10](https://go.microsoft.com/fwlink/?LinkId=691209) Media Creation Tool và chạy. + 2. Nhấn nút `Accept` để đồng ý với điều khoản của Microsoft. + 3. Tick chọn `Create installation media (USB flash drive, DVD, or ISO file) for another PC`, chọn `Next`, và sau đó chọn: + * Language: Ngôn ngữ bạn muốn + * Edition: Windows 10 + * Architecture: 64-bit (x64) + 4. Nhấn vào lựa chọn `ISO file` và lựa chọn nơi lưu file. + 5. Sau khi hoàn tất, nhấn `Finish` để kết thúc trình cài đặt. + +
+
+ + +
+ +
+ +
+

Vui lòng chờ...

+
+ +
+

Một lỗi đã xảy ra trong khi xử lý yêu cầu của bạn. Hãy thử tải lại trang hoặc sử dụng cách thay thế.

+

Lỗi: Không xác định

+
+ +
+

Quá trình tải xuống sẽ sớm được bắt đầu, nếu không, bấm vào đây tải ISO.

+
+ + +
+ +## :material-download: Chuẩn bị + +Các bước sau đây cho rằng bạn có một ổ đĩa riêng để lưu trữ các file cài đặt của Atlas trong quá trình cài đặt lại Windows. Nếu bạn chỉ có một ổ đĩa, hãy làm theo các bước trong phần "Chỉ có một ổ đĩa để lưu trữ file?" bên dưới để tạo một ổ đĩa mới từ ổ đĩa đơn của bạn. + +??? question "Chỉ có một ổ đĩa để lưu trữ file?" + + !!! tip "Gợi ý" + Nếu bạn gặp bất cứ vấn đề gì với Disk Management, bạn cũng có thể sử dụng [Macroit Partition Expert Free Edition](https://macrorit.com/partition-magic-manager/free-edition.html). + + 1. Mở Disk Management bằng cách nhập `diskmgmt.msc` vào cửa sổ Run (Win + R), và tìm đến ổ đĩa Windows của bạn. + 2. Nhấn chuột phải vào phân vùng tạm và chọn 'Delete Volume'. + 3. Nhập `4000` trong số lượng không gian để thu nhỏ ổ đĩa (trong megabytes), tức là 4GB + 4. Bây giờ bạn sẽ có một khoảng trống 'Unallocated', nhấn chuột phải và chọn :material-arrow-right: 'New Simple Volume' + 5. Làm theo trình hướng dẫn, bạn có thể cứ nhấn 'Next' là xong + + Sau khi làm theo các bước này, bạn sẽ có một phân vùng ổ đĩa mới trong File Explorer. Bạn có thể tiếp tục với phần còn lại + +

:material-harddisk-remove: Xóa phân vùng tạm thời

+ + 1. Nhấn chuột phải :material-arrow-right: chọn `Delete volume` + 2. Nhấn chuột phải vào ổ đĩa Windows của bạn :material-arrow-right: chọn `Extend volume` + 3. Làm theo trình hướng dẫn, bạn có thể cứ nhấn 'Next' là xong + +Đầu tiên, tạo một thư mục để lưu trữ file cài đặt Atlas. Tạo một thư mục ở ổ đĩa thứ hai/phân vùng thứ hai với tên `AtlasFiles`. Chúng ta sẽ gọi thư mục này là "thư mục của bạn" trong các bước tiếp theo. + +1. Truy cập trang [tải xuống Atlas](https://atlasos.net/) và tải xuống **AME Wizard** và **Atlas Playbook**. +2. Tải driver mạng từ website của nhà sản xuất và lưu nó trong thư mục của bạn. *(Đây là biện pháp đề phòng trong trường hợp mạng không hoạt động trong quá trình cài đặt )* + - Chúng tôi khuyến cáo bạn nên tìm kiếm theo tên của nhà sản xuất (ví dụ: Dell) và số model của thiết bị. + - Nếu bạn gặp vấn đề, tìm kiếm thiết bị của bạn trong [Device Manager](../assets/images/device-manager-nic.png) và tải xuống driver này. +3. Giải nén `AtlasPlaybook_v[phiên bản].zip` vào thư mục của bạn +4. Giải nén `AME Wizard Beta.exe` từ file `AME Wizard Beta.zip` mà bạn tải xuống trước đó vào thư mục của bạn + +**Bây giờ bạn sẽ có một thư mục `AtlasFiles` với tất cả các file bạn cần trên ổ đĩa/ổ đĩa ngoài.** + +## :material-microsoft-windows: Cài đặt lại Windows + +!!! info "Cài đặt bằng USB" + Nếu bạn muốn cài đặt lại Windows bằng USB, bạn có thể bỏ qua phần này. **Hãy đảm bảo rằng thư mục `AtlasFiles` không bị xóa.** + +!!! tip "Bỏ qua yêu cầu hệ thống của Windows 11 (không bắt buộc)" + Để bỏ qua yêu cầu hệ thống của Windows 11, sử dụng `Bypass Windows 11 Requirements.cmd` trong thư mục của bạn trước khi chạy `sources\setup.exe`. + +Trước khi bắt đầu, hãy sao lưu những file quan trọng vào ổ đĩa thứ hai hoặc một dịch vụ lưu trữ đám mây. + +Tuy nhiên bạn cũng không cần quá lo lắng. Bản Windows cũ của bạn (có chứa dữ liệu người dùng) sẽ được sao chép đến thư mục `Windows.old` ở trong ổ đĩa Windows của bạn. Bạn có thể sử dụng điều này như một biện pháp an toàn nếu bạn quên sao lưu các file quan trọng. + +1. Bấm chuột phải vào file ISO mà bạn đã tải xuống trước đó và chọn **Open With** :material-arrow-right: **File Explorer** để mở nó. + +2. Trong **This PC**, tìm ổ đĩa cho file ISO đã được mở. Mở nó và truy cập vào thư mục `sources`, và chạy `setup.exe`. + - Trên rất nhiều laptop chạy Windows 11, BitLocker được kích hoạt sẵn và mã hóa toàn bộ ổ cứng trên máy. Thông báo ["Make sure BitLocker Drive Encryption is suspended"](../assets/images/bitlocker-error-setup.jpg) sẽ hiện ra khi bạn chạy `setup.exe`. Hãy xem [hướng dẫn mở khóa BitLocker](../faq-and-troubleshooting/common-questions/decryptying-using-bitlocker.md) để giải quyết vấn đề này. + +3. Chọn **No thanks** khi được hỏi về cập nhật và bỏ tick lựa chọn **I want to help make the Windows installation better**. + +4. Chọn **I don't have a product key** vì Windows sẽ được tự động kích hoạt (nếu bạn đang sử dụng Windows bản quyền) + +5. Lựa chọn phiên bản Windows của bạn. Chúng tôi thực sự khuyến nghị và hỗ trợ chính thức phiên bản **Windows Pro**. Nếu bạn không có bản quyền cho Windows Pro, bạn có thể sử dụng phiên bản **Windows Home** *(không được khuyến nghị)*. + +6. Chấp nhận điều khoản và chọn **Custom: Install Windows only (advanced)** + +7. Chọn ổ đĩa Windows của bạn, nhấn tiếp tục, nhấn **OK** nếu có thông báo về `Windows.old` và quá trình cài đặt sẽ bắt đầu. + +### :material-cog: Thiết lập ban đầu (OOBE) + +!!! danger "Kết nối Internet" + + Trong khi thiết lập Windows, hãy đảm bảo rằng **cáp mạng ethernet và Wi-Fi đã được ngắt kết nối**. Đừng kết nối mạng cho đến khi được hướng dẫn. + +=== "Windows 11" + ??? info "Hướng dẫn bằng văn bản" + 1. Sau khi quá trình thiết lập bắt đầu, nhấn giữ ++shift+f10++ để mở Command Prompt. + 2. Nhập `oobe\bypassnro` và nhấn ++enter++. Thiết bị của bạn sẽ khởi động lại. + 3. Tiếp tục thiết lập như bình thường, nhưng hãy nhớ: + - Đừng kết nối Internet + - Từ chối những lựa chọn về quyền riêng tư + +
+ +
+ +=== "Windows 10" + ??? info "Hướng dẫn bằng văn bản" + TBD + +
+ +

Nguồn video hướng dẫn: [@amitxv](https://github.com/amitxv)

+

+ +## :material-screwdriver: Cập nhật driver + +Driver là những thành phần phần mềm cần thiết để hệ điều hành kết nối với những thiết bị phần cứng. Mặc dù Windows có sẵn một số driver cơ bản, một số thiết bị Bluetooth, máy in hay loa sẽ cần thêm driver để hoạt động đúng cách. +Việc cài đặt driver tự động giúp đơn giản hóa quy trình và giúp driver luôn được cập nhật, tiết kiệm thời gian và công sức nhưng lại có nhược điểm là cồng kềnh hơn. + +Trước khi tiếp tục, hãy cân nhắc lựa chọn nào phù hợp với bạn và nhớ nó cho những bước tiếp theo. + +| :material-download: Cài đặt và cập nhật driver thủ công (khuyến khích) | :material-update: Cài đặt và cập nhật driver tự động | +| ------------------------------------ | --------------------------------------- | +| :material-check-all: Có thể sử dụng ít tài nguyên hệ thống hơn | :material-check-all: Cực kì dễ dàng nếu bạn không biết cách lấy driver | +| :material-check-all: Có thể sẽ ít những phần mềm đi kèm | :material-check: Khả năng tương thích tốt nhất, đặc biệt là với các ứng dụng OEM | +| :material-check: Kiểm soát hoàn toàn phiên bản driver của bạn | :material-check: Thuận tiện khi kết nối các thiết bị mới | +| :material-alert-circle-outline: Có thể chuyển sang cập nhật driver tự động sau | :material-check: Có những cập nhật tính năng và bảo mật mới nhất | + +## :material-wrench-cog-outline: Cài đặt AtlasOS + +!!! tip "Lưu ý" + Bản Windows trước đó của bạn sẽ được chuyển vào thư mục `Windows.old` trong ổ đĩa Windows trong quá trình cài đặt lại. Bạn có thể sao chép mọi file cần thiết từ thư mục này trước khi xóa nó. + + Để xóa bản Windows trước đó của bạn, hãy mở cài đặt Windows (Settings) :material-arrow-right: System :material-arrow-right: Storage. Chọn 'Temporary files', chọn 'Previous version of Windows', và sau đó bấm vào 'Remove files'. + +Như được nhắc đến trước đó trong phần [Cập nhật Driver](#driver-updates), bạn có 2 lựa chọn để cài đặt driver: Thủ công và Tự động. Hãy chọn một trong hai lựa chọn này trước khi tiến hành. + +1. Sao chép thư mục `AtlasFiles` từ ổ đĩa thứ hai/phân vùng thứ hai ra ngoài màn hình chính (Desktop). +2. Nếu bạn đã chọn **Cài đặt driver thủ công**, chạy `Disable Drivers Installation in Windows Update.reg` và khởi động lại thiết bị +3. Kết nối internet cho thiết bị (cắm dây Ethernet hoặc Wi-Fi) + - Nếu bạn không thể kết nối internet, [cài đặt driver mạng](https://www.techspot.com/community/topics/how-to-install-a-driver-when-theres-no-installation-exe-file-to-run.171861/) mà bạn đã tải về từ trước và đã lưu trong thư mục AtlasFiles. +4. Mở **Windows Settings** và cập nhật Windows cho đến khi không còn bản cập nhật nào nữa. Ngoài ra, bạn cũng nên mở **Microsoft Store** và cập nhật toàn bộ ứng dụng. + - Bạn sẽ cần phải khởi động lại sau khi hoàn thành cập nhật. Sau khi khởi động lại, hãy kiểm tra lại các bản cập nhật nhiều lần cho đến khi không còn bản cập nhật nào hiện ra +5. Mở thư mục `AtlasFiles` và chạy `AME Wizard Beta.exe` + - Bấm vào **Updates** ở phía trên cùng của ứng dụng và kiểm tra các bản cập nhật AME Wizard + - SmartScreen có thể sẽ cảnh báo rằng AME Wizard là một ứng dụng không được xác thực vì nó không có chữ ký điện tử. Bạn có thể bỏ qua cảnh báo này bằng cách nhấp vào **More info** và sau đó chọn **Run anyway**. +6. Kéo và thả file `Atlas Playbook.apbx` vào AME Wizard từ thư mục `AtlasFiles` +7. Làm theo hướng dẫn trên màn hình để cài đặt AtlasOS + +!!! danger "Tại sao AME Wizard lại tự động đóng và bị xóa?" + Để ngăn Windows Defender đóng và xóa file AME Wizard, bạn nên thêm AME Wizard vào danh sách loại trừ trong cài đặt Windows Security. Điều này thường cần thiết khi một phiên bản AME Wizard mới được phát hành mà phiên bản này chưa được nhiều người sử dụng. + + Để đọc thêm về vấn đề này, hãy xem tài liệu về [Security Exceptions](https://docs.ameliorated.io/guides/security-exceptions.html) từ đội ngũ Ameliorated. + +Khi hoàn tất, bạn sẽ thấy thư mục `Atlas` trên màn hình chính (Desktop). Chúng tôi hướng dẫn bạn cách cấu hình Atlas bằng thư mục này tại phần [Sau khi cài đặt](post-installation/drivers/getting-started.md) của tài liệu. + +### :material-bug-outline: Xử lí sự cố +!!! tip "Cần hỗ trợ?" + Nếu bạn gặp bất kì vấn đề nào trong quá trình cài đặt, bạn có thể tìm kiếm sự giúp đỡ trên [Diễn đàn](https://forum.atlasos.net) hoặc [máy chủ Discord](https://discord.atlasos.net). Chúng tôi có một cộng đồng lớn gồm những người luôn muốn quan tâm và giúp bạn với nhiều vấn đề khác nhau. + + Chúng tôi khuyến nghị bạn nên xem trang [Những câu hỏi thường gặp](../faq-and-troubleshooting/removed-features.md) trước khi đăng lên máy chủ Discord hoặc Diễn đàn của chúng tôi để đỡ tốn thời gian cho các câu hỏi phổ biến mà đã được trả lời từ trước. diff --git a/docs/vi/getting-started/post-installation/atlas-folder/advanced-configuration.md b/docs/vi/getting-started/post-installation/atlas-folder/advanced-configuration.md new file mode 100644 index 00000000..95cca53e --- /dev/null +++ b/docs/vi/getting-started/post-installation/atlas-folder/advanced-configuration.md @@ -0,0 +1,63 @@ +--- +description: An overview of all advanced configuration options installed by the AtlasOS playbook +icon: material/sign-caution +--- + +# Advanced Configuration + +If you are not confident with your technical ability, it is recommended to avoid this section. Any misinterpretation can result in compatibility issues and other problems. Therefore, it's important to understand what you are doing and how to revert it. This section is intended for advanced users only. + +All of the configuration files listed here are located in the `6. Advanced Configuration` folder. In the Atlas folder which is on the Desktop. If you deleted the folder, check out [our guide to restore the Atlas folder](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md). + +## Affinity + +Affinities allow you to specify which core a driver or process runs on. As Windows puts most drivers on Core 0 by default, we can alter this to improve performance and latency. Allocating drivers to their own core will reduce interrupts on Core 0. + +This folder contains a few links to some tools to manually set driver affinities. + +## Boot Configuration + +Here you can change the boot configuration for Windows, which can modify the quality of life and pre-boot behavior. + +You can either completely mess things up or potentially (unlikely) improve performance with experimental options. + +## DSCP + +The Differentiated Services Code Point (DSCP) is a policy for managing network traffic. It prioritizes data from specific applications and games to ensure optimal performance and responsiveness. + +When running the script, it will ask you for an executable. Select the executable (game binary file) to enable DSCP. + +## NVIDIA Display Container + +This allows you to enable/disable the 'NVIDIA Display Container LS service', which connects to a few NVIDIA IPs and uses a tiny bit of CPU usage. +These scripts are aimed at users that have a stripped driver, and people that barely touch the NVIDIA Control Panel. + +## Static IP + +In this section, you can set up your network configuration as a Static IP, which can be a useful choice if your computer serves as a local server or if you need to do port forwarding. This method also reduces the number of services required. + +## Utilities + +The files in this folder are open-source projects in our [GitHub utilities repository](https://github.com/Atlas-OS/utilities). + +### Process Explorer + +Process Explorer is an application part of Microsoft Sysinternals Suite of utilities. Process Explorer can be best described as an advanced version of the Task Manager, allowing the user to see what resources a program is using. More information can be found on [Microsoft's documentation for process explorer](https://learn.microsoft.com/en-us/sysinternals/downloads/process-explorer). + +This folder has scripts that can automate the installation/uninstallation of this utility. + +### Gameutil + +Gameutil is our own utility that can be used to automate tasks such as setting Timer Resolution, killing Desktop Window Manager (DWM) or Explorer, disabling CPU Idle states and cleaning memory. In our GitHub repository, we have some [usage instructions & description](https://github.com/Atlas-OS/utilities/tree/dev#gameutil-rs) to help you get started. + +We only recommend the use of Gameutil for Windows 10, as has yet to be updated for full Windows 11 support. + +### MSI Utility V3 + +This is a utility to allows you to enable the Message Signaled Interrupts (MSI) feature on your system's devices, which may help improve performance by eliminating interrupt conflicts from multiple devices. We have a link in this folder to a forum post which further explains the performance and latency benefits of MSI mode, along with the download link for MSI Utility V3. + +## Wi-Fi + +Wi-Fi is a feature in Windows that lets your computer connect to the internet wirelessly. On Atlas, it has been enabled by default since it is very widely used. To disable it just run the `Disable Wi-Fi.cmd` file in the `Wi-Fi` folder. + +You may need to [install drivers](../drivers/getting-started.md) for Wi-Fi to work. diff --git a/docs/vi/getting-started/post-installation/atlas-folder/configuration.md b/docs/vi/getting-started/post-installation/atlas-folder/configuration.md new file mode 100644 index 00000000..d57f8e66 --- /dev/null +++ b/docs/vi/getting-started/post-installation/atlas-folder/configuration.md @@ -0,0 +1,131 @@ +--- +description: An overview of all general configuration options installed by the AtlasOS playbook +icon: material/cog +--- + +# Cấu hình + +Trong phần này, chúng tôi sẽ trình bày danh sách đầy đủ các tùy chọn cấu hình chung có sẵn trong thư mục Atlas. Điều quan trọng cần lưu ý là bạn chỉ nên sửa đổi các cài đặt cấu hình này nếu bạn hiểu đầy đủ về những gì mình đang làm hoặc nếu một quản trị viên yêu cầu bạn làm như vậy một cách cụ thể. + +Để biết thêm tùy chọn cấu hình, hãy xem thêm: + +- [Cấu hình nâng cao](advanced-configuration.md) +- [Các tinh chỉnh tùy ý](optional-tweaks.md) +- [Cấu hình Windows](windows-settings.md) + +Tất cả các tập tin cấu hình được liệt kê ở đây đều nằm trong thư mục `3. Configuration` trong thư mục Atlas trên màn hình chính (Desktop). Nếu bạn đã xóa thư mục, hãy xem [hướng dẫn về cách khôi phục thư mục Atlas](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md). + +Lưu ý: Để thuận tiện cho bạn trong việc tìm kiếm các thư mục, chúng tôi sẽ giữ tên gốc của các thư mục (bằng tiếng Anh) trong hướng dẫn này. Tất nhiên sẽ có bản dịch tiếng Việt ở bên cạnh nên bạn không cần quá lo lắng đâu 😁. + +## Background Apps (Ứng dụng chạy trong nền) + +Theo mặc định, chúng tôi tắt các ứng dụng nền trong Windows, tuy nhiên, bạn có thể cần bật tính năng này. Lý do phổ biến để kích hoạt lại là vì game Sea of Thieves. Để bật ứng dụng nền, hãy chạy `Enable Background Apps.reg` trong thư mục `Background Apps` và khởi động lại máy. + +## Bluetooth + +Bluetooth là một tính năng tích hợp trong Windows cho phép bạn kết nối các thiết bị với máy tính của mình. Trên Atlas, nó đã bị tắt theo mặc định để giúp hệ thống phản hồi nhanh hơn và ít cồng kềnh hơn. Để kích hoạt nó, hãy chạy file `Enable Bluetooth.cmd` trong thư mục `Bluetooth` và khởi động lại máy. + +Bạn có thể cần cài đặt driver để Bluetooth hoạt động. [Xem hướng dẫn của chúng tôi tại đây](../../../faq-and-troubleshooting/common-questions/bluetooth-compatibility.md). + +## Diagnostics and Troubleshooting (Chẩn đoán và khắc phục sự cố) + +Troubleshooting là một tính năng tích hợp sẵn trong Windows, được sử dụng để giúp bạn khắc phục sự cố với máy tính của mình. Trên Atlas, chúng tôi đã tắt tính năng này theo mặc định để tránh bất kỳ chỉnh sửa nào của Atlas bị đặt lại. Để kích hoạt nó chỉ cần chạy file `Enable Troubleshooting.cmd` trong thư mục `Diagnostics and Troubleshooting` và khởi động lại máy. + +## Driver Updates (Cập nhật driver) + +Khi cài đặt Atlas, bạn có thể chọn giữa Cài đặt driver tự động và Cài đặt driver thủ công. Thư mục này chứa các file để bạn thay đổi giữa mỗi tùy chọn, nếu bạn quyết định làm như vậy khi sử dụng Atlas. + +Khi bạn đã chạy lựa chọn mong muốn, hãy khởi động lại thiết bị của bạn để những thay đổi có hiệu lực. + +## FSO và Game Bar + +Game Bar là một tính năng tích hợp sẵn trong Windows, được sử dụng để ghi màn hình, chụp ảnh màn hình, hiển thị thông tin hiệu suất, v.v. Điều đó dựa vào [Tối ưu hóa toàn màn hình (Fullscreen Optimizations)](https://devblogs.microsoft.com/directx/demystifying-full-screen-optimizations/), hay còn được gọi tắt là FSO. + +In Atlas, FSO is enabled by default, but Game Bar is removed. You can enable Game Bar support by using `Enable FSO & Game Bar.reg` and getting Game Bar from the [Microsoft Store](ms-windows-store://review/?ProductId=9NZKPSTSNW4P). + +If you want to disable FSO and use [Fullscreen Exclusive](https://wiki.special-k.info/en/SwapChain) instead, run `Disable FSO & Game Bar.reg` and this should fix all issues with the **Disable full-screen optimisations** compatibility option in modern Windows. +## Game Mode + +Game Mode is a built-in feature in Windows that aims to make your system work better for gaming-related tasks, but it can also make some games run slower. + +It does this by turning off services and background processes which are not needed for gaming. It has been proven that it is not as helpful as it seems to be according to the latest research. + +By default, this is turned off, but you can turn it on by running the `Enable Game Mode.reg` file. This can be found in the folder called "Game Mode." + +## HAGS + +HAGS (Hardware-Accelerated GPU Scheduling) is a built-in feature in Windows that aims to make your system more performant in GPU-intensive tasks, but it may not produce positive results for every system, so you should test it on your system to see for yourself. + +## Lanman Workstation (SMB) + +Lanman Workstation (SMB) is a built-in feature in Windows which is used to connect to other computers that are on the same network. On Atlas, it has been disabled by default to make the system more responsive and less bloated. To enable it run the `Enable Lanman Workstation.cmd` file in the `Lanman Workstation (SMB)` folder. + +## Network Discovery + +Network Discovery is a built-in feature in Windows which is used to discover other computers on your network. On Atlas, we have enabled it by default. To disable it just run the `Disable Network Discovery Services.cmd` file in the `Network Discovery` folder and restart. + +### File Sharing +File Sharing is a part of Network Discovery and by default is disabled. If you wish to send files across your local connection to other Windows devices, run the `Enable File Sharing.cmd` file in the `File Sharing` folder and restart. + +### Network Navigation Pane +Network Navigation pane is a part of network discovery and controls whether the "Network" options show in the File Explorer. If you want to see the Network Pane, run the `User Network Navigation Pane choice.reg` file in the `Network Navigation Pane` folder and restart. + +## Notifications + +Notifications are a built-in feature in Windows which are used to show you notifications. On Atlas, we have enabled them by default. If you wish to disable them, run the `Disable Notifications.cmd` file in the `Notifications` folder and restart. + +## Power + +The Power folder is a folder that allows you to manage power-related settings. + +### CPU Idle + +Disabling idle reduces jitter and increases responsiveness as the CPU is forced to operate at C-State 0 which prevents the CPU clocks constantly fluctuating and eliminates the latency penalty introduced from the time taken to restore and transition to a higher C-State. + +The drawbacks of forcing the CPU to operate at C0 are increased power consumption and higher temperatures, so it is not recommended to disable idle if you leave your PC running for extended durations, have inadequate cooling, uncontrolled voltages or a laptop. + +### Hibernation + +Hibernation is a feature in Windows that allows you to put your computer to sleep. It temporarily saves all of the current memory/RAM onto your disk, in case of power loss. + +Hibernation is disabled by default due to the potential stability issues it can cause, but you can enable it by running the `Enable Hibernation.cmd` in the `Hibernation` folder. + +### Power Saving + +In this folder, you will find two files that can either enable or disable power saving. These files not only control the power scheme but also have an impact on other settings that can affect power consumption, thus altering your system's performance. + +If you wish to modify your choice after installation, you can do so through the registry files provided in this folder. + +### Timer Resolution + +Increasing the timer resolution improves precision, which is beneficial for applications that require consistent pacing or sleeping, such as multimedia applications and framerate limiters. This is at the cost of increased power consumption and is not always beneficial for all machines. + +## Printing + +Printing is a built-in feature in Windows which is used to print documents. On Atlas, we have disabled it by default to make the system more responsive and less bloated. To enable it just run the `Enable Printing.cmd` file in the `Printing` folder and restart. + +## Search Indexing + +Search Indexing is a built-in feature in Windows which is used to index files on your computer. On Atlas, we have disabled it by default to make the system more responsive and less bloated. To enable it just run the `Enable Search Indexing.cmd` file in the `Search Indexing` folder and restart. + +## Start Menu + +The start menu folder stores start menu-related configuration options. + +The `Install Open-Shell.cmd` file is there so you can install Open-Shell. You can find more information about it [here.](https://github.com/Open-Shell/Open-Shell-Menu) + +The `Atlas Open-Shell Preset.xml` file is a pre-made preset which we recommend using for Open-Shell, but you can still change the suggested settings to your liking. + +## System Restore + +System Restore is a final resort when it comes to taking snapshots of your machine. By default, it's enabled but you can disable it by running `Disable System Restore.reg` in the `System Restore` folder followed by a system reboot. + +## VPN + +A VPN (Virtual Private Network) is a feature in Windows that lets you connect to the internet more securely and privately. On Atlas, it's enabled by default for compatibility reasons and due to the services & and drivers being set to manual. To disable it, run the `Disable VPN support.cmd` file in the `VPN` folder. + +## Visual Effects + +Windows enables various Visual Effects by default. These include animated menus tooltips, and animations while minimizing and maximizing, all of these enhance the appearance of Windows but can slightly reduce performance. + +On Atlas, visual effects are disabled by default. To restore these effects, run the `Default Windows Visual Effects.cmd` file in the `Visual Effects` folder. diff --git a/docs/vi/getting-started/post-installation/atlas-folder/optional-tweaks.md b/docs/vi/getting-started/post-installation/atlas-folder/optional-tweaks.md new file mode 100644 index 00000000..c192595f --- /dev/null +++ b/docs/vi/getting-started/post-installation/atlas-folder/optional-tweaks.md @@ -0,0 +1,74 @@ +--- +description: An overview of all the optional tweak scripts installed by the AtlasOS playbook +icon: material/hammer +--- + +# Optional Tweaks + +These are some optional tweaks that you can turn on. For example, you could change the old alt-tab to the new one or change the context menu. You can pick and choose how you like your Windows. + +All of the configuration files listed here are located in the `4. Optional Tweaks` folder. In the Atlas folder which is on the Desktop. If you deleted the folder, check out [our guide to restore the Atlas folder](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md). + +## Alt-Tab + +The Alt-Tab folder lets you choose whether to use the new Alt-Tab menu or the old one. The new one is used in Windows 10, and the old one is used in Windows 7. + +Atlas comes with the Legacy Alt-Tab, but if you wish to use the modern menu, run the `Modern Alt-Tab.reg` file. + +## Delivery Optimization + +Delivery Optimization helps speed up Windows Updates by sharing the data via other Windows machines on your local network. We've disabled this to reduce background network usage. If you wish to enable this, run the `Enable Delivery Optimization.reg` file. + +## File Explorer Customization + +This is another folder that lets you change how your default file explorer works. + +### Compact View + +When Windows 11 refreshed the File Explorer, they introduced larger padding to the interface. By default, Atlas sets the File Explorer mode to compact view. You can revert this by going into File Explorer and locating **View** at the top :material-arrow-right: **Compact View** or by running the `Disable Compact View.reg` file. + +### Folders in This PC + +You can change the folders that are shown by default in File Explorer's "This PC" section. By default, we've removed all of the folders in favour of Quick Access. If you wish to restore the folders, run the `Restore all folders in This PC.reg` file. + +### Gallery + +Unique to Windows 11 is the gallary feature. In Atlas we disable by default, but if you wish to restore this, run the `Enable Gallery.reg` file. + +### Quick Access + +In File Explorer, there is a section called "Quick Access" that shows you your pinned folders. By default we show Quick Access, run the `Remove Quick Access.reg` to remove it from File Explorer. + +### Removable Drives in Sidebar + +You can run the `Enable Removable Drives in Sidebar.reg` file to make removable drives show up in the sidebar. + +## Lock Screen + +By default, Atlas has the lock screen enabled. If you would like to disable the lock screen, you can run the `Hide Lock Screen.reg` file. + +## Run With Priority in context menu + +Running with priority is a feature that lets you tell a program how important it should be. By running the `Add Run With Priority In Context Menu.reg` file, you can control app priorities via the context menu (right-click menu). + +## Send To Context Menu + +With the `Debloat Send To Context Menu.cmd` file, you can reduce the items in the "Send to context" menu. + +## Shortcut Icon + +This lets you switch between the Classic and modern looks for the shortcut icons, you also have the option to disable it. By default, this is set to the Windows Default, but you can change it by running the `Classic.reg` to change to the classic style. Alternatively, you can turn off the icon by running the `None (security risk).reg` file. + +None is a security risk because there will be no way to see if an icon is a shortcut or not. This could leave you a victim of attacks. + +## Shortcut Text + +By default, this is turned off, but you can turn it back on by running the `Restore Shortcut Text.reg` file. This will show the text of the start menu shortcuts. + +## Windows 11 Context Menu + +On Atlas, by default, you'll have the old context menu. You can run the `New Context Menu.reg` if you prefer Windows 11's modern context menu. + +## Explorer Patcher + +The shortcut links to a tool that patches several aspects of Explorer to restore the UI from previous versions of Windows. diff --git a/docs/vi/getting-started/post-installation/atlas-folder/security.md b/docs/vi/getting-started/post-installation/atlas-folder/security.md new file mode 100644 index 00000000..97187df7 --- /dev/null +++ b/docs/vi/getting-started/post-installation/atlas-folder/security.md @@ -0,0 +1,84 @@ +--- +title: Security +description: All the configurable security options in AtlasOS +icon: material/security +--- +# Security + +!!! danger "User risk" + Disabling security features is at **your own risk**, and you should only disable any security features if: + + - You know what it does + - You know how to keep yourself safe without it + + **Atlas is not responsible** for any damages caused by disabling security features against our recommendations. + +!!! tip + If you deleted the folder, check out [our guide to restore the Atlas folder](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md).. + +In this section, we will list all of the 'Security' options in the Atlas folder, how to change them and their defaults. + +All of the configuration files listed here are located in the `3. Configuration/5. Security` folder, which is inside of the Atlas folder on the Desktop. + +## :material-cpu-64-bit: Mitigations + +Mitigations refer to software or hardware techniques implemented to address security vulnerabilities or weaknesses in the CPU of a computer. These mitigations help prevent software (e.g. vulnerable games) from being exploited to remotely execute code on system. + +On Atlas, we have scripts and a prompt to enable or disable mitigations within Windows, as some older CPUs have their performance significantly worsened from mitigations. However, it is largely only beneficial on older CPUs, and some newer CPUs (like [Zen 4 CPUs](https://www.phoronix.com/news/AMD-Zen-4-Mitigations-Off)) can be negatively impacted if you disable mitigations, due to newer CPUs being designed for these mitigations. + +There is also [Fault Tolerant Heap](https://learn.microsoft.com/en-us/windows/win32/win7appqual/fault-tolerant-heap "Microsoft FTH documentation") that is disabled on Atlas by default, which applies non-CPU mitigations to processes that are repeatedly crashing, at the cost of significantly reduced performance. If you are having consistent application crashes, try enabling FTH. + +If you have disabled mitigations and face issues with anticheat software, run the `Set Windows Default Mitigations.cmd` script in the `Mitigations` folder. Alternatively, if you want the maximum security, you can use `Enable All Mitigations.cmd`, but that forces all mitigations to be enabled (unlike the Windows default), which can reduce performance significantly and may potentially reduce compatibility. + +## :octicons-shield-check-16: Defender + +For most Windows users, Defender is a **key component** of Windows that protects against many threats from the internet, like ransomware and spyware. However, some users may want to take the risk of using no protection for improved privacy and performance/responsiveness, especially on older hardware, i.e. hard drives. However, disabling Defender puts you at a **much higher risk** of infection that you are responsible for, and it's not recommended by Atlas. + +Please note that if you want to use another trustworthy antivirus program, disabling Defender isn't needed. + +As Atlas believes in user freedom, we have given the option to fully toggle Defender at a component level. You can toggle Defender by using the script in the `Defender` folder and running `Toggle Defender.cmd` for disabling or enabling Defender. The folder also contains tweaks that you can run related to Defender or Windows Security. + +## :material-shield-bug-outline: Core Isolation + +=== "Information" + + [Core isolation](https://support.microsoft.com/en-us/windows/core-isolation-e30ed737-17d8-42f3-a2a9-87521df09b78) is a security feature of Windows that protects important core processes of Windows from malicious software by isolating them in memory. It does this by running those core processes in a virtualized environment. + + Core isolation is mostly meant to protect against vulnerabilities being exploited in important core processes within Windows, and although it does so effectively, this comes at a **major cost of performance**, especially on older CPUs. We recommend disabling Core isolation as the [performance hit](https://www.tomshardware.com/news/windows-11-gaming-benchmarks-performance-vbs-hvci-security) generally outweighs the security benefits for most users. + + For Windows 11 users, Core isolation features are typically enabled by default, as long as your CPU supports Windows 11. + + In the `Core Isolation (VBS)` folder, we provide the `Current Configuration.ps1` script to check which Core isolation features are avaliable, enabled and configured, along with other shortcuts to Core isolation features. Additionally, there is a prompt in AME Wizard for disabling Core isolation features. + +=== "Core Isolation Features" + + Please note that not all features may not be avaliable, due to avaliable hardware security features or your Windows edition and version. Windows 11 should generally have more Core isolation features. + + - Memory integrity + - Also known as HVCI or 'Hypervisor-protected Code Integrity' + - Like a security guard between the core components of Windows + - Credential Guard + - Protects `lsass.exe` by preventing attackers from stealing/dumping credentials from it + - `lsass.exe` contains lots of authentication tokens used by Windows + - Microsoft Vulnerable Driver Blocklist + - A blocklist to block drivers with known security vulnerablities, as drivers have unrestricted access to a system + - Firmware protection + - Protects against a compromised a UEFI/BIOS + - Memory access protection + - Also known as 'Kernel DMA protection' + - Prevents attacks that can occur when a malicious PCI device is plugged in + - A malicious PCI device could be plugged in through a Thunderbolt port, as an example + - Kernel-mode Hardware-enforced Stack Protection + - Protects against [Return-Oriented Programming (ROP)](https://en.wikipedia.org/wiki/Return-oriented_programming) attacks + +## :octicons-shield-lock-16: UAC + +UAC (User Account Control) is a feature in Windows that helps control what changes software can make to your computer. This helps protect against applications malfunctioning and doing harmful changes to your computer. + +Please note that most well-made malware will be able to bypass UAC easily, and that the only true way to protect yourself against UAC bypasses is to turn UAC up to the maximum level. + +When UAC is disabled, everything will be run as Administrator. On the current version of Atlas, it is enabled it by default. To disable it, run the `Disable UAC.cmd` file in the `User Account Control (UAC)`. + +## :octicons-flame-16: Firewall + +Firewall is a built-in feature on Windows which is used to block unwanted connections. On Atlas we have kept this enabled by default to enhance system security. To disable it you can run the `Disable Windows Firewall.cmd` file in the `Firewall` folder. diff --git a/docs/vi/getting-started/post-installation/atlas-folder/windows-settings.md b/docs/vi/getting-started/post-installation/atlas-folder/windows-settings.md new file mode 100644 index 00000000..e59f783c --- /dev/null +++ b/docs/vi/getting-started/post-installation/atlas-folder/windows-settings.md @@ -0,0 +1,53 @@ +--- +description: An overview of the Windows setting shortcuts installed by the AtlasOS playbook +icon: material/microsoft-windows +--- + +# Windows Settings + +Windows Settings is a folder on Atlas that lets you change the most common settings when you set up Atlas. For some of these, you may need to use the "Activation" file and activate Windows. + +All of the configuration files listed here are located in the `3. Configuration/3. Windows Settings` folder. In the Atlas folder which is on the Desktop. If you deleted the folder, check out [our guide to restore the Atlas folder](../../../faq-and-troubleshooting/common-questions/atlas-folder-missing.md). + +When you run these files, you will go straight to the Windows Settings page for the setting you want to configure. + +## :material-lock-open-outline: Activation + +This file will take you to the page in Windows Settings for Activation. Before you can change some of the other settings, you will need to activate Windows. + +Activation is a one-time thing that you will not have to do again. We recommend activating Windows because it gives you more customization features and gets rid of the "Activate Windows" watermark in the bottom right corner. + +!!! warning "Atlas is not pre-activated" + Atlas is **not** a pre-activated version of Windows. If you want to run Atlas legally, you need to have your own Windows license. Before you buy a Windows (Pro OR Home) license, make sure the seller is trusted and the key is legitimate, no matter where you buy it. + +## :material-palette-swatch-outline: Colors + +This file will take you to the Windows Settings page for Colors. You can change the color and styling of your Atlas installation on this page. + +## :material-clock-outline: Date & Time + +This file will take you to the Windows Settings Date & Time page. On this page, you can change and correct how your Atlas installation shows the time and date. + +## :material-apps: Default Apps + +This file will take you to the page in Windows Settings called Default Apps. You can change the default apps for certain file types on this page. For instance, you can change the default browser from Internet Explorer to Chrome. + +## :material-monitor-screenshot: Desktop Icons + +This file will take you to the Windows Settings page for desktop icon settings. On this page, you can change what icons you want to see on your desktop. + +## :material-alphabetical: Language + +This file will take you to the Windows Settings page for language settings. You can change the display and input language of your Atlas installation on this page. + +## :material-account-eye-outline: Privacy + +This file will take you to the Windows Settings page for Privacy. On this page, you can change how private your Atlas installation is. + +## :material-globe-model: Region + +This file will take you to the Windows Settings page to change your country and region settings. + +## :material-menu: Taskbar + +This file will take you to the Windows Settings page for the Taskbar. On this page, you can customize the taskbar to your liking. diff --git a/docs/vi/getting-started/post-installation/drivers/getting-started.md b/docs/vi/getting-started/post-installation/drivers/getting-started.md new file mode 100644 index 00000000..4b063f7e --- /dev/null +++ b/docs/vi/getting-started/post-installation/drivers/getting-started.md @@ -0,0 +1,32 @@ +--- +description: Getting started with installing drivers for AtlasOS +icon: material/progress-download +--- + +# Driver? Tôi nên bắt đầu từ đâu? + +Nếu bạn đã cài đặt AtlasOS thông qua phương pháp Cài đặt driver thủ công, hướng dẫn này sẽ là trợ thủ đắc lực giúp bạn thiết lập hệ thống của mình với tất cả các driver mà bạn có thể cần. + +## :material-emoticon-confused-outline: Tôi cần những driver nào? + +Điều quan trọng là chỉ cài đặt driver cần thiết cho phần cứng hiện không hoạt động đúng cách. Điều này bao gồm driver GPU, driver âm thanh, driver Wi-Fi và driver Bluetooth. + +Nếu không chắc chắn về hãng và driver cần thiết cho từng thiết bị phần cứng, bạn có thể tra cứu phần cứng của mình để xác định tên của các driver cụ thể rồi cài đặt chúng cho phù hợp. + +## :material-cogs: Driver cho card đồ họa (GPU/iGPU) +Chúng tôi khuyên bạn không nên cài đặt driver card đồ họa của mình qua SDIO vì chúng có thể bị lược bỏ quá nhiều thứ. Chúng tôi đã bao gồm hướng dẫn cài đặt cho các hãng card đồ họa phổ biến bên dưới: + +* [NVIDIA](../drivers/gpu/nvidia.md) +* [AMD](../drivers/gpu/amd.md) +* [Intel](../drivers/gpu/intel.md) + +## :material-screwdriver: Snappy Driver Installer Origin (SDIO) + +Snappy Driver Installer Origin (SDIO) có thể giúp bạn tìm driver tương thích với phần cứng của bạn. SDIO quét hệ thống của bạn để tìm driver bị thiếu hoặc cũ và cài đặt những driver mới nhất cho bạn. + +1. Truy cập [trang web của họ](https://www.glenn.delahoy.com/snappy-driver-installer-origin) và tải xuống trình cài đặt trong phần "Download Application". +2. Giải nén file .zip và mở file ``x64``. Thực hiện theo các bước trong trình hướng dẫn. + * Bản x64 là bản duy nhất hoạt động với Atlas. + * Khi được hỏi, hãy chọn "Download indexes only". Nếu không, nó sẽ tải xuống các driver vô dụng và không cần thiết. +3. Đợi SDIO tải xuống các chỉ mục. +4. Chọn driver để cài đặt và nhấn "Install" ở bên trái. diff --git a/docs/vi/getting-started/post-installation/drivers/gpu/amd.md b/docs/vi/getting-started/post-installation/drivers/gpu/amd.md new file mode 100644 index 00000000..f719e247 --- /dev/null +++ b/docs/vi/getting-started/post-installation/drivers/gpu/amd.md @@ -0,0 +1,60 @@ +--- +description: A guide on how to configure and install AMD GPU drivers in AtlasOS +icon: simple/amd +--- + +# Cài đặt driver cho card đồ họa AMD + +Chúng tôi khuyến khích sử dụng RadeonSoftwareSlimmer vì nó là một ứng dụng mã nguồn mở thay thế cho việc gỡ bỏ những thành phần không cần thiết theo cách thủ công. + +## :simple-amd: Cài đặt driver + +- Tải xuống driver WHQL mới nhất được đề xuất từ [Trang hỗ trợ và trình điều khiển AMD](https://www.amd.com/en/support). +- Tải xuống [RadeonSoftwareSlimmer](https://github.com/GSDragoon/RadeonSoftwareSlimmer) với tên ``RadeonSoftwareSlimmer_XXX_net48.zip``. +- Mở ứng dụng và đi đến tab ``Pre Install``. + - Chọn tập tin cài đặt của bạn bằng cách nhấp vào ``Browse`` và sau đó xác nhận bằng cách nhấp đúp vào ``Next``. +- Sau quá trình giải nén, bỏ tick mọi thứ trong tab ``Packages`` ngoại trừ: + - AMD Display Driver + - AMD Settings (Required for Radeon Software) + - Các phần mềm này có thể được yêu cầu cho âm thanh của màn hình: + - AMD Audio CoProcessor Bus Driver + - AMD Audio filter driver + - AMD HDMI Audio driver + - AMD High Definition Audio Controller + - AMD Streaming Audio Filter Driver +- Bỏ tick mọi thứ trong tab ``Scheduled Tasks``. +- Bỏ tick mọi thứ trong phần ``Display Driver Components``. Nếu bạn đang sử dụng âm thanh từ màn hình, đừng xóa ``High Definition Audio Bus``. +- Chọn ``Modify Installer`` và ``Run Installer``, và sau đó tiếp tục cài đặt driver như bình thường. + +## :material-cog: Thiết lập Radeon Software + +- Mở Radeon Software bằng cách nhấn chuột phải vào màn hình chính (Desktop) +- Chấp nhận các điều khoản và nhấp vào biểu tượng Cài đặt (Settings) ở trên cùng bên phải. +- Cấu hình các mục sau trong tab ``Graphics``: + - Wait for Vertical Refresh - Always Off + - Texture Filtering Quality - Performance + - Tessellation Mode - Override application settings + - Maximum Tessellation Level - Off +- Cấu hình các mục sau trong tabe ``Display``: + - AMD FreeSync - Nó có khả năng tăng độ trễ đầu vào do phải xử lý thêm. Trải nghiệm của bạn có thể thay đổi vì nó được cho là đã được cải thiện theo thời gian. + - GPU Scaling - Off + - Color Depth - Giá trị phù hợp với thông số kỹ thuật của màn hình của bạn +- Vô hiệu hóa tất cả các cài đặt trong tab ``Hotkeys`` và tab ``Preferences``. +- Cấu hình độ phân giải và tần số quét của bạn bằng cách chạy lệnh sau trong ++windows+r++: +``` +rundll32 display.dll,ShowAdapterSettings 0 +``` +- Vô hiệu hóa các dịch vụ và driver AMD còn sót lại. Thông thường thì sẽ là dịch vụ ``AMD Crash Defender`` và ``AMD External Events Utility`` (cần thiết cho VRR). + +## :material-desktop-tower: Vô hiệu hóa Multi-Plane Overlay (MPO) + +Việc tắt Multi-plane Overlay (MPO) có thể khắc phục một số ứng dụng máy tính bị nhấp nháy hoặc giật hình, có thể xảy ra trong quá trình phát video bằng cách sử dụng khả năng tăng tốc phần cứng với trình duyệt. Màn hình đen có thể xảy ra khi chuyển tab từ game hoặc ứng dụng sang trình duyệt có video lặp đi lặp lại. Một số ứng dụng dành cho máy tính có thể nhấp nháy hoặc giật hình khi thay đổi kích thước cửa sổ trên một số máy tính. + +MPO có thể được vô hiệu hóa bằng cách chạy lệnh sau trong Command Prompt (CMD) (đảm bảo bạn chạy CMD với tư cách quản trị viên Administrator): +```bat +reg add "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\Dwm" /v "OverlayTestMode" /t REG_DWORD /d "5" /f +``` + +## :material-numeric-0: Buộc trạng thái P-State 0 (nâng cao) + +*Chúng tôi rất tiếc nhưng tài liệu cho việc này vẫn chưa được viết. Bạn có thể đóng góp tại [https://github.com/Atlas-OS/docs](https://github.com/Atlas-OS/docs).* diff --git a/docs/vi/getting-started/post-installation/drivers/gpu/intel.md b/docs/vi/getting-started/post-installation/drivers/gpu/intel.md new file mode 100644 index 00000000..0cf06fe9 --- /dev/null +++ b/docs/vi/getting-started/post-installation/drivers/gpu/intel.md @@ -0,0 +1,8 @@ +--- +description: A guide on how to configure and install Intel GPU drivers in AtlasOS +icon: simple/intel +--- + +# :simple-intel: Cài đặt driver cho card đồ họa Intel + +Bạn có thể cài driver từ [website chính thức của Intel](https://www.intel.com/content/www/us/en/support/products/80939/graphics.html#211969), hoặc sử dụng [Snappy Driver Installer Origin (SDIO)](https://www.glenn.delahoy.com/snappy-driver-installer-origin) hoặc một trình cài đặt driver khác. diff --git a/docs/vi/getting-started/post-installation/drivers/gpu/nvidia.md b/docs/vi/getting-started/post-installation/drivers/gpu/nvidia.md new file mode 100644 index 00000000..fc1ef533 --- /dev/null +++ b/docs/vi/getting-started/post-installation/drivers/gpu/nvidia.md @@ -0,0 +1,62 @@ +--- +description: A guide on how to configure and install NVIDIA GPU drivers in AtlasOS +icon: simple/nvidia +--- + +# Cài đặt driver cho card đồ họa NVIDIA + +Chúng tôi khuyến khích sử dụng NVCleanstall vì nó là một ứng dụng thay thế cho việc gỡ bỏ những thành phần không cần thiết theo cách thủ công. + +## :simple-nvidia: Cài đặt driver + +- Tải xuống [NVCleanstall](https://www.techpowerup.com/download/techpowerup-nvcleanstall). +- Mở phần mềm lên và nhấn ``Next``. +- Hãy đảm bảo rằng chỉ có ``Display Driver`` được chọn và nhấn ``Next``. +- Sau khi tải driver về, hãy tick chọn vào các phần sau: + - Disable Installer Telemetry & Advertising + - Perform a Clean Installation + - Disable [Multiplane Overlay (MPO)](https://docs.atlasos.net/getting-started/post-installation/drivers/gpu/amd/#disable-multi-plane-overlay-mpo) + - Disable Driver Telemetry in ``Show Expert Tweaks`` + - Use method compatible with Easy-Anti-Cheat + - Automatically accept the "driver unsigned" warning +- Nhấn ``Install`` và tiếp tục cài đặt driver NVIDIA như bình thường. + +## :material-cog: Thiết lập NVIDIA Control Panel + +Phần này được dựa trên một phần của [AMIT's documentation](https://github.com/amitxv/PC-Tuning/blob/main/docs/configure-nvidia.md) + +- Mở NVIDIA Control Panel bằng cách nhấn chuột phải trên màn hình chính (Desktop). +- Vô hiệu hóa ``Desktop > Show Notification Tray Icon`` +- Cấu hình các mục sau trong trang ``3D Settings -> Manage 3D settings``: + - Anisotropic filtering - Off + - Antialiasing - Gamma correction - Off + - Low Latency Mode - On (Cài đặt này giới hạn các khung được kết xuất trước ở mức 1) + - Power management mode - Prefer maximum performance + - Shader Cache Size - Unlimited + - Texture filtering - Quality - High performance + - Threaded Optimization - Giảm tải các tác vụ xử lý liên quan đến GPU lên trên CPU, điều này thường ảnh hưởng đến tốc độ khung hình (FPS). Nếu CPU của bạn bị "nghẽn cổ chai", hãy chọn ``Off``. + - Vertical sync - Off +- Cấu hình các mục sau trong trang ``Display -> Change resolution``: + - Lựa chọn độ phân giải và tần số quét của bạn. + - Output dynamic range - Full + - Output color depth - Giá trị phù hợp với thông số kỹ thuật màn hình của bạn +- Nếu muốn bạn có thể tăng mức độ ``Digital vibrance`` (độ tương phản kĩ thuật số) trong ``Display -> Adjust desktop color settings`` vì nó quản lý độ bão hòa và cường độ màu sắc, đồng thời có thể làm giảm mỏi mắt. + - Ngoài ra bạn có thể sử dụng [VibranceGUI](https://vibrancegui.com). +- Cấu hình các mục sau trong trang ``Display -> Adjust desktop size and position``: + - Select a scaling mode - No scaling + - Perform scaling on - Display +- Đặt dynamic range thành ``Full`` trong ``Video -> Adjust video color settings -> Advanced`` + +## :material-numeric-0: Buộc trạng thái P-State 0 (nâng cao) + +!!! danger "Chú ý" + Điều này sẽ bắt buộc trạng thái P-State 0 trên card NVIDIA của bạn **MỌI LÚC**, khiến cho nó luôn chạy ở mức điện năng cao nhất. Bạn không nên thiết lập nó nếu bạn để máy tính ở chế độ chờ trong thời gian dài, có hệ thống tản nhiệt kém hoặc sử dụng laptop. + +Driver NVIDIA buộc trạng thái nguồn cho nhân CUDA không phải xử lí các tác vụ đồ họa trong thời gian thực về trạng thái nguồn P2 thấp hơn thay vì trạng thái P0 tối đa. Sự khác biệt giữa hai trạng thái là xung nhịp bộ nhớ thấp hơn, thế nhưng xung nhịp lõi ở cả hai trạng thái thì vẫn giống hệt nhau [[1](https://github.com/djdallmann/GamingPCSetup/blob/master/CONTENT/RESEARCH/WINDRIVERS/README.md#q-is-there-a-registry-setting-that-can-force-your-display-adapter-to-remain-at-its-highest-performance-state-pstate-p0), [2](https://forums.developer.nvidia.com/t/one-weird-trick-to-get-a-maxwell-v2-gpu-to-reach-its-max-memory-clock/40153)]. + +P-State 0 có thể được đặt bằng cách sử dụng lệnh sau trong Command Prompt được chạy với tư cách quản trị viên (Administrator): +```bat +for /f "tokens=*" %a in ('reg query "HKLM\SYSTEM\CurrentControlSet\Control\Class\{4d36e968-e325-11ce-bfc1-08002be10318}" /t REG_SZ /s /e /f "NVIDIA" ^| findstr "HK"') do (reg add "%a" /v "DisableDynamicPstate" /t REG_DWORD /d "1" /f) +``` + +Sau khi chạy lệnh này, tải và giải nén [NVIDIA Profile Inspector](https://github.com/Orbmu2k/nvidiaProfileInspector). Mở công cụ, kéo xuống phần ``5 - Common`` và đặt ``CUDA - Force P2 State`` về OFF. Nhấn ``Apply changes`` ở góc trên bên phải và đóng ứng dụng. Khởi động lại thiết bị của bạn. diff --git a/docs/vi/getting-started/post-installation/drivers/others.md b/docs/vi/getting-started/post-installation/drivers/others.md new file mode 100644 index 00000000..ad1540b2 --- /dev/null +++ b/docs/vi/getting-started/post-installation/drivers/others.md @@ -0,0 +1,21 @@ +--- +description: A guide on how to install other drivers +icon: material/wrench-cog-outline +--- + +# Những driver khác thì sao? + +When it comes to other drives, which includes Bluetooth, Scanners, Printer drivers we recommend to **download directly from the OEM of the device,** or use SDIO as a back up option. + +Snappy Driver Installer Origin (SDIO) scans your device for connected and wireless devices which don't have drivers. + +## :material-screwdriver: Snappy Driver Installer Origin + +Snappy Driver Installer Origin (SDIO) can help you finding drivers which are compatible with your hardware. SDIO scans your system for missing or outdated drivers and installs the most up-to-date ones for you. + +1. Visit [their website](https://www.glenn.delahoy.com/snappy-driver-installer-origin) and download the installer under the "Download Application" section. +2. Extract the .zip file and open the ``x64`` file. Follow the steps in the wizard. + * The x64 build is the only one that works with Atlas. + * When prompted, select "Download indexes only". Otherwise, you'll download useless drivers. +3. Wait for SDIO to download the indexes. +4. Select drivers to install and press "Install" on the left. diff --git a/docs/vi/getting-started/post-installation/software/index.md b/docs/vi/getting-started/post-installation/software/index.md new file mode 100644 index 00000000..fbc94cb9 --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/index.md @@ -0,0 +1,21 @@ +--- +title: Cài đặt phần mềm +description: The recommended way to install software in AtlasOS +icon: material/download +--- + +# Cài đặt phần mềm + +Bạn nên sử dụng các gói phần mềm để cài đặt phần mềm. Tuy nhiên, nếu không muốn sử dụng chúng thì bạn có thể cài đặt phần mềm trực tiếp từ Internet thông qua những nguồn chính thức, giống như bạn thường làm. + +Trong trường hợp này, chúng ta sẽ sử dụng `winget`. Đây cũng là trình cài đặt được cài đặt sẵn trên mọi máy tính. + +## :material-package-down: Trình quản lý gói Windows (Windows Package Manager) là cái gì thế? + +WinGet là trình quản lý gói Windows mặc định được Microsoft cài đặt thông qua App Installer trên Microsoft Store, với kho phần mềm do cộng đồng đóng góp. Nó giống như apt-get và Homebrew trên Linux và macOS. Nó cho phép bạn cài đặt phần mềm trên máy tính từ dòng lệnh. + +## :material-shape-plus-outline: Cài đặt phần mềm với WinGet + +Bạn có thể cài đặt phần mềm chúng tôi đã liệt kê bằng WinGet bằng cách truy cập thư mục `1. Software` và chạy tệp lệnh `Install Software.ps1` trong thư mục Atlas. + +Ngoài ra, bạn có thể cài đặt phần mềm bằng cách gõ `winget install ` trong dòng lệnh (Command Line). Bạn có thể tìm tên của các gói tệp trên trang web [winget.run](https://winget.run). diff --git a/docs/vi/getting-started/post-installation/software/media-playback.md b/docs/vi/getting-started/post-installation/software/media-playback.md new file mode 100644 index 00000000..e1d2c642 --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/media-playback.md @@ -0,0 +1,43 @@ +--- +title: Phần mềm đa phương tiện +description: Recommended media software for AtlasOS +icon: simple/vlcmediaplayer +--- + +# Đa phương tiện + +Mặc định, chúng tôi giữ lại Windows Media Player (phiên bản cũ). Nếu bạn đang tìm kiếm thứ gì khác, chúng tôi sẽ đề cập đến nhiều tùy chọn hơn trong hướng dẫn này. + +## VLC Media Player + +Một trong những trình phát media được biết đến nhiều nhất vì nó hoạt động rất tốt. Nó có tất cả các codec bạn cần cài đặt và sẵn sàng để phát tất cả các video hoặc nhạc mà bạn muốn. + +`winget install -e --id VideoLAN.VLC` + +[Tải xuống VLC Media Player](ms-windows-store://pdp/?ProductId=XPDM1ZW6815MQM) + +## MPV + +MPV chủ yếu được sử dụng thông qua dòng lệnh. Tuy nhiên, chúng tôi khuyên bạn nên sử dụng một phiên bản MPV có giao diện đồ họa thân thiện hơn với người dùng và có sẵn trên Microsoft Store để truy cập dễ dàng hơn. MPV hỗ trợ nhiều loại đầu ra video và cung cấp nhiều tính năng được những người đam mê video đánh giá cao. + +`winget install -e --id 9N64SQZTB3LM` + +[Tải xuống phân nhánh mpv.net](ms-windows-store://pdp/?ProductId=9N64SQZTB3LM) + +## Windows Media Player + +Windows Media Player là một tính năng tích hợp sẵn của hệ điều hành Windows nhưng theo mặc định, nó không có trong Atlas. Đây là một công cụ hữu ích để phát video và nhạc, đồng thời cung cấp nhiều tính năng nâng cao hơn ứng dụng Movies & TV. Tuy nhiên, theo mặc định, nó không bao gồm tất cả các codec như MPV hoặc VLC Media Player. Để sử dụng Windows Media Player, bạn có thể cần cài đặt gói mở rộng codec. + +[Tải xuống Windows Media Player](ms-windows-store://pdp/?ProductId=9WZDNCRFJ3PT) + +## Movies & TV + +Windows có một ứng dụng video tích hợp có tên là Movies & TV. Tuy nhiên, nó không được bao gồm trong Atlas theo mặc định. Ứng dụng này hữu ích để phát video và cung cấp nhiều tính năng nâng cao hơn Windows Media Player. Điều quan trọng cần lưu ý là Movies & TV không bao gồm tất cả các codec như MPV hoặc VLC Media Player theo mặc định và có thể yêu cầu người dùng mua thêm codec. + +[Tải xuống Movies & TV](ms-windows-store://pdp/?ProductId=9WZDNCRFJ3PT) | [Tải xuống Codec HEVC](ms-windows-store://pdp/?ProductId=9N4WGH0Z6VHQ) + +## foobar2000 + +foobar2000 là một trình phát nhạc cho phép bạn phát cả nhạc cục bộ và trực tuyến. Nó có thể xử lý âm thanh của nhiều bản nhạc và thân thiện với người dùng. + +[Tải xuống foobar2000](https://www.foobar2000.org/). diff --git a/docs/vi/getting-started/post-installation/software/screenshotting.md b/docs/vi/getting-started/post-installation/software/screenshotting.md new file mode 100644 index 00000000..25f6bdfd --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/screenshotting.md @@ -0,0 +1,27 @@ +--- +title: Chụp ảnh màn hình +description: Recommended screenshotting software for AtlasOS +icon: material/camera +--- + +# Chụp ảnh màn hình + +Trong Windows, Snipping Tool không được sử dụng mặc định bởi Atlas, thế nhưng nó có thể được cài đặt lại từ Microsoft Store. Tuy vậy, chúng tôi vẫn giữ lại phím tắt để chup ảnh màn hình nhanh chóng: ++win+shift+s++. + +Nếu bạn đang tìm kiếm thứ gì đó nâng cao hơn, chúng tôi khuyên bạn nên sử dụng các tùy chọn sau. + +## ShareX + +ShareX là một công cụ nâng cao để chụp ảnh màn hình. Nó không chỉ cho phép bạn chụp ảnh màn hình mà còn cung cấp các tùy chọn nâng cao để chỉnh sửa và nâng cao hình ảnh đã chụp. Với nhiều tính năng, ShareX là lựa chọn tốt nhất để chụp và chỉnh sửa ảnh chụp màn hình, khiến nó trở thành lựa chọn lý tưởng cho hầu hết người dùng. + +`winget install -e --id ShareX.ShareX` + +[Tải xuống ShareX](ms-windows-store://pdp/?ProductId=9NBLGGH4Z1SP) + +## Lightshot + +Lightshot là một công cụ chụp ảnh màn hình nhẹ và độc quyền cho phép bạn chụp và chỉnh sửa ảnh chụp màn hình. Nó có thể được cài đặt và chạy trên hầu hết các máy tính. + +`winget install -e --id Skillbrains.Lightshot` + +[Tải xuống Lightshot](https://app.prntscr.com/en/index.html) diff --git a/docs/vi/getting-started/post-installation/software/system-info.md b/docs/vi/getting-started/post-installation/software/system-info.md new file mode 100644 index 00000000..9f23fa02 --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/system-info.md @@ -0,0 +1,45 @@ +--- +title: Phần mềm xem thông tin của hệ thống +description: Recommended system information software for AtlasOS +icon: material/information +--- + +# Thông tin hệ thống + +Các công cụ thông tin hệ thống cung cấp cho bạn thông tin về hệ thống của bạn, chẳng hạn như nhiệt độ, mức sử dụng CPU, mức sử dụng RAM, v.v. Thông tin này có thể hữu ích cho việc sửa lỗi và khắc phục sự cố trên hệ thống của bạn. Có nhiều lựa chọn về phần mềm thông tin hệ thống khác nhau, vì vậy chúng tôi sẽ chia nhỏ những thứ đó cho bạn ở bên dưới. + +### Task Manager + +Task Manager là một ứng dụng được cài đặt sẵn trong Windows cho phép bạn theo dõi hiệu suất hệ thống của mình. Nó rất hữu ích để theo dõi việc sử dụng CPU, mức sử dụng RAM và các thông tin hệ thống có liên quan khác. Hơn nữa, nó là một công cụ hiệu quả để khắc phục sự cố và xác định các sự cố hệ thống. Mặc dù đây là ứng dụng mặc định cho phần mềm thông tin hệ thống nhưng nó có thể không cung cấp nhiều dữ liệu như bạn muốn, chẳng hạn như nhiệt độ. + +## HWiNFO + +HWiNFO là phần mềm thông tin hệ thống cung cấp cho bạn những phân tích chuyên sâu về các hoạt động quan trọng của máy tính. Nó cho phép bạn giám sát các khía cạnh khác nhau của hệ thống, chẳng hạn như nhiệt độ, mức sử dụng CPU và mức sử dụng RAM, cùng nhiều khía cạnh khác. HWiNFO là một giải pháp thay thế nâng cao hơn cho Task Manager cũng như cung cấp cái nhìn tổng quan toàn diện hơn về hiệu suất hệ thống của bạn và nó cũng nhẹ hơn. Mức độ tùy chỉnh cao của nó có nghĩa là bạn có thể điều chỉnh nó theo nhu cầu cụ thể của mình, khiến nó trở thành một công cụ linh hoạt có thể được sử dụng theo nhiều cách khác nhau. + +`winget install -e --id REALiX.HWiNFO` + +[Tải xuống HWiNFO](https://www.hwinfo.com/). + +## CPU-Z + +Nếu bạn muốn biết thêm về CPU của mình, CPU-Z sinh ra để dành cho bạn. Công cụ này hữu ích để kiểm tra các khía cạnh khác nhau của CPU, chẳng hạn như cảm biến, cách sử dụng và các chi tiết khác. Ngoài ra, nó có thể được sử dụng cho mục đích sửa lỗi nhằm giúp bạn xác định mọi vấn đề với CPU của mình. + +`winget install -e --id CPUID.CPU-Z` + +[Tải xuống CPU-Z](https://www.cpuid.com/softwares/cpu-z.html). + +## GPU-Z + +Về cơ bản thì nó là CPU-Z nhưng mà dành cho GPU của bạn. Công cụ này hữu ích để kiểm tra các khía cạnh khác nhau của GPU, chẳng hạn như cảm biến, VRAM, nhiệt độ và các chi tiết khác. Ngoài ra, nó có thể được sử dụng cho mục đích sửa lỗi nhằm giúp bạn xác định mọi sự cố với GPU của mình. + +`winget install -e --id TechPowerUp.GPU-Z` + +[Tải xuống GPU-Z](https://www.techpowerup.com/gpuz/). + +## MSI Afterburner + +MSI Afterburner là phần mềm cho phép bạn sửa đổi hệ thống của mình và lấy thông tin về nó. Tuy nhiên, nó được thiết kế chủ yếu để ép xung hơn là cung cấp thông tin. Nếu bạn đang tìm kiếm một phần mềm chỉ cung cấp thông tin, MSI Afterburner có thể không phải là lựa chọn tốt nhất cho bạn. Tuy nhiên, MSI Afterburner cho phép bạn xem số liệu thống kê hệ thống khi chơi game, chẳng hạn như FPS chi tiết, % CPU, % GPU, mức sử dụng RAM, v.v. + +`winget install -e --id Guru3D.Afterburner` + +[MSI Afterburner](https://www.msi.com/Landing/afterburner). diff --git a/docs/vi/getting-started/post-installation/software/text-editors.md b/docs/vi/getting-started/post-installation/software/text-editors.md new file mode 100644 index 00000000..55074070 --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/text-editors.md @@ -0,0 +1,35 @@ +--- +title: Trình soạn thảo văn bản và IDE +description: Recommended text editors and IDE software for AtlasOS +icon: material/text +--- + +# Trình soạn thảo văn bản và IDE + +Trình soạn thảo văn bản và Integrated Development Environments (IDEs) là những công cụ mạnh mẽ để lập trình và viết code. Tuy nhiên, chúng tôi khuyên bạn nên sử dụng trình xử lý văn bản để viết tài liệu. Có rất nhiều tùy chọn cho trình soạn thảo văn bản và IDE và chúng tôi đã làm danh sách một số tùy chọn trong tập lệnh cài đặt phần mềm của mình. + +Theo mặc định bạn sẽ có Notepad được cài đặt sẵn. Nếu bạn muốn nó đa-zi-năng hơn, bạn có thể tham khảo một số lựa chọn bên dưới. + +## Notepad++ + +Notepad++ là trình soạn thảo văn bản tiên tiến hơn Notepad. Nó cho phép bạn dễ dàng viết code hoặc tài liệu. Notepad++ có khả năng tùy biến cao, khiến nó trở thành một công cụ linh hoạt dành cho người dùng thành thạo. + +`winget install -e --id Notepad++.Notepad++` + +[Tải xuống Notepad++](https://notepad-plus-plus.org/) + +## Visual Studio Code + +Visual Studio Code, hay còn được biết đến với tên gọi VSCode, là một trình soạn thảo văn bản phong phú và là IDE. Mặc dù nó có thể hữu ích cho việc viết cả code và văn bản, nhưng bạn có thể muốn sử dụng Notepad++ để chỉnh sửa văn bản. + +`winget install -e --id Microsoft.VisualStudioCode` + +[Tải xuống Visual Studio Code](ms-windows-store://pdp/?ProductId=XP9KHM4BK9FZ7Q) + +## VSCodium + +VSCodium là phiên bản mã nguồn mở của Visual Studio Code mà không có nhãn hiệu của Microsoft và các thành phần theo dõi (telemetry). + +`winget install -e --id VSCodium.VSCodium` + +[Tải xuống VSCodium](ms-windows-store://pdp/?ProductId=XP9KHM4BK9FZ7Q) diff --git a/docs/vi/getting-started/post-installation/software/web-browsers.md b/docs/vi/getting-started/post-installation/software/web-browsers.md new file mode 100644 index 00000000..af4d311e --- /dev/null +++ b/docs/vi/getting-started/post-installation/software/web-browsers.md @@ -0,0 +1,21 @@ +--- +description: The Atlas recommended web browsers +icon: material/web +--- +# Trình duyệt Web + +Trong Atlas, bạn có thể chọn trong số 4 trình duyệt mà chúng tôi đã chọn để thuận tiện cho việc cài đặt. Chúng tôi đã làm một bảng bên dưới để bạn có thể quyết định nên chọn trình duyệt nào. + +Khi chọn một trình duyệt, chúng tôi khuyên bạn nên ưu tiên xem xét mức độ tôn trọng quyền riêng tư của người dùng. Tuy nhiên, cũng nên xem xét các yếu tố khác, như tốc độ, tính dễ sử dụng và hơn thế nữa. + +| Tính năng | :simple-brave: Brave | :custom-waterfox: Waterfox | :material-google-chrome: Chrome | :material-microsoft-edge: Edge | +| ----------------------------------------------- | :------------------: | :---------------------------------: | :-----------------------------: | :----------------------------: | +| Tôn trọng quyền riêng tư của người dùng | :material-check-all: | :material-check-all: | :material-close:[^1] | :material-close:[^1] | +| Mã nguồn mở | :material-check-all: | :material-check-all: | :material-close: | :material-close: | +| Dễ sử dụng | :material-check-all: | :material-check-all: | :material-check-all: | :material-check-all: | +| Mặc định chống theo dõi trên các trang web [^2] | :material-check: | :material-close: | :material-close: | :material-close: | +| Mặc định có chặn quảng cáo | :material-check-all: | :material-check-all: | :material-close: | :material-close: | +| Tốc độ | :material-check-all: | :material-check-all: | :material-check-all: | :material-check-all: | + +[^1]: [Chrome](https://tosdr.org/en/service/217) và [Edge](https://tosdr.org/en/service/244) thu thập và sử dụng rất nhiều thông tin từ bạn. +[^2]: Hãy xem [privacytests.org](https://privacytests.org/) về khả năng chống theo dõi của các trình duyệt. diff --git a/docs/vi/index.md b/docs/vi/index.md new file mode 100644 index 00000000..a4b16192 --- /dev/null +++ b/docs/vi/index.md @@ -0,0 +1,51 @@ +--- +description: Tài liệu chính thức của AtlasOS +icon: material/home +--- + +# Chào mừng đến với tài liệu về AtlasOS + +
+ +- :material-power:{ .lg .middle } __Cài đặt AtlasOS__ + + --- + + Bắt đầu với việc cài đặt AtlasOS lên máy tính của bạn + + [:octicons-arrow-right-24: Cài đặt AtlasOS](getting-started/installation.md) + +- :material-wrench:{ .lg .middle } __Sau khi cài đặt__ + + --- + + Khắc phục một số vấn đề thường gặp với AtlasOS. + + [:octicons-arrow-right-24: Xử lí sự cố](getting-started/post-installation/atlas-folder/configuration.md) + +- :material-chat-question:{ .lg .middle } __Những câu hỏi thường gặp và xử lí sự cố__ + + --- + + Những câu hỏi thường gặp về AtlasOS. + + [:octicons-arrow-right-24: Đến trang Câu hỏi thường gặp](faq-and-troubleshooting/removed-features.md) + +- :material-git:{ .lg .middle } __Nguyên tắc đóng góp__ + + --- + + Tìm hiểu cách để đóng góp cho AtlasOS. + + [:octicons-arrow-right-24: Nguyên tắc đóng góp](contributions.md) + +
+ +## :material-head-question-outline: Atlas là gì? + +Atlas là một dự án mã nguồn mở để tối ưu Windows nhằm loại bỏ những nhược điểm của Windows mà gây ảnh hưởng đến hiệu năng khi chơi game. + +Atlas là sự lựa chọn tối ưu để giảm độ trễ của hệ thống, mạng, và độ lag đầu vào, trong khi vẫn giữ được sự ổn định và bảo mật của hệ thống. + +!!! info "" + Nếu bạn muốn tìm hiểu sâu hơn về Atlas và cách nó hoạt động, hãy xem [website](https://atlasos.net/), hoặc khám phá [GitHub repository](https://github.com/Atlas-OS/Atlas), hoặc tham gia vào [server Discord](https://discord.atlasos.net/) để trò chuyện với các thành viên trong cộng đồng và nhận được sự giúp đỡ. diff --git a/docs/vi/localization.md b/docs/vi/localization.md new file mode 100644 index 00000000..b308dd10 --- /dev/null +++ b/docs/vi/localization.md @@ -0,0 +1,108 @@ +--- +description: The official guide to translating the AtlasOS documentation +icon: material/earth +--- + +!!! example "Localization (i18n) is in BETA" + + Any size project is difficult to localize. Community-made translations can add technical and maintenance debt, so we're debating whether to do this for the AtlasOS documentation. + + Please report any issues, suggestions, or comments. Please use our [Discord server](https://discord.atlasos.net) or [GitHub documentation repository](https://github.com/Atlas-OS/docs) to report issues. + +!!! question "Where do I push my changes during beta?" + + When you're ready to share your translations with the world, please submit a pull request in [:simple-github: Atlas-OS/Docs](https://github.com/Atlas-OS/docs/pulls) to the existing `i18n` branch, which will then be merged to the domain you're currently on. + +!!! tip "Are you stuck?" + + If you ever get stuck translating a specific section of the documentation. Don't be afraid to ask for assistance in our [Discord server](https://discord.atlasos.net) if you're trying to figure out the meaning of a specific section or word in our documentation. + +AtlasOS strives to make itself as user-friendly and accessible as possible. This is something we try to reinforce through our playbook, forums, Discord server, and documentation. That is why we want to make it even easier for our community to interact with and contribute to Atlas by supporting community-driven localizations and translations of our official documentation. + +This page will walk you through everything you need to know about translating our documentation, as well as how to properly localize our documentation. + +However, the translation guide will assume that you already have a basic understanding of [:simple-git: Git](https://git-scm.com/) and [:simple-github: GitHub](https://github.com/Atlas-OS), as this is required to get the documentation up and running locally on your machine. + +## Setting up the documentation locally + +As MkDocs uses Python, you will need to have Python and pip installed, we recommend using [Scoop](https://scoop.sh) or [Chocolatey](https://chocolatey.org) to install these but you can also install via [Python's website](https://www.python.org). + +Material for MkDocs has already made a page, which you can use for [Installation of Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started). Depending if you installed it locally or via a virtual envioronment, there is already a [guide on previewing](https://squidfunk.github.io/mkdocs-material/creating-your-site/#previewing-as-you-write) + +## Adding a new language + +You'll need to make some changes to the existing configuration files if you're translating for a language that hasn't yet been added to our documentation. + +To create your language, go into the `mkdocs.yml` file and find the `i18n` section under "Plugins". Once you're there, go ahead and create your language following the format of the already exisiting locales there. However, make sure you've done the following things when setting the langauge up: + +To create your language, navigate to the `i18n` section under "Plugins" in the `mkdocs.yml` file. Once there, proceed to create your language by following the format of the already existing locales. However, when configuring the language, make sure you've done the following: + +* Make sure the `default` property is set to `false` — the default language should always be English. +* When adding the `locale` code, use either the [2-letter code](https://en.wikipedia.org/wiki/ISO_639-1) (e.g. en) or the 5-character code (e.g. en_US, eg_GB) that includes the country/region/territory. +* The `name` should always be the name of the language in which it is spoken. Don't call the language after its English equivalent. +* Always include the `site_name` property and localize "Atlas Documentation" into your language. + +Once you've created your language, copy it to the same section but also inside `mkdocs.insiders.yml`, as this is the configuration used during website build in our production environment. + +To ensure that you have correctly configured your language within the `i18n` "Plugin" section, your language configuration should look like this: + +``` yaml + - i18n: + languages: + - locale: sv # (1)! + name: Svenska # (2)! + build: true # (3)! + site_name: Atlas Documentation # (4)! +``` + +1. Check that this value is set correctly for your language. Set the code accordingly if your language varies by country/region/territory. +

+ **Source**: [https://ultrabug.github.io/mkdocs-static-i18n/setup/setting-up-languages/](https://ultrabug.github.io/mkdocs-static-i18n/setup/setting-up-languages/) +2. The `name` should always be the name of the language in which it is spoken. +

+ **Source**: [https://ultrabug.github.io/mkdocs-static-i18n/setup/setting-up-languages/](https://ultrabug.github.io/mkdocs-static-i18n/setup/setting-up-languages/) +3. Make sure this is always set to `true`. +4. Always include the `site_name` property and localize "Atlas Documentation" into your language. + +## Translating titles & descriptions + +It is extremely simple to translate page titles and descriptions. To begin with descriptions, simply update the `description` property in the documentation piece you're translating and you're done! + +When it comes to translating the title, however, things get a little more complicated. Find the `i18n` section under "Plugins" in the `mkdocs.yml` file to update titles to your local language. Once there, replicate the existing `nav_translations` examples in other languages but apply them to your language instead. + +All of the original (english) titles that can be translated can be found in the "nav" section of the `mkdocs.yml` file. + +If you're not sure how to do your nav_translations to properly translate your page titles, check out the example below: + +```yaml + - i18n: + languages: + - locale: sv + name: Svenska + build: true + nav_translations: # (1)! + Home: Hem # (2)! +``` + +1. All of the original (english) titles that can be translated can be found in the "nav" section of the `mkdocs.yml` file. +2. In the original language (English), "Home" is the navigation name, while "Hem" is the translated name. +

+ **Source:** [https://ultrabug.github.io/mkdocs-static-i18n/setup/localizing-navigation/](https://ultrabug.github.io/mkdocs-static-i18n/setup/localizing-navigation/) + +!!! warning "Don't change the original name" + + You do not want to change the part of the property that is already in English; that part indicates what the originally written page is called in the documentation. Changing the English name in the `nav_translations` property will prevent your localized title from appearing. + +## Translating documentation + +You can begin translating our documentation right away by creating a subfolder in the `docs` folder with your language's `locale` code. You can find the locale code in the `mkdocs.yml` file. + +Copy the original files from the `en` folder into your own languages folder for the documentation you want to translate. After that, you're ready to start translating. + +!!! warning "Don't modify the file name or structure" + + Always use the same folder structure with the same file names as in the `en` folder as in your language. If you do not use the same folder structure and file names, your translated documentation will fail to load and build. + +## Authoring your changes + +When you're ready to show off your translations to the world, submit a pull request to our [:simple-github: Atlas-OS/Docs](https://github.com/Atlas-OS/docs/pulls) repository with your files. In our [:material-handshake: Contribution Guidelines](./contributions.md), you can learn more about contributing and, in particular, contributing to our documentation. diff --git a/mkdocs.insiders.yml b/mkdocs.insiders.yml index d7578e7f..b0b5cfad 100644 --- a/mkdocs.insiders.yml +++ b/mkdocs.insiders.yml @@ -15,7 +15,6 @@ plugins: docs_structure: folder reconfigure_material: true reconfigure_search: true - fallback_to_default: true languages: - locale: en default: true @@ -30,9 +29,15 @@ plugins: Contribution Guidelines: Riktlinjer för medverkan Branding Kit: Varumärkeskit Translation Guide: Översättningsguide - Getting Started: Kom igång - Post Installation: Efter installationen - Atlas folder: Atlas-mappen + - locale: vi + name: Tiếng Việt + build: true + site_name: Atlas - Hướng dẫn + nav_translations: + Home: Trang chủ + Contribution Guidelines: Hướng dẫn đóng góp + Branding Kit: Bộ nhận diện thương hiệu + Translation Guide: Hướng dẫn dịch thuật # https://squidfunk.github.io/mkdocs-material/setup/ensuring-data-privacy/#built-in-privacy-plugin (Insiders) - privacy: diff --git a/mkdocs.yml b/mkdocs.yml index bab91045..d9f597ec 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -9,8 +9,8 @@ edit_uri: edit/master/docs/ # https://squidfunk.github.io/mkdocs-material/setup/ensuring-data-privacy/#change-cookie-settings copyright: > - Copyright © 2023 AtlasOS -
AtlasOS is not affiliated with Microsoft. + Bản quyền thuộc về © 2023 AtlasOS +
AtlasOS không có bất cứ mối liên kết nào với Microsoft. # Change cookie settings @@ -56,14 +56,14 @@ theme: accent: light blue toggle: icon: material/weather-night - name: Switch to dark mode + name: Chuyển sang chế độ tối - media: "(prefers-color-scheme: dark)" scheme: slate primary: blue accent: light blue toggle: icon: material/weather-sunny - name: Switch to light mode + name: Chuyển sang chế độ sáng # https://squidfunk.github.io/mkdocs-material/setup/changing-the-fonts font: @@ -122,19 +122,19 @@ extra: social: - icon: material/earth link: https://atlasos.net - name: AtlasOS Website + name: Website AtlasOS - icon: material/forum link: https://forum.atlasos.net - name: AtlasOS Forums + name: Diễn đàn AtlasOS - icon: fontawesome/brands/discord link: https://discord.atlasos.net - name: AtlasOS on Discord + name: Máy chủ Discord của AtlasOS - icon: fontawesome/brands/github link: https://github.com/Atlas-OS - name: AtlasOS on GitHub + name: Trang GitHub của AtlasOS - icon: fontawesome/brands/twitter link: https://twitter.com/AtlasOS - name: AtlasOS on Twitter + name: Trang Twitter của AtlasOS # @@ -216,10 +216,54 @@ plugins: Home: Hem Contribution Guidelines: Riktlinjer för medverkan Branding Kit: Varumärkeskit - Translation Guide: Översättningsguide - Getting Started: Kom igång - Post Installation: Efter installationen - Atlas folder: Atlas-mappen + - locale: vi + name: Tiếng Việt + build: true + site_name: Tài liệu về AtlasOS + nav_translations: + Home: Trang chủ + Contribution Guidelines: Hướng dẫn đóng góp + Branding Kit: Bộ nhận diện thương hiệu + Getting Started: Bắt đầu + FAQ & Troubleshooting: Những câu hỏi thường gặp và xử lí sự cố + What's removed?: Những thứ gì đã được lược bỏ? + Who is Atlas for?: Atlas dành cho ai? + Atlas folder scripts: Thư mục Atlas + Atlas & Security: Atlas và bảo mật + Updating Atlas: Cập nhật Atlas + Testing nightly builds: Thử nghiệm các bản dựng Atlas + Common Questions: Những câu hỏi thường gặp + Atlas folder missing: Thiếu thư mục Atlas + Adobe Acrobat compatibility: Tính tương thích với Adobe Acrobat + iTunes compatibility: Tính tương thích với iTunes + Atlas ISO files: File ISO Atlas + Reverting Atlas: Gỡ bỏ Atlas + Decrypting using BitLocker: Mở khóa BitLocker + Bluetooth compatibility: Tính tương thích với Bluetooth + Microsoft Store compatibility: Tính tương thích với Microsoft Store + AME Wizard virus detection: Phát hiện virus trong AME Wizard + Windows build not supported: Phiên bản Windows không được hỗ trợ + + Installation: Cài đặt AtlasOS + Post Installation: Sau khi cài đặt + Atlas folder: Thư mục Atlas + Drivers: Driver + Software: Phần mềm + + Web Browsers: Trình duyệt Web + Media: Đa phương tiện + Screenshotting: Chụp màn hình + System Info: Thông tin hệ thống + Text Editors & IDEs: Trình soạn thảo văn bản và IDE + + Graphics: Card đồ họa + Others: Những driver khác + + Configuration: Cấu hình + Advanced Configuration: Cấu hình nâng cao + Optional Tweaks: Những tinh chỉnh tùy ý + Windows Settings: Cấu hình Windows + Security: Bảo mật #