Commit 4c3b20b3af1d8db16a02a798d8ccb928cb737310
Exists in
master
and in
39 other branches
Merge remote-tracking branch 'upstream/master'
Conflicts: solr-conf/README
Showing
12 changed files
with
1334 additions
and
0 deletions
Show diff stats
.gitignore
README.rst
| ... | ... | @@ -8,6 +8,37 @@ |
| 8 | 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 | 43 | Installation (Development Environment) |
| 13 | 44 | ========================================== | ... | ... |
| ... | ... | @@ -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." | ... | ... |
2.95 KB
| ... | ... | @@ -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 | + | ... | ... |
| ... | ... | @@ -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 | ... | ... |
| ... | ... | @@ -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 | + | ... | ... |
| ... | ... | @@ -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 | ... | ... |
| ... | ... | @@ -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 | ... | ... |
| ... | ... | @@ -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 «%(tag)s» label" | |
| 99 | +msgstr "Envíos con etiqueta «%(tag)s»" | |
| 100 | + | |
| 101 | +#: templates/feedzilla/tag.html:14 | |
| 102 | +msgid "No posts with such label" | |
| 103 | +msgstr "No hay envíos con dicha etiqueta" | ... | ... |
| ... | ... | @@ -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" | ... | ... |