docs/locale/tzl/LC_MESSAGES/about/contributing.po
msgid ""
msgstr ""
"Project-Id-Version: tabbycat\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-12-31 10:38-0400\n"
"PO-Revision-Date: 2020-11-18 21:01\n"
"Last-Translator: \n"
"Language-Team: Talossan\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.7.0\n"
"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"X-Crowdin-Project: tabbycat\n"
"X-Crowdin-Project-ID: 364715\n"
"X-Crowdin-Language: tzl\n"
"X-Crowdin-File: /develop/docs/locale/en/LC_MESSAGES/about/contributing.po\n"
"X-Crowdin-File-ID: 1263\n"
"Language: tzl_TZL\n"
#: ../../../CONTRIBUTING.rst:3
msgid "Contributing"
msgstr "crwdns46921:0crwdne46921:0"
#: ../../../CONTRIBUTING.rst:5
msgid "Contributions are welcome, and are greatly appreciated! Every little bit helps, and credit will be given. While at its core Tabbycat is a software project, you do not need to know how to code or use Git in order to help. We welcome feedback and ideas based on your tabbing experience and appreciate suggestions or proposals for how to improve the wording, translation, and design of our interface and documentation."
msgstr "crwdns46923:0crwdne46923:0"
#: ../../../CONTRIBUTING.rst:7
msgid "Feel free to `join our Facebook group <https://www.facebook.com/groups/tabbycat.debate/>`_ if you have any questions about how to get started."
msgstr "crwdns46925:0crwdne46925:0"
#: ../../../CONTRIBUTING.rst:10
msgid "Feedback and ideas"
msgstr "crwdns46927:0crwdne46927:0"
#: ../../../CONTRIBUTING.rst:12
msgid "These can be added as issues in the `GitHub repository <https://github.com/TabbycatDebate/tabbycat/issues>`_; posts in our `Facebook group <https://www.facebook.com/groups/tabbycat.debate/>`_; or as an :ref:`email to the developers <authors>`."
msgstr "crwdns46929:0:ref:crwdne46929:0"
#: ../../../CONTRIBUTING.rst:15
msgid "Bug reports"
msgstr "crwdns46931:0crwdne46931:0"
#: ../../../CONTRIBUTING.rst:17
msgid "Please report bugs by opening a new issue in our `GitHub repository <https://github.com/TabbycatDebate/tabbycat/issues>`_. It is most helpful if you can include:"
msgstr "crwdns46933:0crwdne46933:0"
#: ../../../CONTRIBUTING.rst:19
msgid "How Tabbycat was installed (on Heroku, locally on macOS, `etc.`)"
msgstr "crwdns46935:0crwdne46935:0"
#: ../../../CONTRIBUTING.rst:20
msgid "Any details about your tournament and setup that might be helpful in troubleshooting"
msgstr "crwdns46937:0crwdne46937:0"
#: ../../../CONTRIBUTING.rst:21
msgid "Detailed steps for how to reproduce the bug"
msgstr "crwdns46939:0crwdne46939:0"
#: ../../../CONTRIBUTING.rst:24
msgid "Getting started with development"
msgstr "crwdns46941:0crwdne46941:0"
#: ../../../CONTRIBUTING.rst:26
msgid "To easily test your changes to Tabbycat you probably want a working :ref:`local install <install-local>` (without using Docker)"
msgstr "crwdns46943:0:ref:crwdne46943:0"
#: ../../../CONTRIBUTING.rst:27
msgid "Please submit pull requests for features and bug fixes against `develop` (but not `master`)."
msgstr "crwdns46945:0crwdne46945:0"
#: ../../../CONTRIBUTING.rst:28
msgid "We broadly use the `git-flow workflow <http://danielkummer.github.io/git-flow-cheatsheet/>`_."
msgstr "crwdns46947:0crwdne46947:0"
#: ../../../CONTRIBUTING.rst:29
msgid "We use Django's testing tools — adding unit tests to new features is greatly appreciated"
msgstr "crwdns46949:0crwdne46949:0"
#: ../../../CONTRIBUTING.rst:31
msgid "A number of our tests use `Selenium <http://selenium-python.readthedocs.io>`_ and `ChromeDriver <https://sites.google.com/a/chromium.org/chromedriver/>`_ to simulate in-browser functionality. They will fail if you do not have the Chrome browser and ChromeDriver installed."
msgstr "crwdns46951:0crwdne46951:0"
#: ../../../CONTRIBUTING.rst:33
msgid "A number of extra dependencies are required for running tests, linting, and serving the documentation. These can be installed with::"
msgstr "crwdns46953:0crwdne46953:0"
#: ../../../CONTRIBUTING.rst:37
msgid "Our ``package.json`` provides a convenience command that runs a standard set of development tools simultaneously, such as the Django server and the automatic recompilation with live injecting of javascript and CSS. Once you have set ``USE_WEBPACK_SERVER=True`` in your ``settings_local.py`` you can then run this with::"
msgstr "crwdns46955:0crwdne46955:0"
#: ../../../CONTRIBUTING.rst:42
msgid "Generating test data"
msgstr "crwdns46957:0crwdne46957:0"
#: ../../../CONTRIBUTING.rst:44
msgid "There are management commands to help developers quickly generate data for use in testing, including results and feedback. A list of all commands can be found from ``dj help``, but the most useful in this context are:"
msgstr "crwdns46959:0crwdne46959:0"
#: ../../../CONTRIBUTING.rst:46
msgid "``dj importtournament ( minimal8team | australs24team | bp88team )``, which imports participant data for the 8-team (``minimal8team``), 24-team Australs (``australs24team``) and 88-team BP (``bp88team``) demonstration tournaments respectively."
msgstr "crwdns46961:0crwdne46961:0"
#: ../../../CONTRIBUTING.rst:47
msgid "``dj simulaterounds ROUND [ROUND ROUND ...]``, which simulates all of the rounds specified, generating a draw, an adjudicator allocation and a complete set of random results (but not feedback)."
msgstr "crwdns46963:0crwdne46963:0"
#: ../../../CONTRIBUTING.rst:48
msgid "``dj generatefeedback ROUND [ROUND ROUND ...]``, which randomly generates feedback for all existing debates in the specified rounds."
msgstr "crwdns46965:0crwdne46965:0"
#: ../../../CONTRIBUTING.rst:49
msgid "``dj generateresults ROUND [ROUND ROUND ...]``, which randomly generates results for all existing debates in the specified rounds. (You don't need to run this if you ran ``simulaterounds``, because that already does it.)"
msgstr "crwdns46967:0crwdne46967:0"
#: ../../../CONTRIBUTING.rst:51
msgid "Rounds can be specified by sequence number (``seq``) or abbreviation. You can find more information about each of them by adding ``--help`` after the command name."
msgstr "crwdns46969:0crwdne46969:0"
#: ../../../CONTRIBUTING.rst:54
msgid "Database schema changes"
msgstr "crwdns46971:0crwdne46971:0"
#: ../../../CONTRIBUTING.rst:56
msgid "When adding new features, it may be necessary to modify the database schema to support these new additions. After the changes are made, the migration files made by ``python manage.py makemigrations`` must also be committed. The migration files should also contain methods fill the new fields based on existing data if possible."
msgstr "crwdns46973:0crwdne46973:0"
#: ../../../CONTRIBUTING.rst:58
msgid "Fixture files (found under ``data/fixtures/``) may also need to be updated, which can be done by running the ``migrate_fixtures.py`` script under a unmigrated database, then committing the result. ::"
msgstr "crwdns46975:0crwdne46975:0"
#: ../../../CONTRIBUTING.rst:64
msgid "Style guide"
msgstr "crwdns46977:0crwdne46977:0"
#: ../../../CONTRIBUTING.rst:66
msgid "For the front end interface design there is a style guide available at \"/style/\" once a tournament has been setup."
msgstr "crwdns46979:0crwdne46979:0"
#: ../../../CONTRIBUTING.rst:68
msgid "For python code, we use `flake8 <http://flake8.readthedocs.io>`_ to check for a non-strict series of style rules. Warnings will trigger a Travis CI build to fail. The entire codebase can be checked by using::"
msgstr "crwdns46981:0crwdne46981:0"
#: ../../../CONTRIBUTING.rst:72
msgid "For stylesheets, we use `stylelint <https://stylelint.io>`_. The relevant code can be checked by using::"
msgstr "crwdns46983:0crwdne46983:0"
#: ../../../CONTRIBUTING.rst:76
msgid "For javascript, we use `eslint <http://eslint.org/>`_ to enforce the `standardJS <https://standardjs.com>`_ style and the standard recommendation of the vue plugin for eslint. The relevant code can be checked by using::"
msgstr "crwdns46985:0crwdne46985:0"
#: ../../../CONTRIBUTING.rst:81
msgid "Versioning convention"
msgstr "crwdns46987:0crwdne46987:0"
#: ../../../CONTRIBUTING.rst:83
msgid "Our convention is to increment the minor version whenever we add new functionality, and to increment the major version whenever:"
msgstr "crwdns46989:0crwdne46989:0"
#: ../../../CONTRIBUTING.rst:85
msgid "the database can't be migrated forwards using ``python manage.py migrate --no-input``, or"
msgstr "crwdns46991:0crwdne46991:0"
#: ../../../CONTRIBUTING.rst:86
msgid "there is a major change to how the tournament workflow goes, or"
msgstr "crwdns46993:0crwdne46993:0"
#: ../../../CONTRIBUTING.rst:87
msgid "we make some other change that is, in our opinion, significant enough to warrant a milestone."
msgstr "crwdns46995:0crwdne46995:0"
#: ../../../CONTRIBUTING.rst:89
msgid "We write `data migrations <https://docs.djangoproject.com/en/1.10/topics/migrations/#data-migrations>`_ to allow existing systems to be upgraded easily. However, we don't always support backward database migrations. Our expectation is that long-lived installations keep up with our latest version."
msgstr "crwdns46997:0crwdne46997:0"
#: ../../../CONTRIBUTING.rst:91
msgid "One day, we hope to have a public API in place to facilitate the integration with other debating tournament software, like registration or adjudicator feedback systems. If and when that happens, we'll probably revise this convention to be more in line with `Semantic Versioning <http://semver.org/>`_."
msgstr "crwdns46999:0crwdne46999:0"
#: ../../../CONTRIBUTING.rst:93
msgid "Starting from version 0.7.0, we use cat breeds as the code names for major versions."
msgstr "crwdns47001:0crwdne47001:0"
#: ../../../CONTRIBUTING.rst:96
msgid "Documentation"
msgstr "crwdns47003:0crwdne47003:0"
#: ../../../CONTRIBUTING.rst:98
msgid "Documentation is created using `Sphinx <http://sphinx-doc.org/>`_ and hosted at `Read The Docs <https://readthedocs.org>`_. Pushes to ``develop`` will update the *latest* documentation set, while pushes to ``master`` will update the *stable* documentation set."
msgstr "crwdns47005:0crwdne47005:0"
#: ../../../CONTRIBUTING.rst:100
msgid "To preview the documentation locally, install the development dependencies and then start the server::"
msgstr "crwdns47007:0crwdne47007:0"
#: ../../../CONTRIBUTING.rst:104
msgid "You should then be able to preview the docs at `127.0.0.1:7999 <http://127.0.0.1:7999>`_."
msgstr "crwdns47009:0crwdne47009:0"
#: ../../../CONTRIBUTING.rst:107
msgid "Project structure"
msgstr "crwdns47011:0crwdne47011:0"
#: ../../../CONTRIBUTING.rst:109
msgid "``bin`` contains a number of convenience scripts for starting/stopping Docker, and the webserver/asset pipeline."
msgstr "crwdns47013:0crwdne47013:0"
#: ../../../CONTRIBUTING.rst:110
msgid "``data`` contains the sample data sets and fixtures used to setup demo tournaments and in automated tests respectively"
msgstr "crwdns47015:0crwdne47015:0"
#: ../../../CONTRIBUTING.rst:111
msgid "``docs`` contains our document source files and images (although some are linked from the root directory)"
msgstr "crwdns47017:0crwdne47017:0"
#: ../../../CONTRIBUTING.rst:115
msgid "``tabbycat`` is the main directory containing the Django project"
msgstr "crwdns47019:0crwdne47019:0"
#: ../../../CONTRIBUTING.rst:113
msgid "``locale`` contains translation strings for shared templates (others are in respective app directories)"
msgstr "crwdns47021:0crwdne47021:0"
#: ../../../CONTRIBUTING.rst:114
msgid "``templates`` contains shared html templates, stylesheets, javascript source files, and Vue.js components/mixins."
msgstr "crwdns47023:0crwdne47023:0"
#: ../../../CONTRIBUTING.rst:115
msgid "``utils`` contains shared utilities"
msgstr "crwdns47025:0crwdne47025:0"
#: ../../../CONTRIBUTING.rst:116
msgid "All other folders are the Django apps that contain specific views, models, and templates for functions such as ``draw`` generation/display, or recording ``results``. Each has sub-folders for tests and templates."
msgstr "crwdns47027:0crwdne47027:0"
#: ../../../CONTRIBUTING.rst:117
msgid "In the root directory there are a number of files defining our python and javascript dependencies, core configuration files, and key documents like the ``README``"
msgstr "crwdns47029:0crwdne47029:0"
#: ../../../CONTRIBUTING.rst:120
msgid "Internationalization/Localization"
msgstr "crwdns47031:0crwdne47031:0"
#: ../../../CONTRIBUTING.rst:122
msgid "The `gettext <https://docs.djangoproject.com/en/2.2/topics/i18n/translation/>`_ framework is used to enable the translation of strings in Python files and Django templates. Backend in this context signifies these types of files."
msgstr "crwdns47033:0crwdne47033:0"
#: ../../../CONTRIBUTING.rst:124
msgid "The backend's translation files can be updated from the ``tabbycat`` directory using one or more of the supporting language codes (see settings.py)::"
msgstr "crwdns47035:0crwdne47035:0"
#: ../../../CONTRIBUTING.rst:128
msgid "To do more than one language, just specify ``-l`` multiple times, _e.g._ ``-les -lar``."
msgstr "crwdns47037:0crwdne47037:0"
#: ../../../CONTRIBUTING.rst:130
msgid "These can then be compiled using::"
msgstr "crwdns47039:0crwdne47039:0"
#: ../../../CONTRIBUTING.rst:134
msgid "As it stands Heroku needs the .mo files pre-compiled (see `issue in Heroku Python buildpack <https://github.com/heroku/heroku-buildpack-python/issues/198>`_, so these are committed to Git. Note that the English (``en``) language files should not be compiled; their sole purpose is to provide a source language for `Crowdin <https://crowdin.com/project/tabbycat>`_."
msgstr "crwdns47041:0crwdne47041:0"
#: ../../../CONTRIBUTING.rst:136
msgid "Strings defined in Vue files must similarily be marked with ``gettext`` but must be added manually to ``tabbycat/locale/LANGUAGE_CODE/djangojs.po``, for each language supported. These can then compiled to javascript bundles using::"
msgstr "crwdns47043:0crwdne47043:0"
#: ../../../CONTRIBUTING.rst:141
msgid "These are then also committed to git to save users needing to run `compilejsi18n` during setup. The resulting files are then bundled as part of the npm build task. Updating these translations in development (live-reload) requires the use of the ``cp-i18n`` npm task."
msgstr "crwdns47045:0crwdne47045:0"
#: ../../../CONTRIBUTING.rst:144
msgid "Release checklist"
msgstr "crwdns47047:0crwdne47047:0"
#: ../../../CONTRIBUTING.rst:146
msgid "Check that all migrations have been generated and committed into Git"
msgstr "crwdns47049:0crwdne47049:0"
#: ../../../CONTRIBUTING.rst:147
msgid "Merge translations from the Crowdin pull request and compile messages"
msgstr "crwdns47051:0crwdne47051:0"
#: ../../../CONTRIBUTING.rst:148
msgid "Bump version number in ``docs/conf.py``"
msgstr "crwdns47053:0crwdne47053:0"
#: ../../../CONTRIBUTING.rst:149
msgid "Bump version number and (if applicable) codename in ``tabbycat/settings/core.py``"
msgstr "crwdns47055:0crwdne47055:0"
#: ../../../CONTRIBUTING.rst:150
msgid "Update the main ``CHANGELOG.rst`` file (including release date)"
msgstr "crwdns47057:0crwdne47057:0"
#: ../../../CONTRIBUTING.rst:155
msgid "Check the major current deployment options, including:"
msgstr "crwdns47059:0crwdne47059:0"
#: ../../../CONTRIBUTING.rst:152
msgid "The ``deploy_heroku.py`` script"
msgstr "crwdns47061:0crwdne47061:0"
#: ../../../CONTRIBUTING.rst:153
msgid "The Tabbykitten version"
msgstr "crwdns47063:0crwdne47063:0"
#: ../../../CONTRIBUTING.rst:154
msgid "Docker (macOS, Windows 10*) and Docker Toolbox (Windows 10 Home) methods"
msgstr "crwdns47065:0crwdne47065:0"
#: ../../../CONTRIBUTING.rst:155
msgid "Using Bash and Powershell on Windows"
msgstr "crwdns47067:0crwdne47067:0"
#: ../../../CONTRIBUTING.rst:156
msgid "Using Terminal on macOS (at least test out a fresh install of the npm/pip dependencies)"
msgstr "crwdns47069:0crwdne47069:0"
#: ../../../CONTRIBUTING.rst:157
msgid "Check that the last Travis CI build passed and run the full local test suite (this will include the Selenium tests that are not on Travis)"
msgstr "crwdns47071:0crwdne47071:0"
#: ../../../CONTRIBUTING.rst:158
msgid "Shift remaining issues from the Github Milestone"
msgstr "crwdns47073:0crwdne47073:0"
#: ../../../CONTRIBUTING.rst:159
msgid "Create and finish the release branch as per git-flow"
msgstr "crwdns47075:0crwdne47075:0"
#: ../../../CONTRIBUTING.rst:160
msgid "Ensure the tag is correct (``vX.Y.Z``) and published to GitHub"
msgstr "crwdns47077:0crwdne47077:0"
#: ../../../CONTRIBUTING.rst:161
msgid "Back-merge ``master`` to the ``kitten`` branch"
msgstr "crwdns47079:0crwdne47079:0"
#: ../../../CONTRIBUTING.rst:162
msgid "Back-merge ``develop`` to the in-progress feature branches"
msgstr "crwdns47081:0crwdne47081:0"
#: ../../../CONTRIBUTING.rst:163
msgid "Issue a formal release with change notes on GitHub"
msgstr "crwdns47083:0crwdne47083:0"
#: ../../../CONTRIBUTING.rst:164
msgid "Post change notes on the Facebook page/group"
msgstr "crwdns47085:0crwdne47085:0"