# SOME DESCRIPTIVE TITLE.
# Copyright (C) Kovid Goyal
# This file is distributed under the same license as the calibre package.
# 
# Translators:
msgid ""
msgstr ""
"Project-Id-Version: calibre\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2017-01-27 09:16+0530\n"
"PO-Revision-Date: 2017-01-27 03:47+0000\n"
"Last-Translator: Kovid Goyal <kovid@kovidgoyal.net>\n"
"Language-Team: Welsh (http://www.transifex.com/calibre/calibre/language/cy/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: cy\n"
"Plural-Forms: nplurals=4; plural=(n==1) ? 0 : (n==2) ? 1 : (n != 8 && n != 11) ? 2 : 3;\n"

#: ../../home/kovid/work/calibre/manual/server.rst:4
msgid "Integrating the calibre content server into other servers"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:6
msgid ""
"Here, we will show you how to integrate the calibre content server into "
"another server. The most common reason for this is to make use of SSL or "
"more sophisticated authentication. There are two main techniques: Running "
"the calibre content server as a standalone process and using a reverse proxy"
" to connect it with your main server or running the content server in "
"process in your main server with WSGI. The examples below are all for Apache"
" 2.x on linux, but should be easily adaptable to other platforms."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:0
msgid "Contents"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:12
msgid "This only applies to calibre releases >= 0.7.25"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:15
msgid "Using a reverse proxy"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:17
msgid ""
"A reverse proxy is when your normal server accepts incoming requests and "
"passes them onto the calibre server. It then reads the response from the "
"calibre server and forwards it to the client. This means that you can simply"
" run the calibre server as normal without trying to integrate it closely "
"with your main server, and you can take advantage of whatever authentication"
" systems your main server has in place. This is the simplest approach as it "
"allows you to use the binary calibre install with no external "
"dependencies/system integration requirements. Below, is an example of how to"
" achieve this with Apache as your main server, but it will work with any "
"server that supports Reverse Proxies."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:19
msgid "First start the calibre content server as shown below::"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:23
msgid ""
"The key parameter here is ``--url-prefix /calibre``. This causes the content"
" server to serve all URLs prefixed by calibre. To see this in action, visit "
"``http://localhost:8080/calibre`` in your browser. You should see the normal"
" content server website, but now it will run under /calibre."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:25
msgid ""
"Now suppose you are using Apache as your main server. First enable the proxy"
" modules in apache, by adding the following to :file:`httpd.conf`::"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:30
msgid ""
"The exact technique for enabling the proxy modules will vary depending on "
"your Apache installation. Once you have the proxy modules enabled, add the "
"following rules to httpd.conf (or if you are using virtual hosts to the conf"
" file for the virtual host in question)::"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:38
msgid ""
"That's all, you will now be able to access the calibre Content Server under "
"the /calibre URL in your apache server. The above rules pass all requests "
"under /calibre to the calibre server running on port 8080 and thanks to the "
"--url-prefix option above, the calibre server handles them transparently."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:40
msgid ""
"If you are willing to devote an entire VirtualHost to the content server, "
"then there is no need to use --url-prefix and RewriteRule, instead just use "
"the ProxyPass directive."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:42
msgid ""
"The server engine calibre uses, CherryPy, can have trouble with proxying and"
" KeepAlive requests, so turn them off in Apache, with the SetEnv directives "
"shown above."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:45
msgid "In process"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:47
msgid ""
"The calibre content server can be run directly, in process, inside a host "
"server like Apache using the WSGI framework."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:49
msgid ""
"For this to work, all the dependencies needed by calibre must be installed "
"on your system. Doing so is highly non-trivial and you are encouraged not to"
" use in process servers. You will not get any assistance with debugging in "
"process server problems."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:51
msgid ""
"First, we have to create a WSGI *adapter* for the calibre content server. "
"Here is a template you can use for the purpose. Replace the paths as "
"directed in the comments"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:101
msgid ""
"Save this adapter as :file:`calibre-wsgi-adpater.py` somewhere your server "
"will have access to it."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:103
msgid ""
"Let's suppose that we want to use WSGI in Apache. First enable WSGI in "
"Apache by adding the following to :file:`httpd.conf`::"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:107
msgid ""
"The exact technique for enabling the wsgi module will vary depending on your"
" Apache installation. Once you have the proxy modules enabled, add the "
"following rules to httpd.conf (or if you are using virtual hosts to the conf"
" file for the virtual host in question::"
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:111
msgid ""
"Change the path to :file:`calibre-wsgi-adapter.py` to wherever you saved it "
"previously (make sure Apache has access to it)."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:113
msgid ""
"That's all, you will now be able to access the calibre Content Server under "
"the /calibre URL in your apache server."
msgstr ""

#: ../../home/kovid/work/calibre/manual/server.rst:115
msgid ""
"For more help with using mod_wsgi in Apache, see `mod_wsgi "
"<https://code.google.com/p/modwsgi/wiki/WhereToGetHelp>`_."
msgstr ""
