Added README, changed build options to suite LibreItalia Drone instance.
continuous-integration/drone Build is passing
Details
continuous-integration/drone Build is passing
Details
This commit is contained in:
parent
b087e85ec5
commit
47b8e0cf2a
|
@ -15,8 +15,8 @@ steps:
|
||||||
image: plugins/gitea-release
|
image: plugins/gitea-release
|
||||||
settings:
|
settings:
|
||||||
api_key:
|
api_key:
|
||||||
from_secret: gitea-deploy
|
from_secret: loaih-deploy
|
||||||
base_url: https://git.sys42.eu/
|
base_url: https://git.libreitalia.org
|
||||||
files: dist/*.whl
|
files: dist/*.whl
|
||||||
checksum: md5
|
checksum: md5
|
||||||
draft: true
|
draft: true
|
||||||
|
|
|
@ -0,0 +1,71 @@
|
||||||
|
# LibreOffice AppImage Helper - `loaih` #
|
||||||
|
|
||||||
|
LibreOffice AppImage Helper is an enhanced Python porting from [previous work
|
||||||
|
from Antonio
|
||||||
|
Faccioli](https://github.com/antoniofaccioli/libreoffice-appimage). It helps
|
||||||
|
building a LibreOffice AppImage from officially released .deb files with some
|
||||||
|
options.
|
||||||
|
|
||||||
|
## Installing the package ##
|
||||||
|
|
||||||
|
[![Build Status](https://drone.libreitalia.org/api/badges/libreitalia/loaih/status.svg)](https://drone.libreitalia.org/libreitalia/loaih)
|
||||||
|
|
||||||
|
You can much more easily install the package via the produced wheel in the
|
||||||
|
[Releases](/libreitalia/loaih/releases/) page. Once downloaded, you can
|
||||||
|
install the utility with `pip`
|
||||||
|
|
||||||
|
$ pip install ./loaih-*.whl
|
||||||
|
|
||||||
|
You can also clone the repository and build the app yourself, which is as easy
|
||||||
|
as:
|
||||||
|
|
||||||
|
$ pip install wheel
|
||||||
|
$ git clone https://git.libreitalia.org/libreitalia/loaih.git
|
||||||
|
$ cd loaih
|
||||||
|
$ python setup.py bdist_wheel
|
||||||
|
$ pip install dist/loaih*.whl
|
||||||
|
|
||||||
|
## Using the package ##
|
||||||
|
|
||||||
|
The package will install a single command, `loaih`, which should help you
|
||||||
|
build your own version of the AppImage. Here's some usage scenarios.
|
||||||
|
|
||||||
|
## Getting options and help ##
|
||||||
|
|
||||||
|
You can ask the app some information on how you can use it:
|
||||||
|
|
||||||
|
$ loaih --help
|
||||||
|
$ loaih getversion --help
|
||||||
|
$ loaih build --help
|
||||||
|
|
||||||
|
### Finding metadata on a specific version ###
|
||||||
|
|
||||||
|
You can use the command `getversion` and a specific query:
|
||||||
|
|
||||||
|
$ loaih getversion fresh
|
||||||
|
$ loaih getversion still
|
||||||
|
|
||||||
|
### Building a one-time AppImage ###
|
||||||
|
|
||||||
|
You can build yourself an AppImage with specific options:
|
||||||
|
|
||||||
|
$ loaih build -C -a x86_64 -l it -r . -o fresh
|
||||||
|
|
||||||
|
This will build an AppImage for the latest "Fresh" version, built for 64-bit
|
||||||
|
operating systems, with Italian as the only language, with Offline Help,
|
||||||
|
signed and updatable in the current folder.
|
||||||
|
|
||||||
|
For other build options, please see `loaih build --help` which should be
|
||||||
|
pretty complete.
|
||||||
|
|
||||||
|
### Batch building of a set of AppImages ###
|
||||||
|
|
||||||
|
This is less documented, but if the *query* parameter to the `build` command
|
||||||
|
is a YAML file (see references of it in the repository), this will loop
|
||||||
|
through the various options and create a complete set of builds based on some
|
||||||
|
characteristics.
|
||||||
|
|
||||||
|
$ loaih build fresh.yml
|
||||||
|
|
||||||
|
This is the main way the community builds found at the [LibreOffice AppImage
|
||||||
|
Repository](https://appimages.libreitalia.org) are produced.
|
Loading…
Reference in New Issue