Provided by: ubuntu-defaults-builder_0.23_all bug

NAME

       ubuntu-defaults-template   -  create  skeleton  defaults  customization
       package

SYNOPSIS

       ubuntu-defaults-template [ --quiet ] packagename

DESCRIPTION

       The ubuntu-defaults-builder project  allows  you  to  easily  create  a
       "default settings" package for Ubuntu and then build a customized image
       with it.  The main purpose for this is to provide a standard  and  safe
       way to create localized Ubuntu images, or OEM custom projects.

       The ubuntu-defaults-template script will generate a source package with
       the  customizable   settings   (e.   g.    desktop/background.jpg   and
       webbrowser/bookmarks-menu.txt).  When built and installed, it will take
       the necessary actions to modify the system-wide defaults for  desktops,
       programs, etc.

       The  first  step  is  to  call ubuntu-defaults-template with the target
       package name as an argument, for  example  "ubuntu-defaults-french"  or
       "mockbuntu-default-settings".  This  will  create a source package with
       the given name in the current  directory,  with  a  set  of  (disabled)
       example  configuration  files,  and a standard debian/ packaging (using
       mostly dh_ubuntu_defaults).

       Then  you   customize   the   individual   configuration   files   like
       webbrowser/bookmarks-menu.txt or unity/launchers.txt to your needs, and
       then run dpkg-buildpackage(1) to build the source and binary  packages.
       Once  you  install  the generated .deb, new users will from then on use
       the new default settings.

       After you have done this,  you  can  build  installation  images  using
       ubuntu-defaults-image(1).

CONFIGURATION

       At present you can change the following defaults:

       o Desktop background image (desktop/background.jpg)

       o Additional  .desktop files (desktop/*.desktop, particularly useful to
         provide launchers for web applications)

       o Default  desktop  session   in   login   managers   (desktop/default-
         session.txt) Supports LightDM and GDM right now.

       o Default applications (desktop/default-applications.txt)

       o Webbrowser      start      page     (webbrowser/startpage.txt     and
         webbrowser/offline-startpage.txt)

       o Additional Webbrowser bookmarks  in  the  Menu  and  in  the  Toolbar
         (webbrowser/bookmarks-menu.txt and webbrowser/bookmarks-toolbar.txt)

       o Webbrowser default search engine (webbrowser/searchengine.txt)

       o Radio       stations       in       Rhythmbox       and       Banshee
         (multimedia/radiostations.txt)

       o Additional launchers in Unity and Unity 2d (unity/launchers.txt).

       o Internationalization support (i18n/language.txt,  i18n/langpacks.txt,
         i18n/keyboard.txt)

       o Additional  icons  (icons/,  *.jpg, *.png, or *.svg, in the directory
         hierarchy given in /usr/share/icons/hicolor/)

       o Extra packages (depends.txt and recommends.txt)

       Except for desktop/background.jpg, all configuration files  are  simple
       text  files  with  one  entry  per line. Lines which start with '#' are
       ignored and can be used  for  comments.  Each  configuration  file  has
       comments which document the format and give some example entries.

MACROS

       All  configuration  files  can  contain  macro  variables which will be
       expanded  when  building  the  defaults  package.  At  present,   these
       variables are known:

       o ${distro_release_number} The release number of the Ubuntu release the
         package is built on. E. g.  "11.04".

       o ${distro_release_name} The release code name of  the  Ubuntu  release
         the package is built on. E. g.  "lucid".

       Unknown  variables  will  abort  the package build, to avoid unexpected
       results.

EXAMPLE

       You can run  the  /usr/share/doc/ubuntu-defaults-builder/examples/make-
       example  to  build  an  "ubuntu-defaults-test"  defaults package in the
       current directory, which will exercise all possible  customizations  by
       uncommenting the examples from the configuration files.

SEE ALSO

       dh_ubuntu_defaults(1), ubuntu-defaults-image(1)

       /usr/share/doc/ubuntu-defaults-builder/examples/make-example

       https://wiki.ubuntu.com/DesktopTeam/Specs/Oneiric/LocalizedCDImageTools

AUTHOR

       ubuntu-defaults-builder     is     developed     by     Martin     Pitt
       <martin.pitt@ubuntu.com>.