Metadata-Version: 2.0
Name: collective.nitf
Version: 1.0b7
Summary: A content type inspired on the IPTC's News Industry Text 
Home-page: https://github.com/collective/collective.nitf
Author: Héctor Velarde
Author-email: hector.velarde@gmail.com
License: GPLv2
Keywords: plone dexterity iptc newsml nitf
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 4.2
Classifier: Framework :: Plone :: 4.3
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: JavaScript
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Office/Business :: News/Diary
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: AccessControl
Requires-Dist: Acquisition
Requires-Dist: collective.js.galleria
Requires-Dist: collective.js.jqueryui
Requires-Dist: collective.prettydate (>=1.1)
Requires-Dist: collective.z3cform.widgets (>=1.0b9)
Requires-Dist: five.grok
Requires-Dist: Pillow
Requires-Dist: plone.api
Requires-Dist: plone.app.dexterity[grok,relations]
Requires-Dist: plone.app.imaging
Requires-Dist: plone.app.lockingbehavior
Requires-Dist: plone.app.portlets
Requires-Dist: plone.app.querystring (>=1.2.5)
Requires-Dist: plone.app.referenceablebehavior
Requires-Dist: plone.app.registry
Requires-Dist: plone.app.textfield
Requires-Dist: plone.app.vocabularies
Requires-Dist: plone.autoform
Requires-Dist: plone.dexterity
Requires-Dist: plone.directives.dexterity
Requires-Dist: plone.directives.form
Requires-Dist: plone.formwidget.contenttree
Requires-Dist: plone.indexer
Requires-Dist: plone.portlets
Requires-Dist: plone.registry
Requires-Dist: plone.uuid
Requires-Dist: Products.CMFCore
Requires-Dist: Products.CMFPlone (>=4.2)
Requires-Dist: Products.GenericSetup
Requires-Dist: setuptools
Requires-Dist: z3c.form
Requires-Dist: z3c.relationfield
Requires-Dist: zope.browserpage
Requires-Dist: zope.component
Requires-Dist: zope.i18nmessageid
Requires-Dist: zope.interface
Requires-Dist: zope.schema
Provides-Extra: test
Requires-Dist: plone.app.collection; extra == 'test'
Requires-Dist: plone.app.customerize; extra == 'test'
Requires-Dist: plone.app.robotframework; extra == 'test'
Requires-Dist: plone.app.testing[robot] (>=4.2.2); extra == 'test'
Requires-Dist: plone.app.testing; extra == 'test'
Requires-Dist: plone.browserlayer; extra == 'test'
Requires-Dist: plone.namedfile[blobs]; extra == 'test'
Requires-Dist: plone.testing; extra == 'test'
Requires-Dist: robotsuite; extra == 'test'
Requires-Dist: unittest2; extra == 'test'

===============
collective.nitf
===============

.. contents:: Table of Contents

Life, the Universe, and Everything
----------------------------------

News articles in Plone are instances of the 'News Item' content type: they can
contain a title, a description, a body text, an image and some basic metadata.
If you publish a couple of items from time to time, this is fine.

But suppose you have to publish dozens of items everyday... How do you tell
your readers who they are about? What do they cover? Where do they took place?
And, more important, how do you classify them? How do you organize them? How
do you tell your readers which ones are newsworthy?

To solve these, and other issues, the `IPTC`_ developed XML standards to
define the content and structure of news articles. `NITF`_, `NewsML`_ and
`NewsCodes`_ are among these standards and they support the classification,
identification and description of a huge number of news articles
characteristics.

NITF is intended to structure independent news articles and this package aims
to implement a content type inspired by the specification.

Mostly Harmless
---------------

.. image:: https://secure.travis-ci.org/collective/collective.nitf.png?branch=1.x
    :alt: Travis CI badge
    :target: http://travis-ci.org/collective/collective.nitf

.. image:: https://coveralls.io/repos/collective/collective.nitf/badge.png?branch=1.x
    :alt: Coveralls badge
    :target: https://coveralls.io/r/collective/collective.nitf

.. image:: https://pypip.in/d/collective.nitf/badge.png
    :alt: Downloads
    :target: https://pypi.python.org/pypi/collective.nitf/

Got an idea? Found a bug? Let us know by `opening a support ticket`_.

Don't Panic
-----------

Installation
^^^^^^^^^^^^

To enable this product in a buildout-based installation:

1. Edit your buildout.cfg and add ``collective.nitf`` to the list of eggs to
   install::

    [buildout]
    ...
    eggs =
        collective.nitf

After updating the configuration you need to run ''bin/buildout'', which will
take care of updating your system.

Go to the 'Site Setup' page in a Plone site and click on the 'Add-ons' link.

Check the box next to ``collective.nitf`` and click the 'Activate' button.

.. Note:

	You may have to empty your browser cache and save your resource registries
	in order to see the effects of the product installation.

Helper views
^^^^^^^^^^^^

All news articles provide @@nitf and @@newsml views that are available
although are not registered.

Validating
^^^^^^^^^^

You can validate the output of the @@nitf and @@newsml views using services
like `XML validation`_.

You may use the `NITF Document Type Definition`_ version 3.5 and the `XHTML
Ruby Module`_ associated with it.

.. _`Dexterity`: http://pypi.python.org/pypi/plone.app.dexterity
.. _`IPTC`: http://www.iptc.org/
.. _`NewsCodes`: http://www.iptc.org/NewsCodes/
.. _`NewsML`: http://www.newsml.org/
.. _`NITF`: http://www.nitf.org/
.. _`NITF Document Type Definition`: http://www.iptc.org/std/NITF/3.5/specification/nitf-3-5.dtd
.. _`XHTML Ruby Module`: http://www.iptc.org/std/NITF/3.5/specification/xhtml-ruby-1.mod
.. _`XML validation`: http://www.xmlvalidation.com/
.. _`opening a support ticket`: https://github.com/collective/collective.nitf/issues

