repository Repository Format

The repository repository format is used to automatically create configuration files for new repositories whose information is published in unavailable format repositories, which can be installed using packages named like repository/foo. It is supported on Exherbo and Gentoo.

As well as the general keys supported for all repositories, the following keys have meaning for repository format repositories:

config_template

The template file to use when creating configuration files. Mandatory. Most users will want to set this to /etc/paludis/repository.template, which will then need to be created as described below.

config_filename

The filename to use when creating configuration files. Most users will want to set this to /etc/paludis/repositories/%{repository_template_name}.conf (note the %, which is not a $).

Repository Template

On Gentoo, a typical /etc/paludis/repository.template will look like:

format = %{repository_template_format}
location = /var/db/paludis/repositories/%{repository_template_name}
sync = %{repository_template_sync}
master_repository = gentoo

Note that after a repository is 'installed', it may be necessary to remove the master_repository line from the generated repository configuration if a repository specifies its own masters via layout.conf. Paludis will issue a warning when this is necessary.

On Exherbo, a typical /etc/paludis/repository.template will look like:

format = %{repository_template_format}
location = /var/db/paludis/repositories/%{repository_template_name}
sync = %{repository_template_sync}

There is no need to specify a master_repository, since all Exherbo repositories specify their own masters.

In both cases, note again the % variables. Percent variables are replaced when creating the repository template file; variables using the conventional dollar syntax are written without substitution to the configuration file.