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:
mckayshirou 2022-09-18 10:52:36 -04:00
parent eaeed20a2e
commit e7302a3c10
24 changed files with 61 additions and 148 deletions

View File

@ -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

View File

@ -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:

View File

@ -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)

View File

Before

Width:  |  Height:  |  Size: 3.9 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB

View File

Before

Width:  |  Height:  |  Size: 22 KiB

After

Width:  |  Height:  |  Size: 22 KiB

View File

@ -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

View File

@ -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.

View File

@ -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)

View File

@ -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)

View File

@ -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)

View File

@ -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)

View File

@ -1 +0,0 @@
community-way

View File

@ -1 +0,0 @@
##Hola

View File

@ -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)

View File

@ -1 +0,0 @@
professional-way