Commit 4c3b20b3af1d8db16a02a798d8ccb928cb737310
Exists in
master
and in
13 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,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 (Development Environment) | 43 | Installation (Development Environment) |
13 | ========================================== | 44 | ========================================== |
@@ -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." |
2.95 KB
@@ -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 | + |
@@ -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 |
@@ -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 | + |
@@ -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 |
@@ -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 |
@@ -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 «%(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 @@ | @@ -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" |