path: root/pot/Communications/bip.pot

# 
# AUTHOR <EMAIL@ADDRESS>, YEAR.
#
msgid ""
msgstr ""
"Project-Id-Version: 0\n"
"POT-Creation-Date: 2014-05-22 13:28-0600\n"
"PO-Revision-Date: 2014-05-22 13:28-0600\n"
"Last-Translator: Automatically generated\n"
"Language-Team: None\n"
"MIME-Version: 1.0\n"
"Content-Type: application/x-publican; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. Tag: title
#, no-c-format
msgid "Installing the <systemitem class=\"daemon\">bip</systemitem> IRC Proxy"
msgstr ""

#. Tag: para
#, no-c-format
msgid "Internet Relay Chat, or IRC, is a venerable and popular way to communicate over the internet. Fedora users can <ulink url=\"https://fedoraproject.org/wiki/Communicating_and_getting_help#IRC_for_interactive_community_support\">get help</ulink> on IRC, and many other open source projects use it to collaborate. IRC is accessed using an <emphasis>IRC Client</emphasis>, and clients are available for almost every platform, including <systemitem class=\"osname\">Windows</systemitem>, <systemitem class=\"osname\">OS X</systemitem>, <systemitem class=\"osname\">Android</systemitem>, <systemitem class=\"osname\">iOS</systemitem>, and of course every Linux distribution."
msgstr ""

#. Tag: indexterm
#, no-c-format
msgid "<primary>bouncer</primary>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "An IRC Proxy, or <firstterm>bouncer</firstterm>, connects to an IRC server just like any other client. Rather than presenting the connection in a chat window, the <application>bouncer</application> relays the connection to other clients. You can connect multiple clients to the same bouncer, allowing conversations to remain uninterrupted as you move between devices. The bouncer also keeps logs, and replays recent conversations when you connect, so you can catch up after being away."
msgstr ""

#. Tag: para
#, no-c-format
msgid "The <systemitem class=\"daemon\">bip</systemitem> is easy to install and configure in Fedora. Follow the instructions below, and you'll be up and running in just a few minutes."
msgstr ""

#. Tag: title
#, no-c-format
msgid "Required Ingredients"
msgstr ""

#. Tag: para
#, no-c-format
msgid "Seperate machines for the IRC proxy and client."
msgstr ""

#. Tag: para
#, no-c-format
msgid "This ingredient is optional; you can use bip on the same system as the client to keep logs, or a persistent IRC session while switching users or logging out. <systemitem class=\"daemon\">bip</systemitem> is most useful when run on a seperate server, and can work on even low power devices like a <hardware arch=\"ARMv6\">Raspberry Pi</hardware> or other ARM device."
msgstr ""

#. Tag: para
#, no-c-format
msgid "An active internet connection."
msgstr ""

#. Tag: para
#, no-c-format
msgid "The <package>bip</package> package."
msgstr ""

#. Tag: para
#, no-c-format
msgid "An IRC Client."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Fedora offers many IRC clients, and the right one is a matter of personal preference. If you are new to IRC, try starting with <application>hexchat</application>."
msgstr ""

#. Tag: para
#, no-c-format
msgid "tcp port 7778 set to forward to your <systemitem class=\"daemon\">bip</systemitem> server."
msgstr ""

#. Tag: para
#, no-c-format
msgid "This is <emphasis>only</emphasis> needed if you want to use the server when outside your home network."
msgstr ""

#. Tag: title
#, no-c-format
msgid "Directions"
msgstr ""

#. Tag: title
#, no-c-format
msgid "Installing and Configuring <systemitem class=\"daemon\">bip</systemitem>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "Install required packages on the server:"
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"            <command>yum install bip</command>\n"
"          "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Use the <application>bipgenconfig</application> utility to generate a configuration file."
msgstr ""

