libreitalia
/
loaih
7
0
Fork 0
Code Issues 8 Pull Requests Packages Releases 5 Wiki Activity

Fixed pages of the Wiki.

Emiliano Vavassori 2024-01-01 18:50:55 +01:00
parent 95c44dab03
commit d78d30cf2c
4 changed files with 28 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
Build.md

@ -13,7 +13,7 @@ From version 1.3.3, additionally, the default values for the available options
for the single build (`build` verb) for the single build (`build` verb)
have been *differentiated* and *simplified* from the ones available for the set of builds (`batch` verb). have been *differentiated* and *simplified* from the ones available for the set of builds (`batch` verb).
Hopefully, the chosen defaults would require the lowerst number of options to Hopefully, the chosen defaults would require the lowest number of options to
be passed to the `build` command. be passed to the `build` command.
@ -40,27 +40,28 @@ For the full description of all the available options and their relative default
loaih build --help loaih build --help
**PLEASE BE AWARE** that option names and short options have changed since **PLEASE BE AWARE** that option names and short options have changed since
1.3.3, to the point this is indeed a **breaking change**. v1.3.3, to the point this is indeed a **breaking change**.
## Multiple single builds ## ## Multiple single builds ##
Also the `build` verb supports multiple query: Also the `build` verb supports multiple queries:
loaih build still,fresh loaih build still,fresh
There's a little caveat, though: if the AppImage names of the requested There's a little caveat, though: if the AppImage names of the requested
versions will overlap (e.g. `7.5,7.5.9.2`), only the last in the query will versions will overlap (e.g. `7.5,7.5.9.2`, both queries likely resulting in an
survive the building process (all conflicting versions would be built, but the AppImage filename of 'LibreOffice-7.5.9.2.basic-x86_64.AppImage'), only the
last one will likely overwrite the previous ones), unless the `-c`, `--check` result of the last query will survive the building process (all conflicting
option is used - and in this case, just the first one will survive and the versions would be built, but the last one will likely overwrite the previous
rest would be skipped). ones), unless the `-c`, `--check` option is used (and in this case, just the
first one will survive and the rest would be skipped).
## Default working paths ## ## Default working paths ##
If not specified otherwise, a normal run would build the AppImage in the If not specified otherwise, a normal run would build the AppImage in the
directory in which the command has been run and it will download all the directory in which the command has been run and it will download all the
required files in a `downloads` subfolder that will be created if missing and required files in a `downloads` subfolder, that will be created if missing and
removed entirely at the end of the build process (unless `-k` option is used - removed entirely at the end of the build process (unless `-k` option is used -
see below). see below).

9
Install.md

@ -5,7 +5,7 @@ The page describes how to install `loaih` to help build the AppImages.
## From sources ## ## From sources ##
You can build `loaih` from the sources in [this same You can build `loaih` from the sources in [this same
site](/libreitalia/loaih/). site](https://git.libreitalia.org/libreitalia/loaih/).
1. Clone the repository: 1. Clone the repository:
``` ```
@ -31,11 +31,12 @@ sudo python3 setup.py install
## From Releases ## ## From Releases ##
When a new version is released, a binary artifact of the package will be When a new version is released, a binary artifact of the package will be
uploaded to this website in the [Release](https://git.libreitalia.org/libreitalia/loiah/releases) uploaded to this website in the [Release](https://git.libreitalia.org/libreitalia/loaih/releases)
section. section.
1. Find the latest relaease in the [Release](https://git.libreitalia.org/libreitalia/loaih/releases) 1. Find the latest relaease in the
page and download the relative `.whl` file (e.g. `loaih-1.3.3-py3-none-any.whl`); [Release](https://git.libreitalia.org/libreitalia/loaih/releases) page and
download the relative `.whl` file (e.g. `loaih-1.3.3-py3-none-any.whl`);
2. Ensure you have the `wheel` package installed in your system: 2. Ensure you have the `wheel` package installed in your system:
``` ```
pip install wheel pip install wheel

17
Prerequisites.md

@ -1,16 +1,19 @@
## Prerequisites ## # Prerequisites #
To build any LibreOffice AppImage, you need the following software already To build any LibreOffice AppImage, you need the following software already
installed on your machine: installed on your machine:
* `cp`: standard POSIX utility to copy files; * `cp`: standard POSIX utility to copy files;
* `dpkg`: Considering that we build the AppImage from the Debian packages, * `dpkg`: Considering that we build the AppImage from the Debian packages, we
* `find`: it is used mostly to interact with downloaded files; definitely need a way to extract the contents from .deb packages;
* `fuse` and the relative kernel modules loaded; * `find`: it is used mostly to interact with files inside the downloads and
* `rsync`: if the repository is remote, the application can publish directly storage paths;
the contents using rsync; * `fuse` needs to be installed and the relative kernel module needs to be
loaded;
* `rsync`: if the repository is remote, `loaih` can publish directly
the contents using `rsync` and SSH;
* `sed`: used to manipulate some source files; * `sed`: used to manipulate some source files;
* `tar` and `gzip`: used to unpack the general downloads from LibreOffice * `tar` and `gzip`: used to extract the archives from LibreOffice
official websites. official websites.
--- ---

4
Version.md

@ -1,6 +1,6 @@
# Usage - versions # # Usage - versions #
`loaih` can be used to find out information about a specific LibreOffice versions; the script parses the [official LibreOffice download page](https://www.libreoffice.org/download/download-libreoffice/) and, in specific cases like daily builds, infers their availability from other known repositories. `loaih` can be used to find out information about a specific LibreOffice version; the script parses the [official LibreOffice download page](https://www.libreoffice.org/download/download-libreoffice/) and, in specific cases like daily builds, infers their availability from other known repositories.
`loaih getversion` can be used as: `loaih getversion` can be used as:
@ -39,7 +39,7 @@ number); for a working example, 20231231 for the December 31st, 2023.
## Fallback to current for missing daily versions ## ## Fallback to current for missing daily versions ##
If the daily version has not been built today (e.g. likely between If the daily upstream version has not been built today (e.g. likely between
midnight and 03:00 CET), a `daily` query will result in a blank output. midnight and 03:00 CET), a `daily` query will result in a blank output.
To avoid this, the option `-d` will modify the query as "today's build or the To avoid this, the option `-d` will modify the query as "today's build or the