mirror of
https://codeberg.org/alpine/alpine-wiki.git
synced 2023-08-25 13:53:16 +02:00
wiki structure mayor change: reestructuration in two mayor directories
* the documentation will handle the newbies section, simplification * the professional documens will be merged with the new documents directories * rest of informal or fast forward contributions will be in tutorials
This commit is contained in:
parent
eaeed20a2e
commit
e7302a3c10
@ -14,11 +14,11 @@ with option to change that!
|
||||
want an Alpine ready touse in 4 hours, you have two options:
|
||||
|
||||
1. [.. this link...](newbie/alpine-newbie-xfce-desktop.md) a single explanatory article that installs a complete desktop, too much text, then;
|
||||
2. [.. use this link...](tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md) but if you want to avoid the explanations and just go all the way... use this other one that is multilanguage
|
||||
2. [.. use this link...](tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md) but if you want to avoid the explanations and just go all the way... use this other one that is multilanguage
|
||||
|
||||
### Tutorials and Docs
|
||||
|
||||
1. [Newbies](newbie/README.md), not mandatory but recommended you start to read the [Newbies](newbie/README.md).
|
||||
1. [Newbies](documents/README.md), not mandatory but recommended you start to read the [Newbies documentation](documents/README.md).
|
||||
2. [Tutorials](tutorials/README.md), for impatients if you have computer or only a phone, read the [Tutorials](tutorials/README.md)
|
||||
|
||||
### About alpine
|
||||
|
@ -145,13 +145,20 @@ All the Development process are detailed for newbie users in the Alpine newbie d
|
||||
2. [Alpine newbie Desktop](alpine-newbie-desktop.md)
|
||||
3. [Alpine newbie Develop](alpine-newbie-develop.md)
|
||||
4. [Alpine newbie developer: full stack web](alpine-newbie-develop-full-stack-web.md)
|
||||
5. [Alpine newbie developer: gitea](alpine-newbie-develop-gitea.md)
|
||||
5. [Alpine newbie developer: backend devel](alpine-newbie-develop-backend-developer.md)
|
||||
|
||||
##### Servers: deploy in production
|
||||
|
||||
1. [Alpine newbie Console](alpine-newbie-console.md)
|
||||
2. [Alpine production deploy](alpine-production-deploy.md)
|
||||
|
||||
* Special documentation:
|
||||
* How to setup apache professional at [server-alpine-apache2-professional.md](server-alpine-apache2-professional.md)
|
||||
* How to setup gitea professional at [server-alpine-gitea-professional.md](server-alpine-gitea-professional.md)
|
||||
* Implementation of a certificate [guide-only-dehydrated.md](guide-only-dehydrated.md)
|
||||
* Specific doucmentation cases:
|
||||
* ARM tvbox TODO
|
||||
|
||||
## Community
|
||||
|
||||
We know that new users are not so xperts, so then here are the networks you can check for newbies:
|
@ -4,7 +4,8 @@
|
||||
This is a single only full article for first users,
|
||||
targeted for mid-impatient that just want the way to see the desktoip in some hours:
|
||||
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
If you want wayland crap: [.. use this guide named Fast Forward Wayland desktop](../tutorials/alpine-tutorial-desktop-wayland-try.md)
|
||||
|
||||
* [How to use this guide](#how-to-use-this-guide)
|
||||
* [Installation of alpine](#installation-of-alpine)
|
||||
@ -49,7 +50,7 @@ if you paste, the first line will be preceded by garbage, check always the first
|
||||
This guide will assume all the hard disk storage for the installation
|
||||
otherwise check the best option at [alpine-newbie-install.md](alpine-newbie-install.md)
|
||||
|
||||
Ok but if you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
Ok but if you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
|
||||
#### Explanations
|
||||
|
||||
@ -223,7 +224,7 @@ avoid those packages, if Alpine usage will be for GUI only.
|
||||
|
||||
The packages of locales will be need as base for multi-lang enviroment.
|
||||
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
|
||||
#### setup system users
|
||||
|
||||
@ -401,7 +402,7 @@ apk add gvfs udisks2 udisks2-lang udisks2-doc gvfs-fuse gvfs-archive gvfs-dav gv
|
||||
|
||||
```
|
||||
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
If you are impatient: [.. use this guide named Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
|
||||
#### setup software graphical fonts and languajes
|
||||
|
||||
@ -702,4 +703,4 @@ https://codeberg.org/alpine/alpine-wiki/src/branch/main#license
|
||||
|
||||
* [README.md](README.md)
|
||||
* [alpine-newbie-install.md](alpine-newbie-install.md)
|
||||
* [Fast Forward XFCE desktop](../tutorials/community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
* [Fast Forward XFCE desktop](../tutorials/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 22 KiB |
@ -1,7 +1,7 @@
|
||||
# alpine server gitea
|
||||
|
||||
Gitea is a community managed lightweight code hosting solution written in Go.
|
||||
It is a fork of Gogs. For a more simple guide use the [alpine-howto-gitea-package.md](../community-way/alpine-howto-gitea-package.md)
|
||||
It is a fork of Gogs. For a more simple guide use the [alpine-howto-gitea-package.md](../tutorials/alpine-howto-gitea-package.md)
|
||||
|
||||
## Clarifications
|
||||
|
@ -1,12 +1,11 @@
|
||||
Alpine Linux tutorias and howtos
|
||||
=================================
|
||||
|
||||
**Where to start?** Check the next section. Ok but **if you are impatient and
|
||||
want an Alpine ready touse in 1 hour**, use [.. this link...alpine XFCE desktop](../newbie/alpine-newbie-xfce-desktop.md)
|
||||
a single explanatory article that installs a complete desktop
|
||||
or [this minimal version](community-way/alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
**Where to start?** you will need check if you have enought Linux terminology knowledge, but
|
||||
_**if you are impatient and want an Alpine ready touse in 1 hour check **_ [.. this link: alpine XFCE desktop](alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
if you want to avoid the explanations and just go all the way. For the wayland fashioned
|
||||
desktop try the guide [alpine tutorial desktop wayland try](community-way/alpine-tutorial-desktop-wayland-try.md) .
|
||||
desktop try the guide [alpine tutorial desktop wayland](alpine-tutorial-desktop-wayland-try.md)
|
||||
but **Wayland is not recommended due several issues and X11 its more widelly working**.
|
||||
|
||||
## TUTORIALS AND HOWTOS
|
||||
|
||||
@ -20,15 +19,45 @@ with Alpine Linux, that expects a minimal knowledge from reader to perform actio
|
||||
The **Guides are fast documents** with only direct ways to do a particular task
|
||||
with Alpine Linux, that expects a minimal knowledge from reader to perform actions.
|
||||
|
||||
We divided the guides, tutorials and howtos in 3 main sections (directories):
|
||||
## INSTALL
|
||||
|
||||
TODO
|
||||
|
||||
## PHONES
|
||||
|
||||
* Alpine in your phone: [alpine-tutorial-in-phones.md](alpine-tutorial-in-phones.md)
|
||||
* [phones-androit-allow-external-apps-install.md](phones-androit-allow-external-apps-install.md)
|
||||
|
||||
## DESKTOPS
|
||||
|
||||
* Complete desktops, means the programs are integrated and sync using XDG desktop compliant environment:
|
||||
* XFCE4 desktop guide: [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
* WAYLAND desktop guide: [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
|
||||
* Window managers means the desktop its not integrated, each program has their own environment but can tuned:
|
||||
* Openbox desktop guide: [alpine-tutorial-desktops-openbox-fast-forward.md](alpine-tutorial-desktops-openbox-fast-forward.md)
|
||||
* Issues:
|
||||
* At the point of 2022/v3.16 **[all the gvfs handlers are broken in Alpine](https://gitlab.alpinelinux.org/alpine/aports/-/issues/14183)**
|
||||
* Alpine its not stable to use as desktop, developers [only solve issues to current or mayor version upgrades, not LTS due "community" nature of packages](https://gitlab.alpinelinux.org/alpine/aports/-/issues/14182#note_262134)
|
||||
|
||||
## SERVERS
|
||||
|
||||
* [servers-howto-setup-PXE-service-for-others-linuxes-ES.md](servers-howto-setup-PXE-service-for-others-linuxes-ES.md)
|
||||
* [alpine-howto-gitea-package.md](alpine-howto-gitea-package.md)
|
||||
|
||||
## Convention for naming the files:
|
||||
|
||||
1. each one must started with the word "alpine" unless are just a extra document like the androit external apps
|
||||
2. must be followed "tutorial" or "guide" or "howto"
|
||||
3. rest of the name can be whatever and do not have spaces.. each word must be separated with "-"
|
||||
4. the name must not contains any simbol or space, only numbers and letters and "-" are allowed
|
||||
5. the extension of the file must be ".md"
|
||||
6. you can upload extra support files like scripts shell or photos
|
||||
7. the name of each extra files must be same as the document and extra word to idetify
|
||||
|
||||
1. [newbies](../newbies/README.md) (formal ways of doing things but with explanations, mostly for begginers)
|
||||
2. [community-way](community-way/README.md) (quick, fast and forward ways of doing things, mostly for impatients)
|
||||
3. [professional-way](professional-way/README.md) (informal ways but with more explanations and implicit security)
|
||||
|
||||
## Acknowledges
|
||||
|
||||
**CONSIDERATIONS**: Please check the [Feature Differences OF ALPINE LINUX](../newbies/README.md#feature-differences)
|
||||
**CONSIDERATIONS**: Please check the [Feature Differences OF ALPINE LINUX](../documents/README.md#feature-differences)
|
||||
but those are the main ones you should considering before usage of Alpine linux:
|
||||
|
||||
1. Alpine Linux **is designed for power users, with security and simplicity in mind**.
|
||||
@ -36,7 +65,7 @@ but those are the main ones you should considering before usage of Alpine linux:
|
||||
3. It is built around musl libc, not glibc, which means there might be incompatibilites with some packages
|
||||
4. Its main utilities (coreutils) are derived from busybox and suckless, so all commands are pretty simplistic
|
||||
|
||||
**PREREQUISITES**: Please check the [newbie alpine preparation requirements for you](../newbie/alpine-newbie-prepare.md)
|
||||
**PREREQUISITES**: Please check the [alpine preparation requirements for you](alpine-newbie-prepare.md)
|
||||
but you can use linux using [termux](tutorial-alpine-in-phone.md) or [ish](tutorial-alpine-in-phone.md) on your phone.
|
||||
|
||||
* **Manners**, you will must have a vocation for reading and analysis.
|
||||
|
@ -1,7 +1,7 @@
|
||||
# Alpine XFCE4 desktop setup: FF version
|
||||
===========================================================
|
||||
|
||||
Alpine must be previously installed. For a WAYLAND desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md).
|
||||
Alpine must be previously installed. For a WAYLAND crap desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md).
|
||||
For more extended verson of this document check [../../newbie/alpine-newbie-xfce-desktop.md](../../newbie/alpine-newbie-xfce-desktop.md)
|
||||
|
||||
* [How to use this guide](#how-to-use-this-guide)
|
@ -1,7 +1,7 @@
|
||||
# Alpine OPENBOX desktop setup: FF version
|
||||
===========================================================
|
||||
|
||||
Alpine must be previously installed. For a WAYLAND desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md).
|
||||
Alpine must be previously installed. For a WAYLAND crap desktop check [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md).
|
||||
For XFCE4 check [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
|
||||
* [How to use this guide](#how-to-use-this-guide)
|
@ -8,7 +8,7 @@ the operating system and use a parallel operating system
|
||||
**What happened then?** you can boot inside yor phone (whitout remove the phone's OS),
|
||||
the Alpine operating system, just like a kind of virtual machine but its not!
|
||||
|
||||
If you want more help directly [ask for help here](../README.md#help-online-directly).
|
||||
If you want more help directly [ask for help here](README.md#help-online-directly).
|
||||
|
||||
## Introduction
|
||||
|
||||
@ -102,5 +102,5 @@ material under identical terms, includes the following elements:
|
||||
* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
|
||||
* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
|
||||
|
||||
For more information check the [../../alpine/copyright.md](../../alpine/copyright.md)
|
||||
For more information check the [../alpine/copyright.md](../alpine/copyright.md)
|
||||
|
@ -1,71 +0,0 @@
|
||||
Community way of alpine wiki documentation
|
||||
=========================================
|
||||
|
||||
The **tutorials are hands-on docs** expected to try and achieve the goals described
|
||||
in each step, possibly with the help of a good example. The output in one step
|
||||
is the starting point for the following steps.
|
||||
|
||||
The **Howtos are smaller articles** explaining how to perform a particular task
|
||||
with Alpine Linux, that expects a minimal knowledge from reader to perform actions.
|
||||
|
||||
Those documents are community made and may or not may have updated.
|
||||
For more up to date documents check [the main index at tutorials/README.md](../README.md)
|
||||
|
||||
## INSTALL
|
||||
|
||||
TODO
|
||||
|
||||
## PHONES
|
||||
|
||||
* Alpine in your phone: [alpine-tutorial-in-phones.md](alpine-tutorial-in-phones.md)
|
||||
* [phones-androit-allow-external-apps-install.md](phones-androit-allow-external-apps-install.md)
|
||||
|
||||
## DESKTOPS
|
||||
|
||||
* XFCE4 desktop (quick guide): [alpine-tutorial-desktop-xfce4-fast-forward.md](alpine-tutorial-desktop-xfce4-fast-forward.md)
|
||||
* WAYLAND desktop: [alpine-tutorial-desktop-wayland-try.md](alpine-tutorial-desktop-wayland-try.md)
|
||||
* Openbox by compile way: [alpine-tutorial-desktops-openbox-fast-forward.md](alpine-tutorial-desktops-openbox-fast-forward.md)
|
||||
|
||||
## SERVERS
|
||||
|
||||
* [servers-howto-setup-PXE-service-for-others-linuxes-ES.md](servers-howto-setup-PXE-service-for-others-linuxes-ES.md)
|
||||
* [alpine-howto-gitea-package.md](alpine-howto-gitea-package.md)
|
||||
|
||||
## Convention for naming the files:
|
||||
|
||||
1. each one must started with the word "alpine" unless are just a extra document like the androit external apps
|
||||
2. must be followed "tutorial" or "guide" or "howto"
|
||||
3. rest of the name can be whatever and do not have spaces.. each word must be separated with "-"
|
||||
4. the name must not contains any simbol or space, only numbers and letters and "-" are allowed
|
||||
5. the extension of the file must be ".md"
|
||||
6. you can upload extra support files like scripts shell or photos
|
||||
7. the name of each extra files must be same as the document and extra word to idetify
|
||||
|
||||
## Help online directly
|
||||
|
||||
- 🗯 IRC
|
||||
- 💬 `##alpine_telegram_english`
|
||||
- 💬 `#alpine_linux_english`
|
||||
- 📱 Telegram https://t.me/alpine_linux
|
||||
- 🇬🇧 https://t.me/alpine_linux_english
|
||||
- 🇷🇺 https://t.me/alpine_linux_pycckuu (dual english russian, low activity)
|
||||
- 🇨🇴 https://t.me/alpine_linux_espanol
|
||||
- 🇧🇬 https://t.me/alpine_linux_bulgarian (dual english bulgarian, low activity)
|
||||
- 🇨🇳 https://t.me/alpine_linux_chinese (dual english chinese, low activity)
|
||||
- 📡 https://t.me/opentechnologies (open languajes but english as main)
|
||||
- ⛓ Matrix
|
||||
- 👥 https://matrix.to/#/#alpine-linux-english:matrix.org
|
||||
|
||||
# LICENSE
|
||||
|
||||
**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material
|
||||
in any medium or format for noncommercial purposes only, and only so long as attribution is given
|
||||
to the creators involved. If you remix, adapt, or build upon the material, you must license the modified
|
||||
material under identical terms, includes the following elements:
|
||||
|
||||
* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor.
|
||||
* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
|
||||
* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
|
||||
|
||||
For more information check the [../../alpine/copyright.md](../../alpine/copyright.md)
|
||||
|
@ -1 +0,0 @@
|
||||
community-way
|
@ -1 +0,0 @@
|
||||
##Hola
|
@ -1,50 +0,0 @@
|
||||
Alpine wiki in Professional ways
|
||||
================================
|
||||
|
||||
The documentation here requires a minimum medium or advanced level of knowledge in Linux,
|
||||
if you do not have the level it is recommended that you read the [documents in the NEWBIE category](../../newbie/README.md)
|
||||
|
||||
## SERVICES
|
||||
|
||||
* How to setup apache professional at [server-alpine-apache2-professional.md](server-alpine-apache2-professional.md)
|
||||
* How to setup gitea professional at [server-alpine-gitea-professional.md](server-alpine-gitea-professional.md)
|
||||
* Implementation of a certificate [guide-only-dehydrated.md](guide-only-dehydrated.md)
|
||||
|
||||
## Convention for naming the files:
|
||||
|
||||
1. each one must started with the word "alpine" unless are just a extra document like the androit external apps
|
||||
2. must be followed "tutorial" or "guide" or "howto"
|
||||
3. rest of the name can be whatever and do not have spaces.. each word must be separated with "-"
|
||||
4. the name must not contains any simbol or space, only numbers and letters and "-" are allowed
|
||||
5. the extension of the file must be ".md"
|
||||
6. you can upload extra support files like scripts shell or photos
|
||||
7. the name of each extra files must be same as the document and extra word to idetify
|
||||
|
||||
## Help online directly
|
||||
|
||||
- 🗯 IRC
|
||||
- 💬 `##alpine_telegram_english`
|
||||
- 💬 `#alpine_linux_english`
|
||||
- 📱 Telegram https://t.me/alpine_linux
|
||||
- 🇬🇧 https://t.me/alpine_linux_english
|
||||
- 🇷🇺 https://t.me/alpine_linux_pycckuu (dual english russian, low activity)
|
||||
- 🇨🇴 https://t.me/alpine_linux_espanol
|
||||
- 🇧🇬 https://t.me/alpine_linux_bulgarian (dual english bulgarian, low activity)
|
||||
- 🇨🇳 https://t.me/alpine_linux_chinese (dual english chinese, low activity)
|
||||
- 📡 https://t.me/opentechnologies (open languajes but english as main)
|
||||
- ⛓ Matrix
|
||||
- 👥 https://matrix.to/#/#alpine-linux-english:matrix.org
|
||||
|
||||
# LICENSE
|
||||
|
||||
**CC BY-NC-SA**: this project allows reusers to distribute, remix, adapt, and build upon the material
|
||||
in any medium or format for noncommercial purposes only, and only so long as attribution is given
|
||||
to the creators involved. If you remix, adapt, or build upon the material, you must license the modified
|
||||
material under identical terms, includes the following elements:
|
||||
|
||||
* **BY** – Credit must be given to the creator of each content respectivelly, starting at the first contributor.
|
||||
* **NC** – Only noncommercial uses of the work are permitted, with exceptions if you fill an issue here!
|
||||
* **SA** – Adaptations must be shared under the same terms, you must obey this terms and do not change it.
|
||||
|
||||
For more information check the [../../alpine/copyright.md](../../alpine/copyright.md)
|
||||
|
@ -1 +0,0 @@
|
||||
professional-way
|
Loading…
Reference in New Issue
Block a user