Skip to content

Commit

Permalink
Initial Vietnamese translation (WIP)
Browse files Browse the repository at this point in the history
Finished:
- installation.md
- post-installation\software and drivers
- branding.md (needs feedback)

WIP:
- FAQ & troubleshooting: finished except for the common-questions folder
- atlas-folder
  • Loading branch information
ItzDatMC committed Nov 17, 2023
1 parent c90fe2b commit 0b0a69b
Show file tree
Hide file tree
Showing 39 changed files with 2,056 additions and 17 deletions.
426 changes: 426 additions & 0 deletions docs/vi/branding.md

Large diffs are not rendered by default.

93 changes: 93 additions & 0 deletions docs/vi/contributions.md
Original file line number Diff line number Diff line change
@@ -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)
10 changes: 10 additions & 0 deletions docs/vi/faq-and-troubleshooting/atlas-and-security.md
Original file line number Diff line number Diff line change
@@ -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.
55 changes: 55 additions & 0 deletions docs/vi/faq-and-troubleshooting/atlas-folder-scripts.md
Original file line number Diff line number Diff line change
@@ -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.
14 changes: 14 additions & 0 deletions docs/vi/faq-and-troubleshooting/common-questions/adobe-acrobat.md
Original file line number Diff line number Diff line change
@@ -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.

<image src="/assets/images/printer-script-folder.png" style="border-radius:8px" />
Original file line number Diff line number Diff line change
@@ -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).
Original file line number Diff line number Diff line change
@@ -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.

<img src=/assets/images/atlasdesktop-windows-folder.png style="border-radius:8px" />
Original file line number Diff line number Diff line change
@@ -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)
Original file line number Diff line number Diff line change
@@ -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.

<img src="/assets/images/bluetooth-script-folder.png" style="border-radius:8px" />

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.
Original file line number Diff line number Diff line change
@@ -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!
Original file line number Diff line number Diff line change
@@ -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**.
Loading

0 comments on commit 0b0a69b

Please sign in to comment.