silva.system.utils

HomePage: https://github.com/silvacms/silva.system.utils

Author: Infrae

Download: https://pypi.python.org/packages/source/s/silva.system.utils/silva.system.utils-1.4.2.tar.gz

        ==================
silva.system.utils
==================

Introduction
============

This extension provides a script to help you manage `Silva`_ sites in
the Zope instance from the command line. This will add script into the
``bin`` directory of your installation called ``silva``.

For most of the operations, the script requires you to provide the
Zope 2 configuration file with the option ``-c``.

By default you can , view the Silva site in the root of your database,
create and delete Silva sites, and users to them, pack your database,
and remove old versions of versioned content.

The script is however pluggable. An another default command provided
by ``silva.core.upgrade`` extension let you to upgrade a Silva site.

Default commands
================

``manage``
   Manage Silva sites:

   - List existing Silva sites,

   - Add a new Silva site,

   - Delete an existing Silva site,

   - Install documentation into an existing Silva site,

   - Add a user into an existing Silva site.

   Multiple actions can done at the same time: you can create a new
   Silva, install the documentation and add a user to it.

``pack``
   Pack a database. The database ``name`` and the number of ``days``
   to pack can be provided on the command line.

``files``
   Convert Silva file storage accordingly to the service files
   settings.

``versions``
   Delete old closed versions from versioned content. The number of
   version to keep is configurable.

``zexp_export``
   Export content into a ZEXP file.

``zexp_import``
   Import a ZEXP file.

``xml_import``
   Import an Silva XML file.

Code repository
===============

The code source for this extension can be found in Git at:
https://github.com/silvacms/silva.system.utils

.. _Silva: http://silvacms.org/

Changes
=======

1.4.2 (2013/08/26)
------------------

- Add support to import ZEXP referring to missing filesystem code.

1.4.1 (2013/05/23)
------------------

- Add support for XML import options to the ``xml_import`` command.

- Support to set the title of a Silva site while creating it from the
  command line.

1.4 (2013/03/06)
----------------

- Add ``xml_import`` command.

- Improve debugging of errors containing UTF-8 characters.

1.3 (2012/12/11)
----------------

- Add ``zexp_import`` and ``zexp_export`` commands.

1.2 (2012/09/24)
----------------

This is a Silva 3.0 compatible only release.

- Update API to convert file storage.

- Improve pack command.

- Add a command to create a new Silva root, install documentation and
  add user to it.

- Add a generic log option.


1.1 (2012/02/23)
----------------

This is a Silva 2.3 compatible only release.

- Add a command to convert file storage from the command line.

- Add a command to find code sources, and where they are found.

- Commands now support to run actions in a Silva site with a logged
  user.

1.0 (2011/11/10)
----------------

- Initial release.