Download as
Browse Code »

Commit 1258626ff1c4cc43aaa7d8b9f8fe50da83afb8bd

Authored by Sergio Oliveira
2 parents 133f0c6d 1d9ed4d3
Exists in master and in 39 other branches 1.12.x, add_requests_as_dep, celery_service, change-passwd-signal, check-port, colab-signals, colab-vcard, colab_search, colab_tag, colab_tag_merge, community_association, detach_super_archives, fix-dashboard, fix-message-preview, fix_app_label, fix_cache_count_spb, fix_header, fixed_gitlab_import, go_to_profile_panel, header_footer, layout-fix, mobile_user_scalable, move_out_plugins, paginate-threads, profile_integration, refactor-data-import, remove-gitlab-plugin, removing_namespace, search_block, search_filters, spb-release/3.0, split_screen, stable, startplugin, timestamp_plugins, translation_review, user_regex, validate-passwd, workin_whoosh_temp

Merge pull request #1 from Conectivo/master 

Added Spanish l10n and Sphinx docs
Showing 13 changed files with 1392 additions and 59 deletions   Show diff stats
  1 +*~
1 *.log 2 *.log
2 *.pot 3 *.pot
3 *.pyc 4 *.pyc
  5 +*.pyo
4 local_settings.py 6 local_settings.py
5 7
6 *.swp 8 *.swp
@@ -8,6 +8,37 @@ @@ -8,6 +8,37 @@
8 Colab, a Software for Communities 8 Colab, a Software for Communities
9 ================================= 9 =================================
10 10
  11 +What is Colab?
  12 +==============
  13 +
  14 +Application that integrates existing systems to represent the contributions of the members through:
  15 +
  16 +* The amendments to the Wiki trac system.
  17 +
  18 +* Changes to the trac system code.
  19 +
  20 +* Discussions at the mailman list.
  21 +
  22 +* And other systems in the community.
  23 +
  24 +Features
  25 +========
  26 +
  27 +* Developerd by Interlegis Communities http://colab.interlegis.leg.br/
  28 +
  29 +* Writed with Python http://python.org/
  30 +
  31 +* Build in Django Web Framework https://www.djangoproject.com/
  32 +
  33 +* Search engine with Solr https://lucene.apache.org/solr/
  34 +
  35 +Colab and Solr
  36 +==============
  37 +
  38 +This software uses Apache Solr as search platform based on Apache Lucene.
  39 +
  40 +With Solr generates the REST style API with which you can make HTTP requests
  41 +to get results: natively in XML or JSON, PHP, Ruby and Python and then treatment.
11 42
12 Installation 43 Installation
13 ============ 44 ============
@@ -15,81 +46,80 @@ Installation @@ -15,81 +46,80 @@ Installation
15 Installation instructions for Ubuntu 10.04 46 Installation instructions for Ubuntu 10.04
16 ------------------------------------------- 47 -------------------------------------------
17 48
18 -* Install Apache2 with WSGI support: 49 +* Install Apache2 with WSGI support: ::
19 50
20 - * apt-get install apache2 libapache2-mod-wsgi 51 + sudo apt-get install apache2 libapache2-mod-wsgi
21 52
22 -* Install dependencies to compile psycopg2: 53 +* Install dependencies to compile psycopg2: ::
23 54
24 - * apt-get build-dep python-psycopg2 55 + sudo apt-get build-dep python-psycopg2
25 56
26 -* Install Python PIP and update it:  
27 -  
28 - * apt-get install python-pip  
29 - * pip install -U pip 57 +* Install Python PIP and update it: ::
30 58
31 -* Install python virtualenv:  
32 -  
33 - * pip install virtualenv 59 + sudo apt-get install python-pip
  60 + sudo pip install -U pip
  61 +
  62 +* Install python virtualenv: ::
34 63
35 -* Create a virtualenv for the deploy 64 + sudo pip install virtualenv
  65 +
  66 +* Create a virtualenv for the deploy ::
36 67
37 - * mkdir /usr/local/django/  
38 - * virtualenv /usr/local/django/colab/ 68 + sudo mkdir /usr/local/django/
  69 + sudo virtualenv /usr/local/django/colab/
39 70
40 -* Download the colab src code: 71 +* Download the colab ``src`` code: ::
41 72
42 - * hg clone https://bitbucket.org/seocam/atu-colab /usr/local/src/colab/ 73 + sudo hg clone https://bitbucket.org/seocam/atu-colab /usr/local/src/colab/
43 74
44 -* Install the django site: 75 +* Install the django site: ::
45 76
46 - * pip install /usr/local/src/colab -E /usr/local/django/colab/ 77 + sudo pip install /usr/local/src/colab -E /usr/local/django/colab/
47 78
48 -* Configure your database settings in /usr/local/django/colab/lib/python2.6/site-packages/settings_local.py 79 +* Configure your database settings in ``/usr/local/django/colab/lib/python2.6/site-packages/settings_local.py``
49 80
50 -* Enable the colab site on apache and reload it: 81 +* Enable the colab site on apache and reload it: ::
51 82
52 - * ln -s /usr/local/django/colab/apache-site/colab /etc/apache2/sites-available  
53 - * a2ensite colab  
54 - * service apache2 restart  
55 - 83 + sudo ln -s /usr/local/django/colab/apache-site/colab /etc/apache2/sites-available
  84 + sudo a2ensite colab
  85 + sudo service apache2 restart
56 86
57 Configuring server to send emails 87 Configuring server to send emails
58 ---------------------------------- 88 ----------------------------------
59 89
60 -* Install postfix and mailutils:  
61 -  
62 - * apt-get install mailutils postfix 90 +* Install postfix and mailutils: ::
  91 +
  92 + sudo apt-get install mailutils postfix
63 93
64 -* Update the file /etc/aliases adding users that should receive root's messages and run the update command: 94 +* Update the file ``/etc/aliases`` adding users that should receive root's messages and run the update command: ::
65 95
66 - * newaliases 96 + sudo newaliases
67 97
68 98
69 Cron job to import emails 99 Cron job to import emails
70 --------------------------- 100 ---------------------------
71 101
72 -* Install sshfs:  
73 -  
74 - * apt-get install sshfs autofs  
75 -  
76 -* Create SSH keys. You should use a password but this tutorial won't cover it (if you use you will need to install and configure keychain process to be able to proceed): 102 +* Install sshfs: ::
77 103
78 - * ssh-keygen  
79 -  
80 -* Copy the content of your key (/root/.ssh/id_rsa.pub) to the file /root/.ssh/authorized_keys on the mailinglist server. 104 + sudo apt-get install sshfs autofs
81 105
82 -* Append the following content to /etc/auto.master file: 106 +* Create SSH keys. You should use a password but this tutorial won't cover it (if you use you will need to install and configure keychain process to be able to proceed): ::
83 107
84 - * /usr/local/django/colab/mnt /usr/local/django/colab/autofs/listas --timeout=600,--ghost 108 + sudo ssh-keygen
85 109
86 -* Restart autofs: 110 +* Copy the content of your key (``/root/.ssh/id_rsa.pub``) to the file ``/root/.ssh/authorized_keys`` on the mailinglist server.
87 111
88 - * service autofs restart 112 +* Append the following content to /etc/auto.master file: ::
  113 +
  114 + sudo /usr/local/django/colab/mnt /usr/local/django/colab/autofs/listas --timeout=600,--ghost
  115 +
  116 +* Restart autofs: ::
  117 +
  118 + service autofs restart
