65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# 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.
|
|
|
|
The project's structure isn't the best (I'll improve sooner or later). 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.
|