# MoveToLinux

Move to Linux is an informational website project which allows its user to interactively
learn more about Linux.

## Dependencies

This project uses Astro, Tailwind CSS, and Breeze icons.

## Images

Images, excluding logos, are mostly captured from VMs in this project. You are
free to contribute better images if they can reflect real hardware better.

Anaconda WebUI compress icon (`./src/assets/icons/fa-compress-arrows-alt.svg`)
sourced from Patternfly Icons.

## Translations

If you wish to help translate the site, you'll need to know how to use Git,
and optionally to preview the site, you'll need a little knowledge about the
command line.

Most content are located within the `./src/data` folder. Located there are 4
content collections including "common" (Common pages which may be shared
between Linux distribution install guides), "distro" (The Linux distribution
install guides), "distroquiz" (The short Linux distribution quiz), and
"strings" (Short strings).

Inside each collection, There will be a folder named after a language code
(following the IETF language tag standard) _or_ there will be a TOML file named
after the language code.

These pages may be of use to you:

-   [List of language codes](https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes)
-   [List of country codes (ISO 3166-1 alpha-2)](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
-   [TOML file introduction](https://toml.io/en/)

> [!NOTE]
> The "en" language code in this project refers to American English.

There are also pages in the `./src/pages` directory which is recommended that
you know at least the basic of HTML to translate. Pages which needs to be
manually translated that way includes the main page, the privacy policy, and
the start quiz page.

## Recommended Extensions

This section applies to both developers and any translators that's willing to
use Visual Studio Code to translate the project

-   Astro ([VS Marketplace](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode), [OpenVSX](https://open-vsx.org/extension/astro-build/astro-vscode))
-   MDX ([VS Marketplace](https://marketplace.visualstudio.com/items?itemName=unifiedjs.vscode-mdx), [OpenVSX](https://open-vsx.org/extension/unifiedjs/vscode-mdx))

The extensions are also listed in the VSCode workspace extensions recommendations.

## License

The source code of this project is licensed under MIT license, however, the text
content itself (MDX/TOML files) within `./src/data` is licensed under CC-BY-SA-4.0

Logos of other projects (such as Linux Distributions, located in `./public/logos`)
belongs to their respective owners.