89 119
90 -* Link cron script into /etc/cron.d/ folder: 120 +* Link cron script into ``/etc/cron.d/`` folder: ::
91 121
92 - * ln -s /usr/local/django/colab/cron.d/colab_import_emails /etc/cron.d/ 122 + ln -s /usr/local/django/colab/etc/cron.d/colab_import_emails /etc/cron.d/
93 123
94 * From now on the emails should be imported every minute 124 * From now on the emails should be imported every minute
95 125
@@ -97,24 +127,24 @@ Cron job to import emails @@ -97,24 +127,24 @@ Cron job to import emails
97 Cron job to reindex Solr 127 Cron job to reindex Solr
98 ------------------------- 128 -------------------------
99 129
100 -* Install wget:  
101 -  
102 - * apt-get install wget  
103 -  
104 -* Link cron script into /etc/cron.d/ folder:  
105 -  
106 - * ln -s /usr/local/django/colab/cron.d/colab_solr_reindex /etc/cron.d/  
107 - 130 +* Install wget: ::
  131 +
  132 + sudo apt-get install wget
  133 +
  134 +* Link cron script into ``/etc/cron.d/`` folder: ::
  135 +
  136 + sudo ln -s /usr/local/django/colab/etc/cron.d/colab_solr_reindex /etc/cron.d/
  137 +
108 * From now on delta reindex should run every 10 minutes and full reindex once a day. 138 * From now on delta reindex should run every 10 minutes and full reindex once a day.
109 139
110 140
111 Updating an installed version 141 Updating an installed version
112 ------------------------------ 142 ------------------------------
113 143
114 -* Update the source code:  
115 -  
116 - * cd /usr/local/src/colab/  
117 - * hg pull  
118 - * hg up  
119 - * pip install /usr/local/src/colab/ -E /usr/local/django/colab/ -U  
120 - * service apache2 restart 144 +* Update the source code: ::
  145 +
  146 + sudo cd /usr/local/src/colab/
  147 + sudo hg pull
  148 + sudo hg up
  149 + sudo pip install /usr/local/src/colab/ -E /usr/local/django/colab/ -U
  150 + sudo service apache2 restart
