OSDN Git Service

2020.05.14 update
[rebornos/cnchi-gnome-osdn.git] / README.md
1 # RebornOS installer cnchi Gnome OSDN
2
3 ![License](https://img.shields.io/github/license/antergos/cnchi.svg)
4
5 The latest stable version is: RebornOS-2020.05.14-x86_64.iso
6
7 <p align="center">
8 <img src="https://repo.rebornos.org/RebornOS/sources/cnchi/cnchi-screenshot-0004.png">
9 </p>
10
11 <!-- ![Deepin_Image](/images/deepin.png) -->
12
13 ## Download Locations ##
14
15 From the web page of <a href="https://rebornos.org/" class="button">RebornOS</a>
16
17 From our download page on <a href="https://osdn.net/projects/rebornos/releases" class="button">OSDN</a>
18
19 From our download page on <a href="https://sourceforge.net/projects/rebornos/files/" class="button">Sourceforge</a>
20
21 From our <a href="https://repo.rebornos.org/RebornOS/iso/" class="button">Server</a>
22
23 <br>
24
25 # To Manually Build Yourself
26
27 ### Dependencies
28 - isolinux/syslinux
29 - arch-install-scripts
30 - cpio
31 - dosfstools
32 - git 
33 - libisoburn
34 - mkinitcpio-nfs-utils
35 - make
36 - opendesktop-fonts
37 - patch
38 - squashfs-tools
39 - archiso
40 - lynx
41 - wget
42 - yad
43
44 <br>
45
46 ### Free space
47
48 Please check that you have 5GB (or more) of free harddisk space in your root partition:
49 `df -h /`
50
51 <br>
52
53 ### Instructions
54
55 1. Install dependencies:
56 ```
57 sudo pacman -S arch-install-scripts cpio dosfstools git libisoburn mkinitcpio-nfs-utils make patch squashfs-tools wget lynx archiso yad --noconfirm --needed
58 ```
59 2. Clone the repository recursively and `cd` into it (a folder named `cnchi-gnome-osdn` will be created):
60 ```
61 git clone https://scm.osdn.net/gitroot/rebornos/cnchi-gnome-osdn.git --recursive && cd cnchi-gnome-osdn
62 ```
63 3. Create an `out` folder by running:
64 ```
65 sudo mkdir out
66 ```
67 4. Begin building it:
68 ```
69 sudo ./build.sh -v
70 ```
71
72 <br>
73
74 ### That's it!
75
76 To rebuild the ISO, simply remove the `build` folder in addition to emptying the `out` folder. Next, re-enter the command from step 4.
77
78 <br>
79
80 ### General Notes and Information
81
82 - `build.sh`: script used to build the ISO. 
83 - **`HELP_ME.sh`: script to easily build and update an ISO easily. No advance knowledge needed!**
84 - `packages.both`: simply a list of all packages to be installed in an ISO during the build process. To change the DE, login manager, or any other grouping of packages, simply edit this file.
85 - `pacman.conf`: the pacman.conf file used by build.sh to build the ISO. With this, it can ignore whatever personal configs you have on your own system in `/etc/pacman.conf` and instead focus solely on this one.
86 - `run.sh`: um... useless file. Going to get rid of it soon.
87 - `TEST_FILE.sh`: guess what? Another outdated, useless file waiting to be gotten rid of.
88 - `translations.sh`: translation magic!
89 - `pacman-init.service`: adds a pacman module to systemd. I think it works in our ISO, but honestly its something snagged from the Antergos ISO - and I don't entirely know if it does anything in ours. However, it sure does sound like a useful file, right?
90 - `clean.sh`: easy file to use to remove your `build` and `out` folder, in general just an easy method of getting everything all sparkly clean and ready to build another ISO.
91 - `config`: configurations for what version of Cnchi to use in our ISO, as well as where to fetch it from.
92 - `gitv2.sh`: a secial file made by Palanthis so as to automate pushing dev changes up to Gitlab here.
93
94 <br>
95
96 ### How Delete Directory
97
98 Once the installation ISO is generated, and copied elsewhere, the directory used for its creation can be deleted by:
99
100 ```
101 sudo rm -r cnchi-gnome-osdn
102 ```
103
104 You can access the RebornOS page by <a href="https://rebornos.org/" class="button">clicking here</a>.
105
106 <br>
107 <br>
108 <br>
109 <br>
110
111 # Cómo construir la ISO del instalador de RebornOS
112
113 La última versión estable es: RebornOS-2020.05.14-x86_64.iso
114
115 ## Sitios desde donde descargar el instalador: ##
116
117 Desde la página web de <a href="https://rebornos.org/" class="button">RebornOS</a>
118
119 Desde nuestra página de descargas en <a href="https://osdn.net/projects/rebornos/releases" class="button">OSDN</a>
120
121 Desde nuestra página de descargas en <a href="https://sourceforge.net/projects/rebornos/files/" class="button">Sourceforge</a>
122
123 Desde nuestro <a href="https://repo.rebornos.org/RebornOS/iso/" class="button">Servidor</a>
124
125 <br>
126
127 ### Dependencias
128 - isolinux/syslinux
129 - arch-install-scripts
130 - cpio
131 - dosfstools
132 - git 
133 - libisoburn
134 - mkinitcpio-nfs-utils
135 - make
136 - opendesktop-fonts
137 - patch
138 - squashfs-tools
139 - archiso
140 - lynx
141 - wget
142 - yad
143
144 <br>
145
146 ### Pasos a llevar a cabo para crear el instalador
147
148 1. Primero, deberemos de instalar las dependencias:
149
150 ```
151 sudo pacman -S arch-install-scripts cpio dosfstools git libisoburn mkinitcpio-nfs-utils make patch squashfs-tools wget lynx archiso yad --noconfirm --needed
152 ```
153 Una vez instaladas, reiniciamos el sistema.
154
155 2. Luego, clonamos el repositorio localmente, y entramos a él (se creará una carpeta de nombre `cnchi-gnome-osdn`). Esto se hace con:
156
157 ```
158 git clone https://scm.osdn.net/gitroot/rebornos/cnchi-gnome-osdn.git --recursive && cd cnchi-gnome-osdn
159 ```
160
161 3. Creamos una carpeta `out`:
162
163 ```
164 sudo mkdir out
165 ```
166
167 4. Y ahora, comenzamos la construcción de la ISO con:
168
169 ```
170 sudo ./build.sh -v
171 ```
172
173 Una vez finalizado sin errores, la ISO generada estará dentro de la carpeta `out`.
174
175 Si quisiéramos regenerar la ISO, al volver a ejecutar el paso `4`, automáticamente se eliminarán los contenidos de las carpetas de trabajo, y de generación del instalador.
176
177 En el caso de que hayamos copiado la ISO a alguna otra parte de nuestro computador, podremos eliminar esta carpeta:
178
179 ```
180 sudo rm -r cnchi-gnome-osdn
181 ```
182
183 <br>
184
185 ### Un poco de información
186
187 - `build.sh`: es el script utilizado para construir la ISO del instalador. 
188 - **`HELP_ME.sh`: script para construir y actualizar la ISO fácilmente. ¡No se necesitan conocimientos avanzados!**
189 - `packages.both`: contiene un listado de paquetes a ser instalados en la ISO durante su generación. Para cambiar el escritorio, el login manager, o cualquier otro paquete, simplemente edite este archivo.
190 - `pacman.conf`: es el archivo pacman.conf utilizado por build.sh para generar la ISO. Al utilizar éste, se ignorará cualquier configuración personal existente en su sistema (en `/etc/pacman.conf`).
191 - `run.sh`: Archivo inútil Voy a deshacerme de él pronto.
192 - `TEST_FILE.sh`: ¿Adivina qué? Otro archivo obsoleto e inútil a la espera de ser eliminado.
193 - `translations.sh`: ¡Traducción mágica!
194 - `pacman-init.service`: Agrega un módulo pacman a systemd. Creo que funciona en nuestro ISO, pero honestamente es algo enganchado con el ISO de Antergos, y no sé del todo si hace algo en el nuestro. Sin embargo, seguro que suena como un archivo útil, ¿verdad?
195 - `clean.sh`: Archivo fácil de usar para eliminar su carpeta `build` y` out`, en general solo un método fácil para tener todo limpio y listo para construir otro ISO.
196 - `config`: Configuraciones para qué versión de Cnchi usar en nuestro ISO, así como de dónde obtenerla.
197 - `gitv2.sh`: Un archivo especial hecho por Palanthis para automatizar los cambios de desarrollo de empuje hasta Gitlab aquí.
198
199 <br>
200
201 Pueden acceder a la página de RebornOS <a href="https://rebornos.org/" class="button">haciendo clic aquí</a>.
202
203 <br>
204 <br>
205 <br>
206 <br>
207
208
209 # Comment construire l'installateur ISO de RebornOS
210
211 La dernière version stable est: RebornOS-2020.05.14-x86_64.iso
212
213 ## Lieux de téléchargement de l'installateur : ##
214
215 Sur le site Web de <a href="https://rebornos.org/" class="button">RebornOS</a>
216
217 Depuis notre page de téléchargement sur <a href="https://osdn.net/projects/rebornos/releases" class="button">OSDN</a>
218
219 Depuis notre page de téléchargement sur <a href="https://sourceforge.net/projects/rebornos/files/" class="button">Sourceforge</a>
220
221 À partir de notre <a href="https://repo.rebornos.org/RebornOS/iso/" class="button">Serveur</a>
222
223 <br>
224
225 ### Dépendances
226
227 - isolinux/syslinux
228 - arch-install-scripts
229 - cpio
230 - dosfstools
231 - git 
232 - libisoburn
233 - mkinitcpio-nfs-utils
234 - make
235 - opendesktop-fonts
236 - patch
237 - squashfs-tools
238 - archiso
239 - lynx
240 - wget
241 - yad
242
243 <br>
244
245 ### Étapes à suivre pour créer le programme d'installation
246
247 1. Nous devrons installer les dépendances:
248
249 ```
250 sudo pacman -S arch-install-scripts cpio dosfstools git libisoburn mkinitcpio-nfs-utils make patch squashfs-tools wget lynx archiso yad --noconfirm --needed
251 ```
252 Une fois installé, nous redémarrons le système.
253
254 2. Ensuite, cloner le référentiel localement, et l'entrer (un dossier nommé `cnchi-gnome-osdn` sera créé). Ceci est fait avec :
255
256 ```
257 git clone https://scm.osdn.net/gitroot/rebornos/cnchi-gnome-osdn.git --recursive && cd cnchi-gnome-osdn
258 ```
259
260 3. Créez un dossier `out`:
261
262 ```
263 sudo mkdir out
264 ```
265
266 Et maintenant, nous commençons la construction de l'ISO avec:
267
268 ```
269 sudo ./build.sh -v
270 ```
271
272 Une fois terminé sans erreur, l'ISO généré sera dans le dossier `out`.
273
274 Si nous voulons régénérer l'ISO, en exécutant à nouveau l'étape `4`, le contenu des dossiers de travail et des dossiers de génération de l'installateur sera automatiquement supprimé.
275
276 Si nous avons copié l'ISO dans une autre partie de notre ordinateur, nous pourrons supprimer ce dossier :
277
278 ```
279 sudo rm -r cnchi-gnome-osdn
280 ```
281
282 ### Un peu d'information:
283
284 - `build.sh`: est le script utilisé pour construire l'ISO de l'installateur. 
285 - **`HELP_ME.sh`: script pour construire et mettre à jour facilement l'ISO. Aucune connaissance avancée n'est nécessaire!**
286 - `packages.both`: contient une liste de paquets à installer dans l'ISO pendant sa génération. Pour changer le bureau, le gestionnaire de connexion ou tout autre paquet, éditez simplement ce fichier.
287 - `pacman.conf`: est le fichier pacman.conf utilisé par build.sh pour générer l'ISO. Lors de son utilisation, toute configuration personnelle existante dans votre système (dans `/etc/pacman.conf`) sera ignorée.
288 - `run.sh`: Je vais bientôt m'en débarrasser.
289 - `TEST_FILE.sh`: Devinez quoi ? Un autre fichier obsolète et inutile qui attend d'être supprimé.
290 - `translations.sh`: Traduction magique!
291 - `pacman-init.service`: Ajouter un module pacman à systemd. Je pense que cela fonctionne sur notre ISO, mais honnêtement, c'est un peu accro à l'Ancien ISO, et je ne sais pas si cela fait quoi que ce soit sur le nôtre. Cependant, cela sonne certainement comme un fichier utile, n'est-ce pas?
292 - `clean.sh`: Fichier facile à utiliser pour supprimer votre dossier `build' et `out', en général une méthode simple pour avoir tout propre et prêt à construire un autre ISO.
293 - `config`: Configurations pour quelle version de Cnchi utiliser dans notre ISO, ainsi que où l'obtenir.
294 - `gitv2.sh`: Un fichier spécial réalisé par Palanthis pour automatiser les changements de développement push jusqu'à Gitlab ici.
295
296 <br>
297
298 Vous pouvez accéder à la page RebornOS <a href="https://rebornos.org/" class="button">en cliquant ici</a>.
299
300