#. Tag: para
#, no-c-format
msgid "In this example, you will configure the <ulink url=\"http://freenode.net/\">freenode</ulink> IRC network. Fedora's IRC channels are on Freenode."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Start <application>bipgenconfig</application> from a terminal."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"              <command>bipgenconfig</command>\n"
"              <computeroutput>\n"
"                # This script will help you build a configuration file\n"
"                # \n"
"                # WARNING: non-advanced mode, some 'expert' options'll be hidden !\n"
"                # \n"
"\n"
"                   1. Set global options\n"
"                   2. Add a new network\n"
"                   3. Add a new user\n"
" \n"
"                   4. View global options\n"
"                   5. View/Edit/Delete networks\n"
"                   6. View/Edit/Delete users\n"
"                   7. Generate a server certificate/key pair\n"
"                   8. Switch to advanced mode\n"
" \n"
"                  10. Exit: store, write configuration and exit\n"
"                  11. Exit without saving\n"
"                  12. Store configuration for later use\n"
"\n"
"                  20. Reset config options\n"
"                  21. Load stored config\n"
"                  22. Parse and load current config (todo)\n"
"\n"
"                  What do you want to do ?\n"
"                </computeroutput>\n"
"              "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Enter the system wide settings dialog by pressing <keycap>1</keycap> and <keycap>Enter</keycap>"
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"                <computeroutput>\n"
"                  * Do you want to enable channel logging ? [Y/n] y\n"
"                  * Do you want to enable system logging ? [Y/n] y\n"
"                  * In which directory do you want logs to be stored ?\n"
"                  [/home/pete/.bip/logs] /var/log/bip/\n"
"                </computeroutput>\n"
"              "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Logging is turned on here, and logs are sent to the system log directory."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Back at the main menu, press <keycap>2</keycap> and <keycap>Enter</keycap> to create a network definition."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>\n"
"                  * Network's name <replaceable>freenode</replaceable>\n"
"                  * Enable SSL for this network ? [y/N] <replaceable>n</replaceable>\n"
"\n"
"                  Adding a new server :\n"
"                  * IRC server's IP address/hostname <replaceable>irc.freenode.net</replaceable>\n"
"                  * IRC server's port [6667] <replaceable>6667</replaceable>\n"
"                  Do you want to add a new server ? [Y/n] <replaceable>n</replaceable>\n"
"              </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "The <function>Add a new user</function> section at option <keycap>3</keycap> is where you configure your user for bip, the connections bip will provide to that user, and the user's accounts on the previously configured networks."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>\n"
"                * User's internal name ? fedorauser\n"
"                Set a password for his bip account: ? Password: \n"
"\n"
"                * User's default IRC nickname fedorauser\n"
"                * User's default IRC username fedorauser\n"
"                * User's default IRC realname Fedora B User\n"
"\n"
"                * Do you want to activate backlog {play back logs} system ?\n"
"                [Y/n] y\n"
"            </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "The options above are for your user account with bip. The password is hashed when stored, and does not appear on the screen when typed."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>\n"
"                Adding a new connection :\n"
"                * Connection name (used by bip only) <replaceable>freenode</replaceable>\n"
"                * Network to connect to freenode\n"
"                * Use default identity ? [Y/n] y\n"
"                * IRC server's password ? <replaceable>fedorauser</replaceable>:<replaceable>freenode-nickserv-password</replaceable>\n"
"            </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "In this section, you have created a <function>connection</function> for the freenode network that was defined in an earlier step. Freenode accepts authentication to a registered nick by a server password like the one in the example. While the configuration file will only be readable by root on the server, this password is stored in plain text."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>           \n"
"                * Follow nicknames changes from clients to use upon\n"
"                reconnection (if false, bip'll use config nickname) [Y/n] n\n"
"                * Ignore nickname change sent by a client (first one only,\n"
"                upon client attach) [Y/n] y\n"
"                * Set nickname to this value when there's no more client\n"
"                attached: fedorauser\n"
"                * Set this away message when there's no more client\n"
"                attached: \n"
"                * Send this raw message upon connection to IRC server \n"
"              </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "These options are set to retain the configured user name as much as possible. It is generally considered good IRC ediquette to avoid adding noise by changing your nick often."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>              \n"
"                Adding a new channel :\n"
"                * Channel name #fedora\n"
"                * Channel key (optional) \n"
"                Do you want to add a new channel ? [Y/n] y\n"
"  \n"
"                Adding a new channel :\n"
"                * Channel name #fedora-docs\n"
"                * Channel key (optional) \n"
"                Do you want to add a new channel ? [Y/n] n\n"
"                Do you want to add a new connection ? [Y/n] n\n"
"              </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "Configure the channels you would like to automatically join, and enter the channel password if required. <systemitem class=\"daemon\">bip</systemitem> will connect to these channels when it starts. If you join additional channels, bip can keep them open for you, but they will not be rejoined if the service is restarted."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Select option <keycap>10</keycap> after reviewing your configuration to save and exit."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "<computeroutput>\n"
"                 Configuration stored in /home/pete/.bip/bipgenconfig.store\n"
"                 Configuration saved in /home/pete/.bip/bip.conf.autogen\n"
"                 1 users defined, 1 networks defined\n"
"                 Configuration has been generated in /home/pete/.bip/bip.conf.autogen\n"
"                 You have to rename all generated files to use them\n"
"             </computeroutput>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "Copy the new configuration file to the appropriate path and set ownership."
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"               <command>\n"
"                 sudo cp /home/fedorauser/.bip/bip.conf.autogen /etc/\n"
"               </command>\n"
"               <command>\n"
"                 sudo chown root:bip /etc/bip.conf\n"
"               </command>\n"
"               <command>\n"
"                 sudo chmod 0640 /etc/bip.conf\n"
"               </command>\n"
"             "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Activate the bip service:"
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"            <command>systemctl start bip</command>\n"
"            <command>systemctl enable bip</command>\n"
"          "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Configure your IRC client to use the bip service."
msgstr ""