docs/Makefile 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,177 @@ @@ -0,0 +1,177 @@
  1 +# Makefile for Sphinx documentation
  2 +#
  3 +
  4 +# You can set these variables from the command line.
  5 +SPHINXOPTS =
  6 +SPHINXBUILD = sphinx-build
  7 +PAPER =
  8 +BUILDDIR = _build
  9 +
  10 +# User-friendly check for sphinx-build
  11 +ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
  12 +$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
  13 +endif
  14 +
  15 +# Internal variables.
  16 +PAPEROPT_a4 = -D latex_paper_size=a4
  17 +PAPEROPT_letter = -D latex_paper_size=letter
  18 +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
  19 +# the i18n builder cannot share the environment and doctrees with the others
  20 +I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
  21 +
  22 +.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
  23 +
  24 +help:
  25 + @echo "Please use \`make <target>' where <target> is one of"
  26 + @echo " html to make standalone HTML files"
  27 + @echo " dirhtml to make HTML files named index.html in directories"
  28 + @echo " singlehtml to make a single large HTML file"
  29 + @echo " pickle to make pickle files"
  30 + @echo " json to make JSON files"
  31 + @echo " htmlhelp to make HTML files and a HTML help project"
  32 + @echo " qthelp to make HTML files and a qthelp project"
  33 + @echo " devhelp to make HTML files and a Devhelp project"
  34 + @echo " epub to make an epub"
  35 + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
  36 + @echo " latexpdf to make LaTeX files and run them through pdflatex"
  37 + @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
  38 + @echo " text to make text files"
  39 + @echo " man to make manual pages"
  40 + @echo " texinfo to make Texinfo files"
  41 + @echo " info to make Texinfo files and run them through makeinfo"
  42 + @echo " gettext to make PO message catalogs"
  43 + @echo " changes to make an overview of all changed/added/deprecated items"
  44 + @echo " xml to make Docutils-native XML files"
  45 + @echo " pseudoxml to make pseudoxml-XML files for display purposes"
  46 + @echo " linkcheck to check all external links for integrity"
  47 + @echo " doctest to run all doctests embedded in the documentation (if enabled)"
  48 +
  49 +clean:
  50 + rm -rf $(BUILDDIR)/*
  51 +
  52 +html:
  53 + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
  54 + @echo
  55 + @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
  56 +
  57 +dirhtml:
  58 + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
  59 + @echo
  60 + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
  61 +
  62 +singlehtml:
  63 + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
  64 + @echo
  65 + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
  66 +
  67 +pickle:
  68 + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
  69 + @echo
  70 + @echo "Build finished; now you can process the pickle files."
  71 +
  72 +json:
  73 + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
  74 + @echo
  75 + @echo "Build finished; now you can process the JSON files."
  76 +
  77 +htmlhelp:
  78 + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
  79 + @echo
  80 + @echo "Build finished; now you can run HTML Help Workshop with the" \
  81 + ".hhp project file in $(BUILDDIR)/htmlhelp."
  82 +
  83 +qthelp:
  84 + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
  85 + @echo
  86 + @echo "Build finished; now you can run "qcollectiongenerator" with the" \
  87 + ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
  88 + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/ColabSoftwareDocumentation.qhcp"
  89 + @echo "To view the help file:"
  90 + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/ColabSoftwareDocumentation.qhc"
  91 +
  92 +devhelp:
  93 + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
  94 + @echo
  95 + @echo "Build finished."
  96 + @echo "To view the help file:"
  97 + @echo "# mkdir -p $$HOME/.local/share/devhelp/ColabSoftwareDocumentation"
  98 + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/ColabSoftwareDocumentation"
  99 + @echo "# devhelp"
  100 +
  101 +epub:
  102 + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
  103 + @echo
  104 + @echo "Build finished. The epub file is in $(BUILDDIR)/epub."
  105 +
  106 +latex:
  107 + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  108 + @echo
  109 + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
  110 + @echo "Run \`make' in that directory to run these through (pdf)latex" \
  111 + "(use \`make latexpdf' here to do that automatically)."
  112 +
  113 +latexpdf:
  114 + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  115 + @echo "Running LaTeX files through pdflatex..."
  116 + $(MAKE) -C $(BUILDDIR)/latex all-pdf
  117 + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
  118 +
  119 +latexpdfja:
  120 + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
  121 + @echo "Running LaTeX files through platex and dvipdfmx..."
  122 + $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
  123 + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
  124 +
  125 +text:
  126 + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
  127 + @echo
  128 + @echo "Build finished. The text files are in $(BUILDDIR)/text."
  129 +
  130 +man:
  131 + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
  132 + @echo
  133 + @echo "Build finished. The manual pages are in $(BUILDDIR)/man."
  134 +
  135 +texinfo:
  136 + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
  137 + @echo
  138 + @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
  139 + @echo "Run \`make' in that directory to run these through makeinfo" \
  140 + "(use \`make info' here to do that automatically)."
  141 +
  142 +info:
  143 + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
  144 + @echo "Running Texinfo files through makeinfo..."
  145 + make -C $(BUILDDIR)/texinfo info
  146 + @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
  147 +
  148 +gettext:
  149 + $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
  150 + @echo
  151 + @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
  152 +
  153 +changes:
  154 + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
  155 + @echo
  156 + @echo "The overview file is in $(BUILDDIR)/changes."
  157 +
  158 +linkcheck:
  159 + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
  160 + @echo
  161 + @echo "Link check complete; look for any errors in the above output " \
  162 + "or in $(BUILDDIR)/linkcheck/output.txt."
  163 +
  164 +doctest:
  165 + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
  166 + @echo "Testing of doctests in the sources finished, look at the " \
  167 + "results in $(BUILDDIR)/doctest/output.txt."
  168 +
  169 +xml:
  170 + $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
  171 + @echo
  172 + @echo "Build finished. The XML files are in $(BUILDDIR)/xml."
  173 +
  174 +pseudoxml:
  175 + $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
  176 + @echo
  177 + @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
docs/_static/logo_small.png 0 → 100644
View file @1258626

2.95 KB
docs/about.rst 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,35 @@ @@ -0,0 +1,35 @@
  1 +.. -*- coding: utf-8 -*-
  2 +
  3 +.. highlight:: rest
  4 +
  5 +.. _colab_software:
  6 +
  7 +What is Colab?
  8 +==============
  9 +
  10 +Application that integrates existing systems to represent the contributions of the members through:
  11 +
  12 +* The amendments to the Wiki trac system.
  13 +
  14 +* Changes to the trac system code.
  15 +
  16 +* Discussions at the mailman list.
  17 +
  18 +* And other systems in the community.
  19 +
  20 +Features
  21 +--------
  22 +
  23 +* Developerd by Interlegis Communities http://colab.interlegis.leg.br/
  24 +
  25 +* Writed with Python http://python.org/
  26 +
  27 +* Build in Django Web Framework https://www.djangoproject.com/
  28 +
  29 +* Search engine with Solr https://lucene.apache.org/solr/
  30 +
  31 +Integration with Solr
  32 +---------------------
  33 +
  34 +This software uses Apache Solr as search platform based on Apache Lucene.
  35 +
docs/conf.py 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,306 @@ @@ -0,0 +1,306 @@
  1 +# -*- coding: utf-8 -*-
  2 +#
  3 +# Colab Software documentation build configuration file, created by
  4 +# sphinx-quickstart on Mon Oct 14 15:16:49 2013.
  5 +#
  6 +# This file is execfile()d with the current directory set to its containing dir.
  7 +#
  8 +# Note that not all possible configuration values are present in this
  9 +# autogenerated file.
  10 +#
  11 +# All configuration values have a default; values that are commented out
  12 +# serve to show the default.
  13 +
  14 +import sys, os
  15 +
  16 +# If extensions (or modules to document with autodoc) are in another directory,
  17 +# add these directories to sys.path here. If the directory is relative to the
  18 +# documentation root, use os.path.abspath to make it absolute, like shown here.
  19 +#sys.path.insert(0, os.path.abspath('.'))
  20 +
  21 +# -- General configuration -----------------------------------------------------
  22 +
  23 +# If your documentation needs a minimal Sphinx version, state it here.
  24 +#needs_sphinx = '1.0'
  25 +
  26 +# Add any Sphinx extension module names here, as strings. They can be extensions
  27 +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
  28 +extensions = ['sphinx.ext.autodoc', 'sphinx.ext.todo', 'sphinx.ext.coverage']
  29 +
  30 +# Add any paths that contain templates here, relative to this directory.
  31 +templates_path = ['_templates']
  32 +
  33 +# The suffix of source filenames.
  34 +source_suffix = '.rst'
  35 +
  36 +# The encoding of source files.
  37 +#source_encoding = 'utf-8-sig'
  38 +
  39 +# The master toctree document.
  40 +master_doc = 'index'
  41 +
  42 +# General information about the project.
  43 +project = u'Colab Software'
  44 +copyright = u'2013, Leonardo J. Caballero G.'
  45 +
  46 +# The version info for the project you're documenting, acts as replacement for
  47 +# |version| and |release|, also used in various other places throughout the
  48 +# built documents.
  49 +#
  50 +# The short X.Y version.
  51 +version = '0.1'
  52 +# The full version, including alpha/beta/rc tags.
  53 +release = '0.1'
  54 +
  55 +# The language for content autogenerated by Sphinx. Refer to documentation
  56 +# for a list of supported languages.
  57 +#language = None
  58 +
  59 +# There are two options for replacing |today|: either, you set today to some
  60 +# non-false value, then it is used:
  61 +#today = ''
  62 +# Else, today_fmt is used as the format for a strftime call.
  63 +#today_fmt = '%B %d, %Y'
  64 +
  65 +# List of patterns, relative to source directory, that match files and
  66 +# directories to ignore when looking for source files.
  67 +exclude_patterns = ['_build']
  68 +
  69 +# The reST default role (used for this markup: `text`) to use for all documents.
  70 +#default_role = None
  71 +
  72 +# If true, '()' will be appended to :func: etc. cross-reference text.
  73 +#add_function_parentheses = True
  74 +
  75 +# If true, the current module name will be prepended to all description
  76 +# unit titles (such as .. function::).
  77 +#add_module_names = True
  78 +
  79 +# If true, sectionauthor and moduleauthor directives will be shown in the
  80 +# output. They are ignored by default.
  81 +#show_authors = False
  82 +
  83 +# The name of the Pygments (syntax highlighting) style to use.
  84 +pygments_style = 'sphinx'
  85 +
  86 +# A list of ignored prefixes for module index sorting.
  87 +#modindex_common_prefix = []
  88 +
  89 +# If true, keep warnings as "system message" paragraphs in the built documents.
  90 +#keep_warnings = False
  91 +
  92 +
  93 +# -- Options for HTML output ---------------------------------------------------
  94 +
  95 +# The theme to use for HTML and HTML Help pages. See the documentation for
  96 +# a list of builtin themes.
  97 +html_theme = 'default'
  98 +
  99 +# Theme options are theme-specific and customize the look and feel of a theme
  100 +# further. For a list of options available for each theme, see the
  101 +# documentation.
  102 +#html_theme_options = {}
  103 +
  104 +# Add any paths that contain custom themes here, relative to this directory.
  105 +#html_theme_path = []
  106 +
  107 +# The name for this set of Sphinx documents. If None, it defaults to
  108 +# "<project> v<release> documentation".
  109 +#html_title = None
  110 +
  111 +# A shorter title for the navigation bar. Default is the same as html_title.
  112 +#html_short_title = None
  113 +
  114 +# The name of an image file (relative to this directory) to place at the top
  115 +# of the sidebar.
  116 +#html_logo = None
  117 +
  118 +# The name of an image file (within the static path) to use as favicon of the
  119 +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32
  120 +# pixels large.
  121 +#html_favicon = None
  122 +
  123 +# Add any paths that contain custom static files (such as style sheets) here,
  124 +# relative to this directory. They are copied after the builtin static files,
  125 +# so a file named "default.css" will overwrite the builtin "default.css".
  126 +html_static_path = ['_static']
  127 +
  128 +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
  129 +# using the given strftime format.
  130 +#html_last_updated_fmt = '%b %d, %Y'
  131 +
  132 +# If true, SmartyPants will be used to convert quotes and dashes to
  133 +# typographically correct entities.
  134 +#html_use_smartypants = True
  135 +
  136 +# Custom sidebar templates, maps document names to template names.
  137 +#html_sidebars = {}
  138 +
  139 +# Additional templates that should be rendered to pages, maps page names to
  140 +# template names.
  141 +#html_additional_pages = {}
  142 +
  143 +# If false, no module index is generated.
  144 +#html_domain_indices = True
  145 +
  146 +# If false, no index is generated.
  147 +#html_use_index = True
  148 +
  149 +# If true, the index is split into individual pages for each letter.
  150 +#html_split_index = False
  151 +
  152 +# If true, links to the reST sources are added to the pages.
  153 +#html_show_sourcelink = True
  154 +
  155 +# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
  156 +#html_show_sphinx = True
  157 +
  158 +# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.
  159 +#html_show_copyright = True
  160 +
  161 +# If true, an OpenSearch description file will be output, and all pages will
  162 +# contain a <link> tag referring to it. The value of this option must be the
  163 +# base URL from which the finished HTML is served.
  164 +#html_use_opensearch = ''
  165 +
  166 +# This is the file name suffix for HTML files (e.g. ".xhtml").
  167 +#html_file_suffix = None
  168 +
  169 +# Output file base name for HTML help builder.
  170 +htmlhelp_basename = 'ColabSoftwareDocumentationdoc'
  171 +
  172 +
  173 +# -- Options for LaTeX output --------------------------------------------------
  174 +
  175 +latex_elements = {
  176 +# The paper size ('letterpaper' or 'a4paper').
  177 +#'papersize': 'letterpaper',
  178 +
  179 +# The font size ('10pt', '11pt' or '12pt').
  180 +#'pointsize': '10pt',
  181 +
  182 +# Additional stuff for the LaTeX preamble.
  183 +#'preamble': '',
  184 +}
  185 +
  186 +# Grouping the document tree into LaTeX files. List of tuples
  187 +# (source start file, target name, title, author, documentclass [howto/manual]).
  188 +latex_documents = [
  189 + ('index', 'ColabSoftwareDocumentation.tex', u'Colab Software',
  190 + u'Leonardo J. Caballero G.', 'manual'),
  191 +]
  192 +
  193 +# The name of an image file (relative to this directory) to place at the top of
  194 +# the title page.
  195 +#latex_logo = None
  196 +
  197 +# For "manual" documents, if this is true, then toplevel headings are parts,
  198 +# not chapters.
  199 +#latex_use_parts = False
  200 +
  201 +# If true, show page references after internal links.
  202 +#latex_show_pagerefs = False
  203 +
  204 +# If true, show URL addresses after external links.
  205 +#latex_show_urls = False
  206 +
  207 +# Documents to append as an appendix to all manuals.
  208 +#latex_appendices = []
  209 +
  210 +# If false, no module index is generated.
  211 +#latex_domain_indices = True
  212 +
  213 +
  214 +# -- Options for manual page output --------------------------------------------
  215 +
  216 +# One entry per manual page. List of tuples
  217 +# (source start file, name, description, authors, manual section).
  218 +man_pages = [
  219 + ('index', 'colabsoftwaredocumentation', u'Colab Software',
  220 + [u'Leonardo J. Caballero G.'], 1)
  221 +]
  222 +
  223 +# If true, show URL addresses after external links.
  224 +#man_show_urls = False
  225 +
  226 +
  227 +# -- Options for Texinfo output ------------------------------------------------
  228 +
  229 +# Grouping the document tree into Texinfo files. List of tuples
  230 +# (source start file, target name, title, author,
  231 +# dir menu entry, description, category)
  232 +texinfo_documents = [
  233 + ('index', 'ColabSoftwareDocumentation', u'Colab Software',
  234 + u'Leonardo J. Caballero G.', 'ColabSoftwareDocumentation', 'One line description of project.',
  235 + 'Miscellaneous'),
  236 +]
  237 +
  238 +# Documents to append as an appendix to all manuals.
  239 +#texinfo_appendices = []
  240 +
  241 +# If false, no module index is generated.
  242 +#texinfo_domain_indices = True
  243 +
  244 +# How to display URL addresses: 'footnote', 'no', or 'inline'.
  245 +#texinfo_show_urls = 'footnote'
  246 +
  247 +# If true, do not generate a @detailmenu in the "Top" node's menu.
  248 +#texinfo_no_detailmenu = False
  249 +
  250 +
  251 +# -- Options for Epub output ---------------------------------------------------
  252 +
  253 +# Bibliographic Dublin Core info.
  254 +epub_title = u'Colab Software Documentation'
  255 +epub_author = u'Leonardo J. Caballero G.'
  256 +epub_publisher = u'Leonardo J. Caballero G.'
  257 +epub_copyright = u'2013, Leonardo J. Caballero G.'
  258 +
  259 +# The language of the text. It defaults to the language option
  260 +# or en if the language is not set.
  261 +#epub_language = ''
  262 +
  263 +# The scheme of the identifier. Typical schemes are ISBN or URL.
  264 +#epub_scheme = ''
  265 +
  266 +# The unique identifier of the text. This can be a ISBN number
  267 +# or the project homepage.
  268 +#epub_identifier = ''
  269 +
  270 +# A unique identification for the text.
  271 +#epub_uid = ''
  272 +
  273 +# A tuple containing the cover image and cover page html template filenames.
  274 +#epub_cover = ()
  275 +
  276 +# A sequence of (type, uri, title) tuples for the guide element of content.opf.
  277 +#epub_guide = ()
  278 +
  279 +# HTML files that should be inserted before the pages created by sphinx.
  280 +# The format is a list of tuples containing the path and title.
  281 +#epub_pre_files = []
  282 +
  283 +# HTML files shat should be inserted after the pages created by sphinx.
  284 +# The format is a list of tuples containing the path and title.
  285 +#epub_post_files = []
  286 +
  287 +# A list of files that should not be packed into the epub file.
  288 +#epub_exclude_files = []
  289 +
  290 +# The depth of the table of contents in toc.ncx.
  291 +#epub_tocdepth = 3
  292 +
  293 +# Allow duplicate toc entries.
  294 +#epub_tocdup = True
  295 +
  296 +# Fix unsupported image types using the PIL.
  297 +#epub_fix_images = False
  298 +
  299 +# Scale large images.
  300 +#epub_max_image_width = 0
  301 +
  302 +# If 'no', URL addresses will not be shown.
  303 +#epub_show_urls = 'inline'
  304 +
  305 +# If false, no index is generated.
  306 +#epub_use_index = True
docs/index.rst 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,25 @@ @@ -0,0 +1,25 @@
  1 +.. Colab Software documentation master file, created by
  2 + sphinx-quickstart on Mon Oct 14 15:16:49 2013.
  3 + You can adapt this file completely to your liking, but it should at least
  4 + contain the root `toctree` directive.
  5 +
  6 +=================================
  7 +Colab, a Software for Communities
  8 +=================================
  9 +
  10 +Contents:
  11 +
  12 +.. toctree::
  13 + :maxdepth: 2
  14 +
  15 + about
  16 + install
  17 +
  18 +
  19 +Indices and tables
  20 +==================
  21 +
  22 +* :ref:`genindex`
  23 +* :ref:`modindex`
  24 +* :ref:`search`
  25 +
docs/install.rst 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,15 @@ @@ -0,0 +1,15 @@
  1 +.. -*- coding: utf-8 -*-
  2 +
  3 +.. highlight:: rest
  4 +
  5 +.. _colab_software_install:
  6 +
  7 +Installation
  8 +============
  9 +
  10 +Colab software can be install in many Linux distros, like these:
  11 +
  12 +.. toctree::
  13 + :maxdepth: 1
  14 +
  15 + ubuntu1004
docs/make.bat 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,242 @@ @@ -0,0 +1,242 @@
  1 +@ECHO OFF
  2 +
  3 +REM Command file for Sphinx documentation
  4 +
  5 +if "%SPHINXBUILD%" == "" (
  6 + set SPHINXBUILD=sphinx-build
  7 +)
  8 +set BUILDDIR=_build
  9 +set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .
  10 +set I18NSPHINXOPTS=%SPHINXOPTS% .
  11 +if NOT "%PAPER%" == "" (
  12 + set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
  13 + set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
  14 +)
  15 +
  16 +if "%1" == "" goto help
  17 +
  18 +if "%1" == "help" (
  19 + :help
  20 + echo.Please use `make ^<target^>` where ^<target^> is one of
  21 + echo. html to make standalone HTML files
  22 + echo. dirhtml to make HTML files named index.html in directories
  23 + echo. singlehtml to make a single large HTML file
  24 + echo. pickle to make pickle files
  25 + echo. json to make JSON files
  26 + echo. htmlhelp to make HTML files and a HTML help project
  27 + echo. qthelp to make HTML files and a qthelp project
  28 + echo. devhelp to make HTML files and a Devhelp project
  29 + echo. epub to make an epub
  30 + echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  31 + echo. text to make text files
  32 + echo. man to make manual pages
  33 + echo. texinfo to make Texinfo files
  34 + echo. gettext to make PO message catalogs
  35 + echo. changes to make an overview over all changed/added/deprecated items
  36 + echo. xml to make Docutils-native XML files
  37 + echo. pseudoxml to make pseudoxml-XML files for display purposes
  38 + echo. linkcheck to check all external links for integrity
  39 + echo. doctest to run all doctests embedded in the documentation if enabled
  40 + goto end
  41 +)
  42 +
  43 +if "%1" == "clean" (
  44 + for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
  45 + del /q /s %BUILDDIR%\*
  46 + goto end
  47 +)
  48 +
  49 +
  50 +%SPHINXBUILD% 2> nul
  51 +if errorlevel 9009 (
  52 + echo.
  53 + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
  54 + echo.installed, then set the SPHINXBUILD environment variable to point
  55 + echo.to the full path of the 'sphinx-build' executable. Alternatively you
  56 + echo.may add the Sphinx directory to PATH.
  57 + echo.
  58 + echo.If you don't have Sphinx installed, grab it from
  59 + echo.http://sphinx-doc.org/
  60 + exit /b 1
  61 +)
  62 +
  63 +if "%1" == "html" (
  64 + %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html
  65 + if errorlevel 1 exit /b 1
  66 + echo.
  67 + echo.Build finished. The HTML pages are in %BUILDDIR%/html.
  68 + goto end
  69 +)
  70 +
  71 +if "%1" == "dirhtml" (
  72 + %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
  73 + if errorlevel 1 exit /b 1
  74 + echo.
  75 + echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
  76 + goto end
  77 +)
  78 +
  79 +if "%1" == "singlehtml" (
  80 + %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
  81 + if errorlevel 1 exit /b 1
  82 + echo.
  83 + echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
  84 + goto end
  85 +)
  86 +
  87 +if "%1" == "pickle" (
  88 + %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
  89 + if errorlevel 1 exit /b 1
  90 + echo.
  91 + echo.Build finished; now you can process the pickle files.
  92 + goto end
  93 +)
  94 +
  95 +if "%1" == "json" (
  96 + %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
  97 + if errorlevel 1 exit /b 1
  98 + echo.
  99 + echo.Build finished; now you can process the JSON files.
  100 + goto end
  101 +)
  102 +
  103 +if "%1" == "htmlhelp" (
  104 + %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
  105 + if errorlevel 1 exit /b 1
  106 + echo.
  107 + echo.Build finished; now you can run HTML Help Workshop with the ^
  108 +.hhp project file in %BUILDDIR%/htmlhelp.
  109 + goto end
  110 +)
  111 +
  112 +if "%1" == "qthelp" (
  113 + %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
  114 + if errorlevel 1 exit /b 1
  115 + echo.
  116 + echo.Build finished; now you can run "qcollectiongenerator" with the ^
  117 +.qhcp project file in %BUILDDIR%/qthelp, like this:
  118 + echo.^> qcollectiongenerator %BUILDDIR%\qthelp\ColabSoftwareDocumentation.qhcp
  119 + echo.To view the help file:
  120 + echo.^> assistant -collectionFile %BUILDDIR%\qthelp\ColabSoftwareDocumentation.ghc
  121 + goto end
  122 +)
  123 +
  124 +if "%1" == "devhelp" (
  125 + %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
  126 + if errorlevel 1 exit /b 1
  127 + echo.
  128 + echo.Build finished.
  129 + goto end
  130 +)
  131 +
  132 +if "%1" == "epub" (
  133 + %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
  134 + if errorlevel 1 exit /b 1
  135 + echo.
  136 + echo.Build finished. The epub file is in %BUILDDIR%/epub.
  137 + goto end
  138 +)
  139 +
  140 +if "%1" == "latex" (
  141 + %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  142 + if errorlevel 1 exit /b 1
  143 + echo.
  144 + echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
  145 + goto end
  146 +)
  147 +
  148 +if "%1" == "latexpdf" (
  149 + %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  150 + cd %BUILDDIR%/latex
  151 + make all-pdf
  152 + cd %BUILDDIR%/..
  153 + echo.
  154 + echo.Build finished; the PDF files are in %BUILDDIR%/latex.
  155 + goto end
  156 +)
  157 +
  158 +if "%1" == "latexpdfja" (
  159 + %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
  160 + cd %BUILDDIR%/latex
  161 + make all-pdf-ja
  162 + cd %BUILDDIR%/..
  163 + echo.
  164 + echo.Build finished; the PDF files are in %BUILDDIR%/latex.
  165 + goto end
  166 +)
  167 +
  168 +if "%1" == "text" (
  169 + %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
  170 + if errorlevel 1 exit /b 1
  171 + echo.
  172 + echo.Build finished. The text files are in %BUILDDIR%/text.
  173 + goto end
  174 +)
  175 +
  176 +if "%1" == "man" (
  177 + %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
  178 + if errorlevel 1 exit /b 1
  179 + echo.
  180 + echo.Build finished. The manual pages are in %BUILDDIR%/man.
  181 + goto end
  182 +)
  183 +
  184 +if "%1" == "texinfo" (
  185 + %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
  186 + if errorlevel 1 exit /b 1
  187 + echo.
  188 + echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
  189 + goto end
  190 +)
  191 +
  192 +if "%1" == "gettext" (
  193 + %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
  194 + if errorlevel 1 exit /b 1
  195 + echo.
  196 + echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
  197 + goto end
  198 +)
  199 +
  200 +if "%1" == "changes" (
  201 + %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
  202 + if errorlevel 1 exit /b 1
  203 + echo.
  204 + echo.The overview file is in %BUILDDIR%/changes.
  205 + goto end
  206 +)
  207 +
  208 +if "%1" == "linkcheck" (
  209 + %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
  210 + if errorlevel 1 exit /b 1
  211 + echo.
  212 + echo.Link check complete; look for any errors in the above output ^
  213 +or in %BUILDDIR%/linkcheck/output.txt.
  214 + goto end
  215 +)
  216 +
  217 +if "%1" == "doctest" (
  218 + %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
  219 + if errorlevel 1 exit /b 1
  220 + echo.
  221 + echo.Testing of doctests in the sources finished, look at the ^
  222 +results in %BUILDDIR%/doctest/output.txt.
  223 + goto end
  224 +)
  225 +
  226 +if "%1" == "xml" (
  227 + %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml
  228 + if errorlevel 1 exit /b 1
  229 + echo.
  230 + echo.Build finished. The XML files are in %BUILDDIR%/xml.
  231 + goto end
  232 +)
  233 +
  234 +if "%1" == "pseudoxml" (
  235 + %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml
  236 + if errorlevel 1 exit /b 1
  237 + echo.
  238 + echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.
  239 + goto end
  240 +)
  241 +
  242 +:end
docs/ubuntu1004.rst 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,174 @@ @@ -0,0 +1,174 @@
  1 +.. -*- coding: utf-8 -*-
  2 +
  3 +.. highlight:: rest
  4 +
  5 +.. _ubuntu1004_install:
  6 +
  7 +Installation instructions for Ubuntu 10.04
  8 +==========================================
  9 +
  10 +.. contents :: :local:
  11 +
  12 +Install Solr and dependencies
  13 +-----------------------------
  14 +
  15 +* Install Java, tomcat, JDBC Postgres drivers (Ubuntu partner repositories must be enabled): ::
  16 +
  17 + sudo apt-get install sun-java6-bin tomcat6 libpg-java
  18 +
  19 +* Download Solr 3.3 and extract it: ::
  20 +
  21 + wget http://archive.apache.org/dist/lucene/solr/3.3.0/apache-solr-3.3.0.tgz
  22 + tar xzf apache-solr-3.3.0.tgz
  23 +
  24 +* Create the directory ``/var/local/lib/solr/`` and give the right permissions: ::
  25 +
  26 + sudo mkdir -p /var/local/lib/solr/
  27 + sudo chown tomcat6:tomcat6 /var/local/lib/solr/
  28 +
  29 +* Copy the solr home example to ``/usr/local/share/``: ::
  30 +
  31 + sudo cp -R apache-solr-3.3.0/example/solr /usr/local/share/
  32 +
  33 +* Create a folder for libs in the solr home: ::
  34 +
  35 + sudo mkdir /usr/local/share/solr/lib/
  36 +
  37 +* Copy Solr libs to libs folder: ::
  38 +
  39 + sudo cp apache-solr-3.3.0/dist/*.jar /usr/local/share/solr/lib/
  40 +
  41 +* Copy Solr distribution to solr home: ::
  42 +
  43 + sudo cp apache-solr-3.3.0/dist/apache-solr-3.3.0.war /usr/local/share/solr/
  44 +
  45 +* Link the JDBC Postgres drivers into the Solr installation: ::
  46 +
  47 + sudo ln -s /usr/share/java/postgresql-jdbc3-8.4.jar /usr/local/share/solr/lib/
  48 +
  49 +* Link configurations to ``/etc`` ::
  50 +
  51 + sudo ln -s /usr/local/share/solr/conf/ /etc/solr
  52 +
  53 +* Copy the configuration files from this folder into ``/etc/solr/``
  54 +
  55 +* Link the ``solr-tomcat.xml`` file in the Tomcat configuration: ::
  56 +
  57 + sudo ln -s /etc/solr/solr-tomcat.xml /etc/tomcat6/Catalina/localhost/solr.xml
  58 +
  59 +* Check ``data-config.xml`` to make sure all information to connect to the databases are right
  60 +
  61 +* Create a ``dataimport.properties`` on ``/etc/solr`` and give write access to ``tomcat6``: ::
  62 +
  63 + sudo touch /etc/solr/dataimport.properties
  64 + sudo chown tomcat6:tomcat6 /etc/solr/dataimport.properties
  65 +
  66 +* Restart tomcat: ::
  67 +
  68 + sudo /etc/init.d/tomcat6 restart
  69 +
  70 +Install Colab and dependencies
  71 +------------------------------
  72 +
  73 +* Install Apache2 with WSGI support: ::
  74 +
  75 + sudo apt-get install apache2 libapache2-mod-wsgi
  76 +
  77 +* Install dependencies to compile psycopg2: ::
  78 +
  79 + sudo apt-get build-dep python-psycopg2
  80 +
  81 +* Install Python PIP and update it: ::
  82 +
  83 + sudo apt-get install python-pip
  84 + sudo pip install -U pip
  85 +
  86 +* Install python virtualenv: ::
  87 +
  88 + sudo pip install virtualenv
  89 +
  90 +* Create a virtualenv for the deploy ::
  91 +
  92 + sudo mkdir /usr/local/django/
  93 + sudo virtualenv /usr/local/django/colab/
  94 +
  95 +* Download the colab ``src`` code: ::
  96 +
  97 + sudo hg clone https://bitbucket.org/seocam/atu-colab /usr/local/src/colab/
  98 +
  99 +* Install the django site: ::
  100 +
  101 + sudo pip install /usr/local/src/colab -E /usr/local/django/colab/
  102 +
  103 +* Configure your database settings in ``/usr/local/django/colab/lib/python2.6/site-packages/settings_local.py``
  104 +
  105 +* Enable the colab site on apache and reload it: ::
  106 +
  107 + sudo ln -s /usr/local/django/colab/apache-site/colab /etc/apache2/sites-available
  108 + sudo a2ensite colab
  109 + sudo service apache2 restart
  110 +
  111 +Configuring server to send emails
  112 +----------------------------------
  113 +
  114 +* Install postfix and mailutils: ::
  115 +
  116 + sudo apt-get install mailutils postfix
  117 +
  118 +* Update the file ``/etc/aliases`` adding users that should receive root's messages and run the update command: ::
  119 +
  120 + sudo newaliases
  121 +
  122 +
  123 +Cron job to import emails
  124 +---------------------------
  125 +
  126 +* Install sshfs: ::
  127 +
  128 + sudo apt-get install sshfs autofs
  129 +
  130 +* Create SSH keys. You should use a password but this tutorial won't cover it (if you use you will need to install and configure keychain process to be able to proceed): ::
  131 +
  132 + sudo ssh-keygen
  133 +
  134 +* Copy the content of your key (``/root/.ssh/id_rsa.pub``) to the file ``/root/.ssh/authorized_keys`` on the mailinglist server.
  135 +
  136 +* Append the following content to /etc/auto.master file: ::
  137 +
  138 + sudo /usr/local/django/colab/mnt /usr/local/django/colab/autofs/listas --timeout=600,--ghost
  139 +
  140 +* Restart autofs: ::
  141 +
  142 + service autofs restart
  143 +
  144 +* Link cron script into ``/etc/cron.d/`` folder: ::
  145 +
  146 + ln -s /usr/local/django/colab/etc/cron.d/colab_import_emails /etc/cron.d/
  147 +
  148 +* From now on the emails should be imported every minute
  149 +
  150 +
  151 +Cron job to reindex Solr
  152 +-------------------------
  153 +
  154 +* Install wget: ::
  155 +
  156 + sudo apt-get install wget
  157 +
  158 +* Link cron script into ``/etc/cron.d/`` folder: ::
  159 +
  160 + sudo ln -s /usr/local/django/colab/etc/cron.d/colab_solr_reindex /etc/cron.d/
  161 +
  162 +* From now on delta reindex should run every 10 minutes and full reindex once a day.
  163 +
  164 +
  165 +Updating an installed version
  166 +------------------------------
  167 +
  168 +* Update the source code: ::
  169 +
  170 + sudo cd /usr/local/src/colab/
  171 + sudo hg pull
  172 + sudo hg up
  173 + sudo pip install /usr/local/src/colab/ -E /usr/local/django/colab/ -U
  174 + sudo service apache2 restart
solr-conf/README
  Diff comments   View file @1258626
@@ -5,7 +5,7 @@ Installation instructions for Ubuntu 10.04 @@ -5,7 +5,7 @@ Installation instructions for Ubuntu 10.04
5 sudo apt-get install sun-java6-bin tomcat6 libpg-java 5 sudo apt-get install sun-java6-bin tomcat6 libpg-java
6 6
7 * Download Solr 3.3 and extract it: 7 * Download Solr 3.3 and extract it:
8 -wget http://ftp.unicamp.br/pub/apache/lucene/solr/3.3.0/apache-solr-3.3.0.tgz 8 +wget http://archive.apache.org/dist/lucene/solr/3.3.0/apache-solr-3.3.0.tgz
9 tar xzf apache-solr-3.3.0.tgz 9 tar xzf apache-solr-3.3.0.tgz
10 10
11 * Create the directory /var/local/lib/solr/ and give the right permissions: 11 * Create the directory /var/local/lib/solr/ and give the right permissions:
src/planet/locale/es/LC_MESSAGES/django.po 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,103 @@ @@ -0,0 +1,103 @@
  1 +# SOME DESCRIPTIVE TITLE.
  2 +# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
  3 +# This file is distributed under the same license as the PACKAGE package.
  4 +# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2013.
  5 +msgid ""
  6 +msgstr ""
  7 +"Project-Id-Version: PACKAGE VERSION\n"
  8 +"Report-Msgid-Bugs-To: \n"
  9 +"POT-Creation-Date: 2013-07-26 11:28-0300\n"
  10 +"PO-Revision-Date: 2013-10-15 23:46-0430\n"
  11 +"Last-Translator: Leonardo J. Caballero G. <leonardocaballero@gmail.com>\n"
  12 +"Language-Team: ES <LL@li.org>\n"
  13 +"Language: es\n"
  14 +"MIME-Version: 1.0\n"
  15 +"Content-Type: text/plain; charset=UTF-8\n"
  16 +"Content-Transfer-Encoding: 8bit\n"
  17 +"Plural-Forms: nplurals=2; plural=(n != 1);\n"
  18 +"X-Generator: Virtaal 0.7.1\n"
  19 +
  20 +#: templates/common/pagination.html:5 templates/common/pagination.html.py:7
  21 +msgid "previous"
  22 +msgstr "anterior"
  23 +
  24 +#: templates/common/pagination.html:31 templates/common/pagination.html:33
  25 +msgid "next"
  26 +msgstr "próximo"
  27 +
  28 +#: templates/feedzilla/_post_template.html:9
  29 +msgid "From"
  30 +msgstr "De"
  31 +
  32 +#: templates/feedzilla/_post_template.html:9
  33 +msgid "on"
  34 +msgstr "en"
  35 +
  36 +#: templates/feedzilla/_post_template.html:17
  37 +msgid "Read original"
  38 +msgstr "Leer original"
  39 +
  40 +#: templates/feedzilla/base.html:6
  41 +msgid "Planet"
  42 +msgstr "Planeta"
  43 +
  44 +#: templates/feedzilla/base.html:15 templates/feedzilla/submit_blog.html:5
  45 +msgid "Submit a blog"
  46 +msgstr "Solicite la inclusión de un blog"
  47 +
  48 +#: templates/feedzilla/base.html:18
  49 +msgid "Tags"
  50 +msgstr "Etiquetas"
  51 +
  52 +#: templates/feedzilla/base.html:22
  53 +msgid "Source Blogs"
  54 +msgstr "Fuente de Blogs"
  55 +
  56 +#: templates/feedzilla/submit_blog.html:8
  57 +msgid ""
  58 +"Thank you. Your application has been accepted and will be reviewed by admin "
  59 +"in the near time."
  60 +msgstr "Gracias. Su solicitud ha sido aceptado y sera revisado por el administrador, lo mas pronto posible."
  61 +
  62 +#: templates/feedzilla/submit_blog.html:10
  63 +msgid "Required fields"
  64 +msgstr "Campos requeridos"
  65 +
  66 +#: templates/feedzilla/submit_blog.html:14
  67 +msgid "Blog Information"
  68 +msgstr "Información del blog"
  69 +
  70 +#: templates/feedzilla/submit_blog.html:15
  71 +msgid "Blog URL"
  72 +msgstr "Dirección URL de Blog"
  73 +
  74 +#: templates/feedzilla/submit_blog.html:16
  75 +msgid "Blog name"
  76 +msgstr "Nombre de blog"
  77 +
  78 +#: templates/feedzilla/submit_blog.html:17
  79 +msgid "Name of author of the blog"
  80 +msgstr "Nombre del autor del blog"
  81 +
  82 +#: templates/feedzilla/submit_blog.html:18
  83 +msgid "Feed URL"
  84 +msgstr "Dirección URL de Feed"
  85 +
  86 +#: templates/feedzilla/submit_blog.html:18
  87 +msgid "You can specify what exactly feed you want submit"
  88 +msgstr ""
  89 +"Usted puede especificar cual feed exactamente usted quiere solicitar su "
  90 +"inclusión"
  91 +
  92 +#: templates/feedzilla/submit_blog.html:19
  93 +msgid "Submit"
  94 +msgstr "Solicite la inclusión de un blog"
  95 +
  96 +#: templates/feedzilla/tag.html:5
  97 +#, python-format
  98 +msgid "Posts with &laquo;%(tag)s&raquo; label"
  99 +msgstr "Envíos con etiqueta &laquo;%(tag)s&raquo;"
  100 +
  101 +#: templates/feedzilla/tag.html:14
  102 +msgid "No posts with such label"
  103 +msgstr "No hay envíos con dicha etiqueta"
src/super_archives/locale/es/LC_MESSAGES/django.po 0 → 100644
  Diff comments   View file @1258626
@@ -0,0 +1,224 @@ @@ -0,0 +1,224 @@
  1 +# colab translation.
  2 +# Copyright (C) 2012, 2013 colab
  3 +# This file is distributed under the same license as the colab package.
  4 +# Leonardo J. Caballero G. <leonardocaballero@gmail.com>, 2012, 2013.
  5 +msgid ""
  6 +msgstr ""
  7 +"Project-Id-Version: colab\n"
  8 +"Report-Msgid-Bugs-To: \n"
  9 +"POT-Creation-Date: 2013-07-18 21:53-0300\n"
  10 +"PO-Revision-Date: 2013-10-14 19:16-0430\n"
  11 +"Last-Translator: Leonardo J. Caballero G. <leonardocaballero@gmail.com>\n"
  12 +"Language-Team: ES <LL@li.org>\n"
  13 +"Language: es\n"
  14 +"MIME-Version: 1.0\n"
  15 +"Content-Type: text/plain; charset=UTF-8\n"
  16 +"Content-Transfer-Encoding: 8bit\n"
  17 +"Plural-Forms: nplurals=2; plural=(n != 1);\n"
  18 +"X-Generator: Virtaal 0.7.1\n"
  19 +
  20 +#: forms.py:18
  21 +msgid "Name"
  22 +msgstr "Nombre"
  23 +
  24 +#: forms.py:19
  25 +msgid "Last name"
  26 +msgstr "Apellido"
  27 +
  28 +#: forms.py:23
  29 +msgid "Institution"
  30 +msgstr "Institución"
  31 +
  32 +#: forms.py:25
  33 +msgid "Role"
  34 +msgstr "Rol"
  35 +
  36 +#: forms.py:26
  37 +msgid "Twitter"
  38 +msgstr "Cuenta Twitter"
  39 +
  40 +#: forms.py:27
  41 +msgid "Facebook"
  42 +msgstr "Cuenta Facebook"
  43 +
  44 +#: forms.py:28
  45 +msgid "Google Talk"
  46 +msgstr "Cuenta Google Talk"
  47 +
  48 +#: forms.py:29
  49 +msgid "Personal Website/Blog"
  50 +msgstr "Sitio Web / Blog personal"
  51 +
  52 +#: models.py:66
  53 +msgid "User Profile"
  54 +msgstr "Perfil de usuario"
  55 +
  56 +#: models.py:67
  57 +msgid "Users Profiles"
  58 +msgstr "Perfiles de usuarios"
  59 +
  60 +#: models.py:100
  61 +msgid "Mailing List"
  62 +msgstr "Lista de correo electrónico"
  63 +
  64 +#: models.py:101
  65 +msgid "The Mailing List where is the thread"
  66 +msgstr "La lista de correo electrónico donde esta el hilo de discusión"
  67 +
  68 +#: models.py:104
  69 +msgid "Latest message"
  70 +msgstr "Últimos mensaje"
  71 +
  72 +#: models.py:105
  73 +msgid "Latest message posted"
  74 +msgstr "Últimos mensajes enviados"
  75 +
  76 +#: models.py:106
  77 +msgid "Score"
  78 +msgstr "Puntuación"
  79 +
  80 +#: models.py:106
  81 +msgid "Thread score"
  82 +msgstr "Puntuación de mensaje"
  83 +
  84 +#: models.py:113
  85 +msgid "Thread"
  86 +msgstr "Hilo"
  87 +
  88 +#: models.py:114
  89 +msgid "Threads"
  90 +msgstr "Hilos"
  91 +
  92 +#: models.py:196
  93 +msgid "Subject"
  94 +msgstr "Asunto"
  95 +
  96 +#: models.py:197
  97 +msgid "Please enter a message subject"
  98 +msgstr "Por favor, ingrese un asunto del mensaje"
  99 +
  100 +#: models.py:200
  101 +msgid "Message body"
  102 +msgstr "Cuerpo de mensaje"
  103 +
  104 +#: models.py:201
  105 +msgid "Please enter a message body"
  106 +msgstr "Por favor, ingrese un cuerpo de contenido del mensaje"
  107 +
  108 +#: models.py:210
  109 +msgid "Message"
  110 +msgstr "Mensaje"
  111 +
  112 +#: models.py:211
  113 +msgid "Messages"
  114 +msgstr "Mensajes"
  115 +
  116 +#: templates/message-list.html:6
  117 +msgid "Discussions"
  118 +msgstr "Discusiones"
  119 +
  120 +#: templates/message-list.html:10
  121 +msgid "Filters"
  122 +msgstr "Filtros"
  123 +
  124 +#: templates/message-list.html:12
  125 +msgid "Sort by"
  126 +msgstr "Ordenado por"
  127 +
  128 +#: templates/message-list.html:14 templates/message-list.html.py:17
  129 +#: templates/message-list.html:27
  130 +msgid "Remove filter"
  131 +msgstr "Remover filtro"
  132 +
  133 +#: templates/message-list.html:16
  134 +msgid "Relevance"
  135 +msgstr "Relevancia"
  136 +
  137 +#: templates/message-list.html:19
  138 +msgid "Recent activity"
  139 +msgstr "Actividad reciente"
  140 +
  141 +#: templates/message-list.html:24
  142 +msgid "Lists"
  143 +msgstr "Listas"
  144 +
  145 +#: templates/message-list.html:41
  146 +msgid "No discussion found"
  147 +msgstr "Sin discusión encontrada"
  148 +
  149 +#: templates/message-list.html:51
  150 +msgid "Previous"
  151 +msgstr "Anterior"
  152 +
  153 +#: templates/message-list.html:55
  154 +msgid "Page"
  155 +msgstr "Página"
  156 +
  157 +#: templates/message-list.html:55
  158 +msgid "of"
  159 +msgstr "de"
  160 +
  161 +#: templates/message-list.html:59
  162 +msgid "Next"
  163 +msgstr "Próxima"
  164 +
  165 +#: templates/message-preview.html:35
  166 +msgid "by"
  167 +msgstr "por"
  168 +
  169 +#: templates/message-preview.html:41
  170 +msgid "anonymous"
  171 +msgstr "anónimo"
  172 +
  173 +#: templates/message-preview.html:47 templates/message-thread.html:59
  174 +msgid "ago"
  175 +msgstr "atrás"
  176 +
  177 +#: templates/message-thread.html:19
  178 +msgid "Anonymous"
  179 +msgstr "Anónimo"
  180 +
  181 +#: templates/message-thread.html:27
  182 +msgid "Vote"
  183 +msgstr "Votar"
  184 +
  185 +#: templates/message-thread.html:31
  186 +msgid "Remove votes"
  187 +msgstr "Remover votos"
  188 +
  189 +#: templates/message-thread.html:47
  190 +msgid "Order by"
  191 +msgstr "Ordenar por"
  192 +
  193 +#: templates/message-thread.html:49
  194 +msgid "Votes"
  195 +msgstr "Votos"
  196 +
  197 +#: templates/message-thread.html:50
  198 +msgid "Date"
  199 +msgstr "Fecha"
  200 +
  201 +#: templates/message-thread.html:55
  202 +msgid "Statistics:"
  203 +msgstr "Estadísticas:"
  204 +
  205 +#: templates/message-thread.html:58
  206 +msgid "started at"
  207 +msgstr "iniciada"
  208 +
  209 +#: templates/message-thread.html:61
  210 +msgid "viewed"
  211 +msgstr "vistos"
  212 +
  213 +#: templates/message-thread.html:62 templates/message-thread.html.py:65
  214 +#: templates/message-thread.html:68
  215 +msgid "times"
  216 +msgstr "veces"
  217 +
  218 +#: templates/message-thread.html:64
  219 +msgid "answered"
  220 +msgstr "respondido"
  221 +
  222 +#: templates/message-thread.html:67
  223 +msgid "voted"
  224 +msgstr "votado"