This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!
Project Description
Introduction
============
Keeping the links in your site up to date is hard and unappreciated work.
Content editors need all the help and incentive they can get to do
this job. Liches_ tries to make this task a bit easier.


Installation
============

Liches
-------

You have to install a Liches_ linkchecker server for this product to work.
please follow the Liches_ installation instructions and make sure your
Liches_ server works before installing the plone product.


Plone
------

This addon can be installed has any other addons, please follow official
documentation_.

.. _documentation: http://plone.org/documentation/kb/installing-add-ons-quick-how-to

The short version is:
++++++++++++++++++++++

Add ``collective.liches`` to the list of eggs to install, e.g.

::

[buildout]
...
eggs =
...
collective.liches

Re-run buildout, e.g. with

::

$ ./bin/buildout

Restart Plone and activate the product in Plones Add-on configuration
section.


Usage
======

Configure the access to your Liches_ Linkchecker server and which content
types will be displayed on your link checker start page in the plone
control panel. The 'Secrect Key' is you Liches_ API Key and used to
update existing pages in the Liches server

.. image:: https://raw.github.com/collective/collective.liches/master/docs/liches-settings.png


Linkcheckers normally go through your site recursivly which
will result in many pages to be checked several times. The
linkchecker start pages tries to avoid this by giving the
linkchecker_ a page from which every relevant content item can be reached.
Append `@@linkchecker-startpage.html` to your siteroot to view this page.

.. image:: https://raw.github.com/collective/collective.liches/master/docs/linkchecker-startpage.png

The Liches portlet gives an overview how many pages with broken links
are present in the site or the current path.

.. image:: https://raw.github.com/collective/collective.liches/master/docs/liches-portlet.png

The links in the portlet take you to a page which gives you an overview
of the pages with broken links in the site or current path. Alternatively
append `@@linkchecker-brokenpages.html` to your site root or to any
folder(ish object) in your site.

.. image:: https://raw.github.com/collective/collective.liches/master/docs/broken-pages-in-site.png

All pages will show you (as long as you are able to edit it) which links
are broken. At the top you see a summary of the links and the result
of the linkcheck. Broken Links are highlighted and underlined in red.
After you corrected the links you may want to recheck the links in this
page. Press the 'Check Links' Button and wait for a few minutes for the
linkchecker_ to finish.

.. image:: https://raw.github.com/collective/collective.liches/master/docs/broken-links-in-page.png

Similar Products
================

You may also want to have a look at the competition.

gocept.linkchecker_ relies on a separate process gocept.lms_ to perform
external link-checking. It communicates with Plone via XML-RPC.

collective.linkcheck_ is an integrated solution, with a headless instance
processing items in the background.

Why yet another solution?
-------------------------

- I want my linkchecking to be independent from plone and to be
able to monitor non plone sites with the same tool.
- Linkchecking is hard. The venerable linkchecker_ is a tried and tested
tool that does this job good. It has lots of options to finetune the results
to your needs e.g. to check the validity of HTLM and CSS.

.. _linkchecker: http://wummel.github.io/linkchecker/
.. _Liches: https://github.com/cleder/liches
.. _gocept.lms: https://pypi.python.org/pypi/gocept.lms/
.. _gocept.linkchecker: https://pypi.python.org/pypi/gocept.linkchecker/
.. _collective.linkcheck: https://pypi.python.org/pypi/collective.linkcheck/

Changelog
=========

0.2 (2013/08/30)
-----------------

- add portlet
- add button to invoke linkchecker for a certain page
- ability to filter invalid only pages
- filter pages with broken links by error code


0.1 (2013/07/31)
-------------------

- Initial release
Release History

Release History

0.2

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
collective.liches-0.2.tar.gz (23.3 kB) Copy SHA256 Checksum SHA256 Source Aug 30, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting