From 9db7568a75336f1b1234247147470f395b0c2161 Mon Sep 17 00:00:00 2001 From: Danilo Dellaquila Date: Sat, 21 Jul 2012 12:24:28 +0200 Subject: [PATCH 1/3] Add buildout download-cache directory with dummy file This avoid bootstrap to throw an error because the directory is missing. --- .gitignore | 7 ++++--- downloads/README.txt | 1 + 2 files changed, 5 insertions(+), 3 deletions(-) create mode 100644 downloads/README.txt diff --git a/.gitignore b/.gitignore index 13edefa..541d701 100644 --- a/.gitignore +++ b/.gitignore @@ -21,14 +21,15 @@ bin/ build/ develop-eggs/ -downloads/ +downloads/* eggs/ fake-eggs/ parts/ dist/ var/ - - # OSX .DS_Store + +# Don't ignore those files +!downloads/README.txt diff --git a/downloads/README.txt b/downloads/README.txt new file mode 100644 index 0000000..17bbd4b --- /dev/null +++ b/downloads/README.txt @@ -0,0 +1 @@ +Download cache directory for buildout. From 338acc18e72b9a2bc2943996dd8f391ae55da6fe Mon Sep 17 00:00:00 2001 From: Danilo Dellaquila Date: Sat, 21 Jul 2012 20:49:40 +0200 Subject: [PATCH 2/3] Set buildout for Plone 4.1.5 To create toplone script it use funnelweb which is reading its configuration from pipeline.cfg file. Also I've clean up transmogrify.* sources. --- buildout.cfg | 33 +- pipeline.in | 53 +++ plone415.cfg | 22 ++ sphinx.cfg | 9 - toplone.cfg | 139 +------ versions.cfg | 1040 ++++++++++++++++++++++++++++++++++++++++++++++++++ 6 files changed, 1142 insertions(+), 154 deletions(-) create mode 100644 pipeline.in create mode 100644 plone415.cfg create mode 100644 versions.cfg diff --git a/buildout.cfg b/buildout.cfg index 3e721d2..ed56992 100644 --- a/buildout.cfg +++ b/buildout.cfg @@ -1,30 +1,41 @@ # -# Buildout to create toplone command which uploads +# Buildout to create toplone command which uploads # Sphinx documentation to Plone site # [buildout] download-cache = ${buildout:directory}/downloads newest = false -#index = http://localhost/packages -find-links = - http://b.pypi.python.org - http://c.pypi.python.org - http://d.pypi.python.org - versions = versions extensions = buildout.dumppickedversions + mr.developer + +# mr.developer configurations +always-checkout = force +auto-checkout = * +sources = sources # buildout.dumppickedversions configurations -# For options see http://pypi.python.org/pypi/buildout.dumppickedversions +# For options see +# http://pypi.python.org/pypi/buildout.dumppickedversions allow-picked-versions = true -dump-picked-versions-file = picked.cfg +dump-picked-versions-file = ${buildout:directory}/picked-versions.cfg overwrite-picked-versions-file = True -extends = +extends = sphinx.cfg # plone336.cfg -# toplone.cfg + plone415.cfg + toplone.cfg + versions.cfg + +parts = + sphinx + instance + toplone + pipeline +[sources] +transmogrify.ploneremote = git https://github.com/collective/transmogrify.ploneremote.git diff --git a/pipeline.in b/pipeline.in new file mode 100644 index 0000000..cdb7e8a --- /dev/null +++ b/pipeline.in @@ -0,0 +1,53 @@ +[transmogrifier] +include = funnelweb.remote + +[crawler] +url=file://${buildout:directory}/build/html +#max=10 + +ignore= + cgi-bin + javascript: + _static + _sources + genindex\.html + search\.html + saesrchindex\.js + +[template1] +title = text //div[@class='body']//h1[1] +description = optional //div[contains(@class,'admonition-description')]/p[@class='last']/text() +text = html //div[@class='body'] +# Fields with '_' won't be uploaded to Plone so will be effectively removed +_permalink = text //div[@class='body']//a[@class='headerlink'] +_label = optional //p[contains(@class,'admonition-title')] +_remove_useless_links = optional //div[@id = 'indices-and-tables'] + +# Images will get titles from backlink text +[titleguess] +condition = python:True + +# Pages linked to content will be moved together +[indexguess] +condition = python:True + +# Hide the images folder from navigation +[hideguess] +condition = python:item.get("_path","").startswith('_images') and item.get('_type')=='Folder' + +# Save locally for debugging purposes +#[localupload] +#output=var/documentacion + +# Upload to Plone Development Server +[ploneupload] +target=http://admin:admin@localhost:8080/Plone/documentacion + +## Upload as PHC instead of Folders and Pages +#[changetype] +#value=python:{'Folder':'HelpCenterReferenceManualFolder','Document':'HelpCenterReferenceManualPage'}.get(item['_type'],item['_type']) + +## All folderish content should be checked if they contain +## any items on the remote site which are not presented locally. including base folder +#[ploneprune] +#condition=python:item.get('_type') in ['HelpCenterReferenceManualFolder','HelpCenterReferenceManual'] or item['_path'] == '' diff --git a/plone415.cfg b/plone415.cfg new file mode 100644 index 0000000..5c9bb80 --- /dev/null +++ b/plone415.cfg @@ -0,0 +1,22 @@ +[buildout] +extends += + http://dist.plone.org/release/4.1.5/versions.cfg +versions = versions + +find-links += + http://dist.plone.org + http://download.zope.org/ppix/ + http://download.zope.org/distribution/ + http://effbot.org/downloads + http://dist.plone.org/release/4.1.5 + http://dist.plone.org/thirdparty/ + + +[instance] +recipe = plone.recipe.zope2instance +user = admin:admin +http-address = 8080 +eggs = + Plone + Pillow + diff --git a/sphinx.cfg b/sphinx.cfg index 4ca9210..8adb1a8 100644 --- a/sphinx.cfg +++ b/sphinx.cfg @@ -1,15 +1,6 @@ # # A Buildout configuration for install Sphinx tools # -[buildout] -parts = - sphinx - -[versions] -collective.recipe.sphinxbuilder = 0.7.1 -Sphinx = 1.1.3 -Docutils = 0.7 - # This recipe helps to generate and build Sphinx-based documentation in the buildout. # For options see http://pypi.python.org/pypi/collective.recipe.sphinxbuilder [sphinx] diff --git a/toplone.cfg b/toplone.cfg index 292cc18..1b8964c 100644 --- a/toplone.cfg +++ b/toplone.cfg @@ -1,138 +1,9 @@ -[buildout] -parts += - toplone - -[sources] -transmogrify.webcrawler = git git://github.com/djay/transmogrify.webcrawler.git -#transmogrify.webcrawler = git git://github.com/miohtama/transmogrify.webcrawler.git - -transmogrify.pathsorter = git git://github.com/djay/transmogrify.pathsorter.git -transmogrify.htmltesting = git git://github.com/djay/transmogrify.htmltesting.git - -transmogrify.siteanalyser = git git://github.com/djay/transmogrify.siteanalyser.git -#transmogrify.siteanalyser = git git://github.com/miohtama/transmogrify.siteanalyser.git - -transmogrify.htmltesting = git git://github.com/djay/transmogrify.htmltesting.git -#transmogrify.htmltesting = git git://github.com/miohtama/transmogrify.htmltesting.git - -# Following have been patched - -transmogrify.ploneremote = git git://github.com/djay/transmogrify.ploneremote.git -#transmogrify.ploneremote = git git://github.com/miohtama/transmogrify.ploneremote.git - -transmogrify.htmlcontentextractor = git git://github.com/djay/transmogrify.htmlcontentextractor.git -#transmogrify.htmlcontentextractor = git git://github.com/miohtama/transmogrify.htmlcontentextractor.git - -#funnelweb = git git://github.com/djay/funnelweb.git -funnelweb = git git://github.com/collective/funnelweb.git - -# -# Recipe to create toplone command. -# -# It will walk through all blueprints defined -# in pipeline.cfg and override their target parameter -# to be a remote Plone site given on the command line. -# This all happeins in initialization= magic. -# -# Also Python logger is initialized to give us verbose -# output. Some blueprints use logging module for the output. -# -#[toplone] -#recipe = zc.recipe.egg -#eggs = -# transmogrify.htmltesting -# transmogrify.webcrawler -# transmogrify.siteanalyser -# transmogrify.htmlcontentextractor -# transmogrify.pathsorter -# transmogrify.ploneremote -# -## This initialization script sets remote site argument -## for remote blueprints defined in pipeline.cfg -#initialization = -# from urllib import pathname2url as url -# from sys import argv -# import logging, os -# -# logging.basicConfig(level=logging.DEBUG) -# target=len(argv) > 1 and argv[1] or '' -# args = dict(webcrawler=dict(site_url='file://'+os.getcwd()+'/build/html/'), -# localconstructor=dict(output=url('ploneout')), -# ploneuploader=dict(target=target), -# ) -#arguments = 'pipeline.cfg', args -#entry-points = toplone=transmogrify.htmltesting.runner:runner - - -# -# Recipe to create toplone command. -# -# Using the funnelweb blueprint to create a script -# to convert and upload the manual as plone content -# bin/toplone --ploneupload=http://admin:admin@comunidades.cenditel.gob.ve/home/ -# use --template1:debug to get extra detail on fields extracted from pages. -# use --changetype:value="python:item['_type']" if you want to test on plone site without PHC -# see http://plone.org/products/funnelweb -# [toplone] recipe = funnelweb -crawler-url=file://${buildout:directory}/build/html -crawler-ignore= - cgi-bin - javascript: - _static - _sources - genindex\.html - search\.html - saesrchindex\.js -# Since content is from disk, no need for local cache -cache-output = - -# Fields with '_' won't be uploaded to Plone so will be effectively removed -template1-title = text //div[@class='body']//h1[1] -template1-_permalink = text //div[@class='body']//a[@class='headerlink'] -template1-text = html //div[@class='body'] -template1-_label = optional //p[contains(@class,'admonition-title')] -template1-description = optional //div[contains(@class,'admonition-description')]/p[@class='last']/text() -template1-_remove_useless_links = optional //div[@id = 'indices-and-tables'] -templateauto-condition = python:False - -#attachmentguess-condition = python: subitem.get('_type') in ['Image'] -#attachmentguess-defaultpage = index - -# Images will get titles from backlink text -titleguess-condition = python:True -indexguess-condition = python:True - -# Hide the images folder from navigation -hideguess-condition = python:item.get("_path","").startswith('_images') and item.get('_type')=='Folder' - -# Upload as PHC instead of Folders and Pages -changetype-value=python:{'Folder':'HelpCenterReferenceManualSection','Document':'HelpCenterLeafPage'}.get(item['_type'],item['_type']) - -# Save locally for debugging purposes -# WARNING: not currently working -#localupload-output=${buildout:directory}/ploneout - -# All folderish content should be checked if they contain -# any items on the remote site which are not presented locally. including base folder -ploneprune-condition=python:item.get('_type') in ['HelpCenterReferenceManualSection','HelpCenterReferenceManual'] or item['_path'] == '' - - -[test] -recipe = zc.recipe.testrunner -eggs = - ${toplone:eggs} - transmogrify.htmltesting - -[lxml] -recipe = z3c.recipe.staticlxml -egg = lxml - +pipeline=pipeline.cfg -[versions] -roadrunner = 0.2.3.1 -z3c.form = 1.9.0 -zc.recipe.egg=1.2.0 -Docutils = 0.6 +[pipeline] +recipe = collective.recipe.template +input = ${buildout:directory}/pipeline.in +output = ${buildout:directory}/pipeline.cfg diff --git a/versions.cfg b/versions.cfg new file mode 100644 index 0000000..2e146d5 --- /dev/null +++ b/versions.cfg @@ -0,0 +1,1040 @@ +[versions] +AccessControl = 2.13.7 +Jinja2 = 2.5.5 +Markdown = 2.0.3 +Plone = 4.1.5 +Products.ATContentTypes = 2.1.7 +Products.OFSP = 2.13.2 +Products.PlonePAS = 4.0.12 +Pygments = 1.3.1 +Sphinx = 1.0.8 +Zope2 = 2.13.13 +archetypes.schemaextender = 2.1.1 +collective.recipe.sphinxbuilder = 0.7.1 +collective.z3cform.datetimewidget = 1.0.5 +distribute = 0.6.24 +funnelweb = 1.1.1 +manuel = 1.1.1 +mechanize = 0.2.5 +mr.developer = 1.18 +mr.migrator = 1.0 +plone.app.contentmenu = 2.0.5 +plone.app.imaging = 1.0.6 +plone.app.layout = 2.1.13 +plone.app.linkintegrity = 1.4.5 +plone.app.registry = 1.0.1 +plone.autoform = 1.2 +plone.browserlayer = 2.1.1 +plone.keyring = 2.0 +plone.recipe.zope2instance = 4.1.9 +plone.registry = 1.0 +plone.supermodel = 1.1.1 +plone.z3cform = 0.7.8 +python-gettext = 1.2 +python-openid = 2.2.5 +roman = 1.4.0 +transmogrify.htmlcontentextractor = 1.0 +transmogrify.pathsorter = 1.0b4 +transmogrify.ploneremote = 1.2 +transmogrify.siteanalyser = 1.2 +transmogrify.webcrawler = 1.1 +z3c.caching = 2.0a1 +zope.app.locales = 3.6.2 +zope.hookable = 3.4.1 +zc.buildout = 1.4.4 +zc.recipe.egg = 1.2.2 +Pillow = 1.7.7 +collective.recipe.template = 1.9 + +#Required by: +#Zope2 2.13.13 +Acquisition = 2.13.8 + +#Required by: +#transmogrify.htmlcontentextractor 1.0 +#transmogrify.webcrawler 1.1 +#transmogrify.siteanalyser 1.2 +BeautifulSoup = 3.2.1 + +#Required by: +#Zope2 2.13.13 +DateTime = 2.12.6 + +#Required by: +#Products.MIMETools 2.13.0 +#Products.PythonScripts 2.13.0 +#Zope2 2.13.13 +#Products.ZCatalog 2.13.22 +DocumentTemplate = 2.13.2 + +#Required by: +#Record 2.13.0 +#Missing 2.13.1 +#Persistence 2.13.2 +#Products.ZSQLMethods 2.13.4 +#Zope2 2.13.13 +ExtensionClass = 2.13.2 + +#Required by: +#Zope2 2.13.13 +Missing = 2.13.1 + +#Required by: +#Zope2 2.13.13 +MultiMapping = 2.13.0 + +#Required by: +#Zope2 2.13.13 +Persistence = 2.13.2 + +#Required by: +#Products.ATContentTypes 2.1.7 +Products.ATReferenceBrowserWidget = 3.0 + +#Required by: +#Products.kupu 1.5.0 +#plone.app.iterate 2.1.5 +#Products.CMFPlone 4.1.5 +Products.Archetypes = 1.7.13 + +#Required by: +#Zope2 2.13.13 +Products.BTreeFolder2 = 2.13.3 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFPlone 4.1.5 +Products.CMFActionIcons = 2.1.3 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +Products.CMFCalendar = 2.2.2 + +#Required by: +#funnelweb 1.1.1 +Products.CMFCore = 2.2.6 + +#Required by: +#plone.app.users 1.1.3 +#plone.app.upgrade 1.1.6 +#Products.Archetypes 1.7.13 +#plone.app.form 2.0.5 +#Products.PortalTransforms 2.0.7 +#plone.app.content 2.0.9 +#plone.theme 2.1 +#plone.app.contentrules 2.1.4 +#plone.app.controlpanel 2.1.4 +#plone.app.layout 2.1.13 +#Products.CMFPlone 4.1.5 +Products.CMFDefault = 2.2.2 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFEditions 2.1.7 +#Products.CMFPlone 4.1.5 +Products.CMFDiffTool = 2.0 + +#Required by: +#plone.app.caching 1.0.3 +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +Products.CMFDynamicViewFTI = 4.0.2 + +#Required by: +#plone.app.iterate 2.1.5 +#Products.CMFPlone 4.1.5 +Products.CMFEditions = 2.1.7 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +Products.CMFFormController = 3.0.2 + +#Required by: +#plone.app.iterate 2.1.5 +#Plone 4.1.5 +Products.CMFPlacefulWorkflow = 1.5.6 + +#Required by: +#Plone 4.1.5 +Products.CMFPlone = 4.1.5 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +Products.CMFQuickInstallerTool = 3.0.6 + +#Required by: +#Products.Archetypes 1.7.13 +Products.CMFTestCase = 0.9.11 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFEditions 2.1.7 +#Products.CMFPlone 4.1.5 +Products.CMFUid = 2.2.1 + +#Required by: +#plone.app.iterate 2.1.5 +#Products.CMFPlone 4.1.5 +Products.DCWorkflow = 2.2.4 + +#Required by: +#Products.CMFPlone 4.1.5 +Products.ExtendedPathIndex = 2.9 + +#Required by: +#Products.CMFPlone 4.1.5 +Products.ExternalEditor = 1.0 + +#Required by: +#Zope2 2.13.13 +Products.ExternalMethod = 2.13.0 + +#Required by: +#Products.CMFCore 2.2.6 +Products.GenericSetup = 1.6.6 + +#Required by: +#Zope2 2.13.13 +Products.MIMETools = 2.13.0 + +#Required by: +#Zope2 2.13.13 +Products.MailHost = 2.13.1 + +#Required by: +#Products.Archetypes 1.7.13 +Products.Marshall = 2.1.1 + +#Required by: +#Products.kupu 1.5.0 +#Products.PortalTransforms 2.0.7 +#Products.CMFPlone 4.1.5 +Products.MimetypesRegistry = 2.0.3 + +#Required by: +#Products.CMFPlone 4.1.5 +Products.PasswordResetTool = 2.0.7 + +#Required by: +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +Products.PlacelessTranslationService = 2.0.3 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFPlone 4.1.5 +Products.PloneLanguageTool = 3.2.4 + +#Required by: +#Products.CMFPlacefulWorkflow 1.5.6 +Products.PloneTestCase = 0.9.13 + +#Required by: +#plone.app.openid 2.0.2 +#Products.CMFPlone 4.1.5 +Products.PluggableAuthService = 1.7.7 + +#Required by: +#Products.PluggableAuthService 1.7.7 +#Products.CMFPlone 4.1.5 +Products.PluginRegistry = 1.3 + +#Required by: +#Products.kupu 1.5.0 +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +Products.PortalTransforms = 2.0.7 + +#Required by: +#Zope2 2.13.13 +Products.PythonScripts = 2.13.0 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFPlone 4.1.5 +Products.ResourceRegistries = 2.0.9 + +#Required by: +#plone.app.upgrade 1.1.6 +Products.SecureMailHost = 1.1.2 + +#Required by: +#Zope2 2.13.13 +Products.StandardCacheManagers = 2.13.0 + +#Required by: +#Products.CMFPlone 4.1.5 +Products.TinyMCE = 1.2.11 + +#Required by: +#Zope2 2.13.13 +Products.ZCTextIndex = 2.13.3 + +#Required by: +#Zope2 2.13.13 +Products.ZCatalog = 2.13.22 + +#Required by: +#Products.CMFCore 2.2.6 +Products.ZSQLMethods = 2.13.4 + +#Required by: +#Products.CMFEditions 2.1.7 +Products.ZopeVersionControl = 1.1.3 + +#Required by: +#plone.app.upgrade 1.1.6 +Products.contentmigration = 2.1.1 + +#Required by: +#Plone 4.1.5 +Products.kupu = 1.5.0 + +#Required by: +#plone.app.caching 1.0.3 +#plone.app.iterate 2.1.5 +#Products.CMFPlone 4.1.5 +Products.statusmessages = 4.0 + +#Required by: +#Products.Archetypes 1.7.13 +#Products.ATContentTypes 2.1.7 +Products.validation = 2.0 + +#Required by: +#Zope2 2.13.13 +Record = 2.13.0 + +#Required by: +#Zope2 2.13.13 +RestrictedPython = 3.6.0 + +#Required by: +#plone.i18n 2.0 +Unidecode = 0.04.1 + +#Required by: +#zdaemon 2.0.4 +#zLOG 2.11.1 +#Zope2 2.13.13 +#ZODB3 3.10.5 +ZConfig = 2.9.0 + +#Required by: +#Zope2 2.13.13 +#zope.annotation 3.5.0 +#zope.container 3.11.2 +ZODB3 = 3.10.5 + +#Required by: +#Zope2 2.13.13 +ZopeUndo = 2.12.0 + +#Required by: +#Products.CMFPlone 4.1.5 +archetypes.kss = 1.7.1 + +#Required by: +#Products.CMFPlone 4.1.5 +archetypes.referencebrowserwidget = 2.4.11 + +#Required by: +#mr.developer 1.18 +argparse = 1.1 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.CMFPlone 4.1.5 +borg.localrole = 3.0.2 + +#Required by: +#plone.z3cform 0.7.8 +#plone.app.discussion 2.1.5 +collective.monkeypatcher = 1.0.1 + +#Required by: +#mr.migrator 1.0 +#transmogrify.htmlcontentextractor 1.0 +#transmogrify.webcrawler 1.1 +#funnelweb 1.1.1 +#transmogrify.ploneremote 1.2 +#transmogrify.siteanalyser 1.2 +collective.transmogrifier = 1.3 + +#Required by: +#mr.migrator 1.0 +configparser = 3.2.0r3 + +#Required by: +#Zope2 2.13.13 +docutils = 0.7 + +#Required by: +#plone.app.registry 1.0.1 +#Products.TinyMCE 1.2.11 +elementtree = 1.2.7-20070827-preview + +#Required by: +#plone.app.portlets 2.1.7 +feedparser = 5.0.1 + +#Required by: +#plone.app.customerize 1.2.2 +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +five.customerize = 1.0.2 + +#Required by: +#plone.app.users 1.1.3 +#plone.fieldsets 2.0.1 +#plone.app.form 2.0.5 +#plone.app.contentrules 2.1.4 +#plone.app.portlets 2.1.7 +five.formlib = 1.0.4 + +#Required by: +#plone.caching 1.0 +#plone.cachepurging 1.0.3 +five.globalrequest = 1.0 + +#Required by: +#Products.GenericSetup 1.6.6 +#Products.CMFCore 2.2.6 +five.localsitemanager = 2.0.5 + +#Required by: +#Zope2 2.13.13 +initgroups = 2.13.0 + +#Required by: +#plone.app.z3cform 0.5.7 +#plone.app.kss 1.6.2 +#plone.app.workflow 2.0.6 +#plone.app.contentrules 2.1.4 +#Products.CMFPlone 4.1.5 +kss.core = 1.6.3 + +#Required by: +#transmogrify.htmlcontentextractor 1.0 +#transmogrify.webcrawler 1.1 +#transmogrify.siteanalyser 1.2 +lxml = 2.3.4 + +#Required by: +#plone.recipe.zope2instance 4.1.9 +mailinglogger = 3.3.3 + +#Required by: +#configparser 3.2.0r3 +ordereddict = 1.1 + +#Required by: +#Products.CMFEditions 2.1.7 +#Products.CMFPlone 4.1.5 +plone.app.blob = 1.5.1 + +#Required by: +#Plone 4.1.5 +plone.app.caching = 1.0.3 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.content = 2.0.9 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.contentrules = 2.1.4 + +#Required by: +#plone.app.layout 2.1.13 +#Products.CMFPlone 4.1.5 +plone.app.controlpanel = 2.1.4 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.customerize = 1.2.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.discussion = 2.1.5 + +#Required by: +#plone.app.upgrade 1.1.6 +#Products.Archetypes 1.7.13 +#Products.CMFPlone 4.1.5 +plone.app.folder = 1.0.4 + +#Required by: +#plone.portlet.collection 2.0.4 +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +plone.app.form = 2.0.5 + +#Required by: +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +plone.app.i18n = 2.0.1 + +#Required by: +#Plone 4.1.5 +plone.app.iterate = 2.1.5 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.jquerytools = 1.3.1 + +#Required by: +#plone.app.z3cform 0.5.7 +#plone.app.workflow 2.0.6 +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +plone.app.kss = 1.6.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.locales = 4.0.11 + +#Required by: +#Plone 4.1.5 +plone.app.openid = 2.0.2 + +#Required by: +#plone.app.openid 2.0.2 +#Products.CMFPlone 4.1.5 +plone.app.portlets = 2.1.7 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.redirector = 1.1.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.upgrade = 1.1.6 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.users = 1.1.3 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.uuid = 1.0 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.viewletmanager = 2.0.2 + +#Required by: +#plone.portlet.collection 2.0.4 +#plone.app.portlets 2.1.7 +#Products.CMFPlone 4.1.5 +plone.app.vocabularies = 2.1.6 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.app.workflow = 2.0.6 + +#Required by: +#plone.app.caching 1.0.3 +plone.app.z3cform = 0.5.7 + +#Required by: +#plone.app.caching 1.0.3 +plone.cachepurging = 1.0.3 + +#Required by: +#plone.app.caching 1.0.3 +plone.caching = 1.0 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.contentrules = 2.0.1 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.fieldsets = 2.0.1 + +#Required by: +#plone.app.folder 1.0.4 +#Products.Archetypes 1.7.13 +plone.folder = 1.0.1 + +#Required by: +#transmogrify.siteanalyser 1.2 +plone.i18n = 2.0 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.indexer = 1.0 + +#Required by: +#Products.PortalTransforms 2.0.7 +#Products.CMFPlone 4.1.5 +plone.intelligenttext = 2.0.1 + +#Required by: +#plone.app.iterate 2.1.5 +#Products.CMFPlone 4.1.5 +plone.locking = 2.0.3 + +#Required by: +#plone.app.caching 1.0.3 +#plone.portlets 2.0.2 +#plone.app.iterate 2.1.5 +#plone.app.portlets 2.1.7 +#Products.PlonePAS 4.0.12 +#Products.CMFPlone 4.1.5 +plone.memoize = 1.1.1 + +#Required by: +#plone.app.openid 2.0.2 +plone.openid = 2.0 + +#Required by: +#Products.kupu 1.5.0 +plone.outputfilters = 1.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.portlet.collection = 2.0.4 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.portlet.static = 2.0.1 + +#Required by: +#plone.app.openid 2.0.2 +#Products.CMFPlone 4.1.5 +plone.portlets = 2.0.2 + +#Required by: +#plone.app.caching 1.0.3 +plone.protect = 2.0 + +#Required by: +#plone.app.blob 1.5.1 +plone.scale = 1.2.2 + +#Required by: +#Products.PlonePAS 4.0.12 +#Products.CMFPlone 4.1.5 +plone.session = 3.5 + +#Required by: +#plone.app.contentrules 2.1.4 +plone.stringinterp = 1.0.5 + +#Required by: +#Products.CMFPlone 4.1.5 +plone.theme = 2.1 + +#Required by: +#plone.caching 1.0 +plone.transformchain = 1.0.2 + +#Required by: +#plone.app.uuid 1.0 +#archetypes.kss 1.7.1 +#Products.Archetypes 1.7.13 +#plone.app.contentrules 2.1.4 +plone.uuid = 1.0.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plonetheme.classic = 1.1.2 + +#Required by: +#Products.CMFPlone 4.1.5 +plonetheme.sunburst = 1.1.6 + +#Required by: +#plone.app.caching 1.0.3 +python-dateutil = 1.5 + +#Required by: +#Zope2 2.13.13 +#zope.dublincore 3.7.0 +#zope.i18n 3.7.4 +#zope.formlib 4.0.6 +pytz = 2011n + +#Required by: +#Zope2 2.13.13 +tempstorage = 2.12.1 + +#Required by: +#Zope2 2.13.13 +transaction = 1.1.1 + +#Required by: +#configparser 3.2.0r3 +unittest2 = 0.5.1 + +#Required by: +#Plone 4.1.5 +wicked = 1.1.9 + +#Required by: +#mr.migrator 1.0 +z3c.autoinclude = 0.3.4 + +#Required by: +#plone.z3cform 0.7.8 +z3c.batching = 1.1.0 + +#Required by: +#plone.app.caching 1.0.3 +z3c.form = 2.5.1 + +#Required by: +#plone.app.z3cform 0.5.7 +z3c.formwidget.query = 0.5 + +#Required by: +#plone.app.caching 1.0.3 +z3c.zcmlhook = 1.0b1 + +#Required by: +#Products.PythonScripts 2.13.0 +#Zope2 2.13.13 +zExceptions = 2.13.0 + +#Required by: +#Zope2 2.13.13 +zLOG = 2.11.1 + +#Required by: +#ZODB3 3.10.5 +zc.lockfile = 1.0.0 + +#Required by: +#Zope2 2.13.13 +#ZODB3 3.10.5 +zdaemon = 2.0.4 + +#Required by: +#zope.site 3.9.2 +zope.annotation = 3.5.0 + +#Required by: +#plone.app.upgrade 1.1.6 +zope.app.cache = 3.7.0 + +#Required by: +#mr.migrator 1.0 +#funnelweb 1.1.1 +zope.app.component = 3.9.3 + +#Required by: +#zope.app.component 3.9.3 +zope.app.container = 3.9.2 + +#Required by: +#zope.app.folder 3.5.2 +zope.app.content = 3.5.1 + +#Required by: +#kss.core 1.6.3 +zope.app.folder = 3.5.2 + +#Required by: +#z3c.formwidget.query 0.5 +#five.formlib 1.0.4 +#plone.app.users 1.1.3 +#plone.app.form 2.0.5 +#plone.app.controlpanel 2.1.4 +#plone.app.vocabularies 2.1.6 +zope.app.form = 4.0.2 + +#Required by: +#funnelweb 1.1.1 +#zope.app.component 3.9.3 +zope.app.pagetemplate = 3.11.2 + +#Required by: +#kss.core 1.6.3 +zope.app.publication = 3.12.0 + +#Required by: +#plone.uuid 1.0.2 +#kss.core 1.6.3 +#plone.app.contentmenu 2.0.5 +#Products.CMFDynamicViewFTI 4.0.2 +zope.app.publisher = 3.10.2 + +#Required by: +#zope.app.publication 3.12.0 +zope.authentication = 3.7.1 + +#Required by: +#zope.container 3.11.2 +zope.broken = 3.6.0 + +#Required by: +#Zope2 2.13.13 +#zope.app.container 3.9.2 +#zope.publisher 3.12.6 +zope.browser = 1.3 + +#Required by: +#Zope2 2.13.13 +#zope.app.container 3.9.2 +zope.browsermenu = 3.9.1 + +#Required by: +#Zope2 2.13.13 +zope.browserpage = 3.12.2 + +#Required by: +#Zope2 2.13.13 +#zope.ptresource 3.9.0 +zope.browserresource = 3.10.3 + +#Required by: +#plone.app.controlpanel 2.1.4 +zope.cachedescriptors = 3.5.1 + +#Required by: +#Products.StandardCacheManagers 2.13.0 +#Zope2 2.13.13 +#zope.pagetemplate 3.5.2 +#zope.lifecycleevent 3.6.2 +#zope.contentprovider 3.7.2 +#zope.viewlet 3.7.2 +#zope.i18n 3.7.4 +#zope.security 3.7.4 +#zope.container 3.11.2 +#zope.publisher 3.12.6 +#zope.traversing 3.13.2 +#Products.CMFPlone 4.1.5 +zope.component = 3.9.5 + +#Required by: +#zope.app.component 3.9.3 +zope.componentvocabulary = 1.0.1 + +#Required by: +#zope.security 3.7.4 +#zope.app.pagetemplate 3.11.2 +#zope.publisher 3.12.6 +zope.configuration = 3.7.4 + +#Required by: +#Zope2 2.13.13 +#zope.copypastemove 3.7.0 +#zope.app.container 3.9.2 +#zope.site 3.9.2 +zope.container = 3.11.2 + +#Required by: +#Zope2 2.13.13 +#zope.viewlet 3.7.2 +zope.contentprovider = 3.7.2 + +#Required by: +#Zope2 2.13.13 +zope.contenttype = 3.5.5 + +#Required by: +#zope.copypastemove 3.7.0 +zope.copy = 3.5.0 + +#Required by: +#zope.app.container 3.9.2 +zope.copypastemove = 3.7.0 + +#Required by: +#zope.formlib 4.0.6 +zope.datetime = 3.4.1 + +#Required by: +#Zope2 2.13.13 +zope.deferredimport = 3.5.3 + +#Required by: +#zope.app.component 3.9.3 +zope.deprecation = 3.4.1 + +#Required by: +#Products.ZCatalog 2.13.22 +#zope.container 3.11.2 +#Products.CMFPlone 4.1.5 +#z3c.autoinclude 0.3.4 +zope.dottedname = 3.4.6 + +#Required by: +#zope.app.pagetemplate 3.11.2 +zope.dublincore = 3.7.0 + +#Required by: +#zope.app.publication 3.12.0 +zope.error = 3.7.4 + +#Required by: +#Zope2 2.13.13 +#zope.schema 3.7.1 +#zope.app.container 3.9.2 +#zope.site 3.9.2 +#zope.component 3.9.5 +#zope.publisher 3.12.6 +#zope.formlib 4.0.6 +zope.event = 3.5.1 + +#Required by: +#zope.publisher 3.12.6 +zope.exceptions = 3.6.1 + +#Required by: +#zope.container 3.11.2 +zope.filerepresentation = 3.6.1 + +#Required by: +#zope.app.component 3.9.3 +zope.formlib = 4.0.6 + +#Required by: +#five.globalrequest 1.0 +zope.globalrequest = 1.0 + +#Required by: +#plone.i18n 2.0 +#zope.pagetemplate 3.5.2 +#zope.app.container 3.9.2 +#zope.publisher 3.12.6 +#zope.traversing 3.13.2 +#zope.formlib 4.0.6 +zope.i18n = 3.7.4 + +#Required by: +#zope.security 3.7.4 +#zope.app.component 3.9.3 +#zope.app.pagetemplate 3.11.2 +#zope.traversing 3.13.2 +zope.i18nmessageid = 3.5.3 + +#Required by: +#zope.schema 3.7.1 +#zope.security 3.7.4 +#zope.app.component 3.9.3 +#zope.app.pagetemplate 3.11.2 +#zope.publisher 3.12.6 +#zope.traversing 3.13.2 +zope.interface = 3.6.7 + +#Required by: +#Zope2 2.13.13 +#zope.dublincore 3.7.0 +#zope.app.container 3.9.2 +#zope.site 3.9.2 +#zope.formlib 4.0.6 +zope.lifecycleevent = 3.6.2 + +#Required by: +#Zope2 2.13.13 +#zope.viewlet 3.7.2 +#zope.security 3.7.4 +#zope.publisher 3.12.6 +#Products.CMFPlone 4.1.5 +zope.location = 3.9.1 + +#Required by: +#Zope2 2.13.13 +#zope.ptresource 3.9.0 +#Products.CMFPlone 4.1.5 +zope.pagetemplate = 3.5.2 + +#Required by: +#Zope2 2.13.13 +zope.processlifetime = 1.0 + +#Required by: +#Zope2 2.13.13 +#zope.publisher 3.12.6 +#zope.traversing 3.13.2 +zope.proxy = 3.6.1 + +#Required by: +#Zope2 2.13.13 +zope.ptresource = 3.9.0 + +#Required by: +#Zope2 2.13.13 +#zope.viewlet 3.7.2 +#zope.traversing 3.13.2 +#Products.CMFPlone 4.1.5 +zope.publisher = 3.12.6 + +#Required by: +#plone.memoize 1.1.1 +#plone.app.upgrade 1.1.6 +#plone.app.controlpanel 2.1.4 +zope.ramcache = 1.0 + +#Required by: +#zope.security 3.7.4 +#zope.app.component 3.9.3 +#zope.app.pagetemplate 3.11.2 +zope.schema = 3.7.1 + +#Required by: +#zope.traversing 3.13.2 +zope.security = 3.7.4 + +#Required by: +#Zope2 2.13.13 +zope.sendmail = 3.7.4 + +#Required by: +#Zope2 2.13.13 +zope.sequencesort = 3.4.0 + +#Required by: +#Zope2 2.13.13 +#Products.CMFPlone 4.1.5 +#zope.app.component 3.9.3 +zope.site = 3.9.2 + +#Required by: +#Zope2 2.13.13 +#zope.app.container 3.9.2 +#zope.app.pagetemplate 3.11.2 +zope.size = 3.4.1 + +#Required by: +#Zope2 2.13.13 +zope.structuredtext = 3.5.1 + +#Required by: +#Zope2 2.13.13 +#zope.tales 3.5.1 +#zope.pagetemplate 3.5.2 +zope.tal = 3.5.2 + +#Required by: +#zope.app.pagetemplate 3.11.2 +zope.tales = 3.5.1 + +#Required by: +#Zope2 2.13.13 +zope.testbrowser = 3.11.1 + +#Required by: +#Zope2 2.13.13 +zope.testing = 3.9.7 + +#Required by: +#Zope2 2.13.13 +#zope.viewlet 3.7.2 +#Products.CMFPlone 4.1.5 +#zope.app.component 3.9.3 +#zope.app.pagetemplate 3.11.2 +zope.traversing = 3.13.2 + +#Required by: +#Zope2 2.13.13 +zope.viewlet = 3.7.2 From f0bfc7a2873540e6e0cb531adfc93983d4470dc5 Mon Sep 17 00:00:00 2001 From: Danilo Dellaquila Date: Sun, 22 Jul 2012 09:12:52 +0200 Subject: [PATCH 3/3] Update documentation: procesos_de_documentacion.rst MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add section `Subir la documentación a un sitio web Plone`, also it nukes some trailing whitespace. --- source/procesos_de_documentacion.rst | 92 +++++++++++++++++++++++----- 1 file changed, 78 insertions(+), 14 deletions(-) diff --git a/source/procesos_de_documentacion.rst b/source/procesos_de_documentacion.rst index a541471..22578ed 100644 --- a/source/procesos_de_documentacion.rst +++ b/source/procesos_de_documentacion.rst @@ -9,18 +9,18 @@ Procesos de documentación Obtener y compilar la documentación =================================== -El almacenamiento de este material está disponible en un repositorio Git -`collective.spanishdocumentation`_ en la cuenta de `collective`_ en GitHub.com. -Si usted tiene una credenciales en este servidor y desea convertirse en +El almacenamiento de este material está disponible en un repositorio Git +`collective.spanishdocumentation`_ en la cuenta de `collective`_ en GitHub.com. +Si usted tiene una credenciales en este servidor y desea convertirse en un colaborador ejecute el siguiente comando: .. code-block:: sh $ git clone git@github.com:collective/collective.spanishdocumentation.git collective.spanishdocumentation -Si usted no tiene las credenciales de acceso al repositorio Git -`collective.spanishdocumentation`_ en la cuenta de `collective`_ -en GitHub.com o simplemente solo desea obtener y compilar esta +Si usted no tiene las credenciales de acceso al repositorio Git +`collective.spanishdocumentation`_ en la cuenta de `collective`_ +en GitHub.com o simplemente solo desea obtener y compilar esta documentación ejecute el siguiente comando: .. code-block:: sh @@ -46,7 +46,7 @@ Ahora puede generar la documentación de HTML, con los siguiente comandos: (sphinx)$ ./bin/buildout -vN (sphinx)$ ./bin/sphinx -Ahora se puede abrir ``collective.spanishdocumentation/build/html/index.html`` desde +Ahora se puede abrir ``collective.spanishdocumentation/build/html/index.html`` desde su navegador Web favorito. Para obtener la documentación en PDF: @@ -57,7 +57,7 @@ Para obtener la documentación en PDF: (sphinx)$ make latex (sphinx)$ make latexpdf -Ahora se puede abrir ``collective.spanishdocumentation/sphinx/build/latex/DocumentacionEspanolPlone.pdf`` +Ahora se puede abrir ``collective.spanishdocumentation/sphinx/build/latex/DocumentacionEspanolPlone.pdf`` con sus programas de visor de PDF favorito (Evince, Acrobat Reader, ...) @@ -70,8 +70,8 @@ En primer lugar, debe aprender los `fundamentos de Sphinx`_ que es un reStructur Codificación de caracteres ========================== -Su editor debe codificar el texto en **utf-8** si le gusta lo que está leyendo. -Si su editor de texto favorito no reconoce esta codificación +Su editor debe codificar el texto en **utf-8** si le gusta lo que está leyendo. +Si su editor de texto favorito no reconoce esta codificación (en la actualidad, eso es bien extraño), entonces cambie de editor de texto. .. admonition:: @@ -125,7 +125,7 @@ editores. Para mantener la coherencia nosotros adoptamos la siguiente convenció Sección del nivel 7 +++++++++++++++++++ -No es necesario ni deseable ir más allá del nivel 4. Cuando la generación del +No es necesario ni deseable ir más allá del nivel 4. Cuando la generación del documento allá completado, el nivel de las secciones básicas de un archivo depende del nivel de anidamiento del archivo en la estructura general de documento. Para generar el HTML, no es un problema, pero en LaTeX limita @@ -146,7 +146,7 @@ unitarias no deben mostrar ningún error, compruebe en primer lugar: Imágenes ======== -Aparte de las capturas de pantalla - ¡Uy, lo siento - las capturas de pantalla!, +Aparte de las capturas de pantalla - ¡Uy, lo siento - las capturas de pantalla!, las imágenes Sphinx se inserta en el documento debe ir acompañada de su versión "Fuente" en un formato público interoperables, y para que el editor pueda abrir el archivo fuente que este disponible. Las imágenes deben estar preferentemente en el formato @@ -188,9 +188,71 @@ Algunas de las herramientas recomendadas Emacs : usted puede agregar a emacs el módulo `rst.el `_ -que añade un par de comandos y la sintaxis de la documentación a los escritores +que añade un par de comandos y la sintaxis de la documentación a los escritores simpatizantes de Sphinx y reStructuredText. +Subir la documentación a un sitio web Plone +=========================================== + +Esta documentación se puede subir a un sitio web Plone gracias al +programa `funnelweb`_. A continuación se demuestra como hacerlo en +nuestro entorno de desarrollo. + +Antes de todo hay que iniciar el servidor y crear un sitio Plone. + +.. code-block:: sh + + (sphinx)$ cd collective.spanishdocumentation/ + (sphinx)$ ./bin/instance start + +1. Navegue a su instancia visitando http://localhost:8080 en su navegador web. + Si usted estableció otro puerto, use ese en vez del *8080*. +2. Haga clic en "Create a new Plone site" (Crear un nuevo sitio Plone) e + introduzca su información de inicio de sesión para comenzar a usar Plone. +3. Introduzca la información requerida, en nuestro caso usaremos el nombre **Plone**, + luego envíe el formulario para finalizar la creación de su sitio. +4. Usted puede ahora encontrar su sitio en http://localhost:8080/Plone. +5. Ahora debe agregar una nueva carpeta llamada *Documentación* en la raiz del sitio + en la que añadiremos la documentación en html creada con Sphinx. + +El sitio Plone está ahora listo para recibir la documentación, para hacerlo +simplemente hay que ejecutar el script ``toplone``. + +.. code-block:: sh + + (sphinx)$ ./bin/toplone + +Configuración de funnelweb +-------------------------- + +Es posible configurar el programa `funnelweb`_ editando el +fichero ``pipeline.cfg``. + +Por ejemplo, para subir la documentación en otra carpeta llamada +*Manuales* o para usar un nombre de usuario y contraseña diferentes, +puede cambiar la opción de configuración ``ploneupload:target`` +editando el fichero ``pipeline.cfg`` de esta manera:: + + # Upload to Plone Development Server + [ploneupload] + target=http://administrador:mitesoro@localhost:8080/Plone/manuales + +También puede resultar utíl hacer unas pruebas subiendo sólo algunas +paginas en vez de toda la documentación, por eso hay que descomentar +la opción ``crawler:max``:: + + [crawler] + max=10 + +Puede encontrar más información acerca de la configuración de funnelweb +en la pagina http://pypi.python.org/pypi/funnelweb. + +.. note:: + + Al cambiar el fichero ``pipeline.cfg`` NO es necesario volver + ejecutar el ``buildout``, de hacerlo se perderían eventuales + modificaciones ya que buildout genera el fichero de + configuración a partir de la plantilla ``pipeline.in``. FAQ === @@ -199,10 +261,11 @@ FAQ no se actualiza cuando compilo el documento. **Respuesta :** El índice de Sphinx es a veces es desorientado y la gestión de la dependencia -a veces, mejor. Por lo tanto, todo se debe reiniciar ejecutando el comando ``make clean`` +a veces, mejor. Por lo tanto, todo se debe reiniciar ejecutando el comando ``make clean`` dentro del directorio ``collective.spanishdocumentation/sphinx/build/``. +.. links: .. _collective.spanishdocumentation: https://github.com/collective/collective.spanishdocumentation .. _collective: https://github.com/collective/ .. _fundamentos de Sphinx: http://sphinx.pocoo.org/contents.html @@ -212,3 +275,4 @@ dentro del directorio ``collective.spanishdocumentation/sphinx/build/``. .. _Zope documentation: http://docs.zope.org/zope2/index.html .. _Plone Developer Documentation: http://collective-docs.plone.org/ .. _D\:YAML documentation: http://dyaml.alwaysdata.net/static/html/doc_0.4/index.html +.. _`funnelweb`: http://plone.org/products/funnelweb/