Share and Enjoy
---------------

``collective.nitf`` would not have been possible without the contribution of
the following people:

- Héctor Velarde
- Joaquín Rosales
- Érico Andrei
- Juan A. Díaz
- Silvestre Huens
- Gonzalo Almeida
- Franco Pellegrini
- Cleber J Santos
- Rodrigo Ferreira de Souza
- Winston Ferreira


You can find an updated list of package contributors on `GitHub`_.

Development sponsored by Open Multimedia.

.. _`GitHub`: https://github.com/collective/collective.nitf/contributors

There's a frood who really knows where his towel is
---------------------------------------------------

1.0b7 (2015-10-01)
^^^^^^^^^^^^^^^^^^

- Hide profiles used on upgrade steps (closes `#143`_).
  [winstonf88]


1.0b6 (2015-09-30)
^^^^^^^^^^^^^^^^^^

- Fix AttributeError on upgrade step (closes `#139`_).
  [winstonf88, rodfersou]

- Byline field honored in syndication (closes `#93`_).
  [rodfersou]


1.0b5 (2015-05-01)
^^^^^^^^^^^^^^^^^^

- Fix urgency field filter for Collections (closes `#111`_).
  [rodfersou]


1.0b4 (2014-12-26)
^^^^^^^^^^^^^^^^^^^^^^

- Add locking behaviour. [rodfersou]


1.0b3 (2013-07-23)
^^^^^^^^^^^^^^^^^^

- Remove unused gallery_viewlet template. [hvelarde]

- Fix @@images view to proper use all the params it receives [ericof]

- Changes galleria debug to off mode. [cleberjsantos]

- Fix galleria view with large image. [cleberjsantos]


1.0b2 (2013-05-02)
^^^^^^^^^^^^^^^^^^

- Update Brazilian Portuguese translation. [hvelarde]

- Fix image scaling of Dexterity images. [ericof]

- Cleanup Galleria code; add title and description (when available). [ericof]

- Fix character counter selector. [cleberjsantos]


1.0b1 (2013-04-17)
^^^^^^^^^^^^^^^^^^

- News Article now support plone.app.contenttypes [ericof]

- Remove default and missing_value attributes from text field, this is
  causing problems with the RichText widget in Plone 4.3, now that is
  handled in the indexer. [jpgimenez]

- Package is now Dexterity 2.0 and Plone 4.3 compatible (closes `#52`_).
  [jpgimenez, hvelarde]

- Remove needless registration of TokenInputFieldWidget now made at
  installation time of collective.z3cform.widgets in new release 1.0b6.
  [hvelarde]

- Upgrade step to fix content created before the setting of widgets default
  values (closes `#49`_). [jpgimenez]

- Fix for summary_view with NITF content inside. [jpgimenez]

- Remove old js code to collapse edit form. [jpgimenez]

- Support image traversal. [jpgimenez]

- Use galleria.io for image galleries with a custom theme. [jpgimenez]

- Move the gallery to an overlay and load the images with ajax. [jpgimenez]

- Package is no longer compatible with Plone 4.1. [hvelarde]

- Do not show the folder listing if there are no files or links inside the
  News Article. [hvelarde]

- Initial Brazilian Portuguese translation. [agnogueira]

- NITF content type does not implement INonStructuralFolder any longer to
  allow folder factories menu. [jpgimenez]

- Add Pillow as a dependency of the package. [hvelarde]

- PEP8 fixes. [ericof]

- Create named vocabularies for Genres and Urgencies. [ericof]

- Vocabularies terms are now shown sorted; tests added. [hvelarde]

- Replaced the UserFriendlyTypes vocabulary in favor of
  ReallyUserFriendlyTypes. [frapell]

- Control panel fields sections and possible_genres were renamed to
  available_sections and available_genres; some code refactoring for better
  readability; tests were updated. [hvelarde]

- Added a field to the control panel to set the relatable content types; tests
  were updated. [hvelarde]

- Add-on layer was renamed to INITFLayer. [hvelarde]

- Change relatedItem widget to use MultiContentSearchFieldWidget. [flecox]

- Adds support to new-style Collections. [davilima6]

- Added charcount functionality for title and description [quimera]

- fix alternative view for news articles. [cleberjsantos]


1.0a3 (2012-07-06)
^^^^^^^^^^^^^^^^^^

- Make the NITF object to provide the INonStructuralFolder interface so
  comments can be added to them. [frapell]


1.0a2 (2012-06-18)
^^^^^^^^^^^^^^^^^^

- Dependency package collective.prettydate no longer has a GS profile.
  [hvelarde]

- Indexes are now installed in an alternate way so catalog information is not
  lost on package reinstall (fixes `#33`_). [hvelarde]

- Spanish translation of News Codes was updated. [hvelarde]


1.0a1 (2012-05-21)
^^^^^^^^^^^^^^^^^^

- Initial release.

.. _`#33`: https://github.com/collective/collective.nitf/issues/33
.. _`#49`: https://github.com/collective/collective.nitf/issues/49
.. _`#52`: https://github.com/collective/collective.nitf/issues/52
.. _`#93`: https://github.com/collective/collective.nitf/issues/93
.. _`#111`: https://github.com/collective/collective.nitf/issues/111
.. _`#139`: https://github.com/collective/collective.nitf/issues/139
.. _`#143`: https://github.com/collective/collective.nitf/issues/143