#. Tag: para
#, no-c-format
msgid "This example is for <application>HexChat</application>. To configure other clients, refer to that client's documentation."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Launch <application>hexchat</application> and open the Network List by clicking <guimenuitem>Hexchat</guimenuitem> then <guimenuitem>Network List...</guimenuitem>."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Click the <guibutton>Add</guibutton> button in the Network List window."
msgstr ""

#. Tag: para
#, no-c-format
msgid "A new network item is immediately added to the <guilabel>Networks</guilabel>. Type in a name for your network, such as <replaceable>Fedorauser's BIP server</replaceable>."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Click <guibutton>Edit...</guibutton> to enter more details for the connection."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Click <guibutton>Add</guibutton> to add an address for your server. A new entry will immediately be created for editing in the list."
msgstr ""

#. Tag: para
#, no-c-format
msgid "Enter your server's IP address and the port number. It should look something like this:"
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"                  <systemitem class=\"ipaddress\">192.168.1.72</systemitem>/7778\n"
"                "
msgstr ""

#. Tag: para
#, no-c-format
msgid "Enter your bip user information in the <guilabel>Password:</guilabel>. The form is <emphasis>bip_username:bip_connection:bip_user_password</emphasis>. To use the freenode connection from the earlier steps, this would be:"
msgstr ""

#. Tag: screen
#, no-c-format
msgid "\n"
"                  fedorauser:freenode:<replaceable>bip_user_password</replaceable>\n"
"                "
msgstr ""

#. Tag: para
#, no-c-format
msgid "If you choose, checking the box for <guilabel>Connect to this network automatically</guilabel> will configure hexchat to connect to your bouncer every time hexchat is opened."
msgstr ""

#. Tag: title
#, no-c-format
msgid "References"
msgstr ""

#. Tag: para
#, no-c-format
msgid "<ulink url=\"http://example.com\">Upstream Documentation</ulink>"
msgstr ""

#. Tag: para
#, no-c-format
msgid "<ulink url=\"http://example.com/myblog/posts/todays_date\" />"
msgstr ""