Commit b272016f by Lafont François

Update de README file

parent 1bb8a943
# Build the package in Debian Jessie
# Install the environment to build the package
You *must* build the package in Debian Jessie:
**Warning:** you can build the package only on **Debian Jessie**.
These commands should be launched **only once**:
```sh
# Just the first time.
apt-get update
apt-get install -y git ca-certificates openssl make
git clone "https://gitlab.crdp.ac-versailles.fr/francois.lafont/xia-packaging.git"
cd xia-packaging/
./make install_env
# For each build.
./make build
```
And the packages will be in the current directory:
```sh
ls -lh
```
In the following, it is assumed that these commands have
been already launched.
# Build the package with the current version mentioned in the `debian/changelog`
# Install and test the package quickly
You can install and test the package quickly on Debian Wheezy,
Debian Jessie, Ubuntu Precise Pangolin and Ubuntu Trusty Tahr.
You just need to launch these commands as *root*:
* If you just want to install the Xia command line
To build the package with the current version mentioned in
the `debian/changelog` file (ie in the first line), a tag
with the same version must exist in the "watch" page of the
upstream sources. In this case, you can build the package
with :
```sh
wget -q "http://repository.crdp.ac-versailles.fr/crdp.gpg" -O - | apt-key add -
echo "deb http://repository.crdp.ac-versailles.fr/debian xia main" > /etc/apt/sources.list.d/xia.list
apt-get update
apt-get install xia
```
cd xia-packaging/
* If you want to install the Xia command line and the Inkscape plugin
# For each build.
./make build
```
Replace the last `apt-get install xia` command above by:
And the packages (ie the `.deb` file) will be in the current
directory:
```sh
apt-get install --install-suggests xia
ls -lh
```
# Build the package with a version not yet mentioned in the `debian/changelog`
# How to launch a new release of the package
To do that, you must be a maintainer of the package (ie you
must be present in the `Maintainer` field or in the `Uploaders`
field of the `src/debian/control` file).
First, you have to create a new release entry in the
`debian/changelog` file :
```sh
# `devscripts` is a package which contains the `dch` command
# to edit the `debian/changelog` file.
apt-get update
apt-get install -y git ca-certificates openssl devscripts make dput
git clone "https://gitlab.crdp.ac-versailles.fr/francois.lafont/xia-packaging.git"
# You must set several environment variables.
export EDITOR="vim" # take "nano" if you prefer.
export DEBEMAIL="pascal.fautrero@ac-versailles.fr"
export EMAIL="pascal.fautrero@ac-versailles.fr"
export DEBFULLNAME="Pascal Fautrero"
# Go to the `src/` directory.
# Go to the `src/` directory in the git repository.
cd xia-packaging/src/
# Create a new entry in the `debian/changelog` file.
......@@ -79,29 +62,70 @@ cd xia-packaging/src/
dch --newversion '1.0~beta5-3'
```
When your editor is opened, you can notice the `UNRELEASED` string
in the first line of the `debian/changelog` file.
When your editor is opened, you can notice the `UNRELEASED`
string in the first line of the `debian/changelog` file.
After the command above, you can edit the file and append explanations
about this new release. When it's finished, you must save and quit your
editor. Then, run this command :
After the command above, you can edit the file and append
explanations about this new release. When it's finished, you
must save and quit your editor. Then, run this command:
```sh
dch --release
```
Now, you can notice that the `UNRELEASED` string in the first line is
replaced by the `unstable` string. It's OK, save and quit your editor.
Now, the package source is ready for a new release. You can commit
and push.
Now, you can notice that the `UNRELEASED` string in the
first line is replaced by the `unstable` string. It's OK,
save and quit your editor. Now, the package source is ready
for a new release. You can commit and push.
After the commit and push, you can build the package:
```sh
cd ..
./make build
```
# Put the package in the "CRDP" repository
To put the package in the "CRDP" repository, you have to be
able to make a scp to `repository@repository.crdp.ac-versailles.fr`
via a SSH key. Your SSH public key must be put in the file
`/home/repository/.ssh/authorized_keys` of this server:
```sh
# To build the package.
cd xia-packaging/ && ./make build
cat > /tmp/.dput.cf <<EOF
[xia]
fqdn = <Private IP of repository.crdp.ac-versailles.fr>
login = repository
method = scp
incoming = /var/www/debian/incoming/xia
allow_unsigned_uploads = 1
EOF
# "*" to match the version number.
dput -c /tmp/.dput.cf xia xia_*_amd64.changes
```
# Put the package in the "mentors" repository
To do that, you must be a maintainer of the package (ie you
must be present in the `Maintainer` field or in the
`Uploaders` field of the `src/debian/control` file) and you
must have a valid `~/.gnupg` directory on this current host.
If you want to upload the package to `mentors.debian.net`,
you can launch these commands:
```sh
# You must have a valid `~/.gnupg` directory on this current host.
./make build_sign
# You have to sign the package with your GPG key.
cd xia-packaging/ && ./make build_sign
cat > /tmp/.dput.cf <<EOF
[mentors]
......@@ -115,7 +139,23 @@ allowed_distributions = .*
EOF
dput -c /tmp/.dput.cf mentors *.changes
dput -c /tmp/.dput.cf xia xia_*_amd64.changes
```
# Install and test the package quickly
You can install and test the package quickly on Debian
Wheezy, Debian Jessie and Ubuntu Trusty Tahr. You just need
to launch these commands as *root*:
```sh
wget -q "http://repository.crdp.ac-versailles.fr/crdp.gpg" -O - | apt-key add -
echo "deb http://repository.crdp.ac-versailles.fr/debian xia main" | tee /etc/apt/sources.list.d/xia.list
apt-get update
apt-get install xia
```
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment