diff --git a/.travis.yml b/.travis.yml index 1d3f316c8f..0130968878 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,12 +1,44 @@ +dist: xenial language: python python: - - 3.6 + - 3.7 sudo: required services: - docker -install: - - make dev-env -script: - - set -e - - make test/docs docs - - make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1" + +jobs: + include: + - stage: diff-test + install: + - pip install --upgrade pip + - make dev-env + script: + - set -e + - if [ $(make n-docs-diff) -ne 0 ]; then make docs; fi; + - if [ $(make n-other-diff) -ne 0 ]; then make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1"; fi; + - stage: push-tx + install: + - pip install --upgrade pip + - make dev-env + script: + - if [ $(make n-docs-diff DIFF_RANGE=$TRAVIS_COMMIT_RANGE) -ne 0 ]; then make tx-en; fi; + - stage: full-test + install: + - pip install --upgrade pip + - make dev-env + script: + - set -e + - make docs + - make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1" + +stages: + - name: diff-test + if: type = pull_request + - name: push-tx + if: type = push AND branch = master + - name: full-test + if: type = cron AND branch = master + +env: + global: + secure: JDQKgB1laaenzmEGI9gduwK/iS0030qsl62njJg3jib0R8wxBi2OeetEdoGl9m4NFsqqnp0OO7nm4rzGfuwjL1A38flSlXOTxhjm/hvo3vmnqVu5lDcdk9+IRkafnfd3Dyd86tLxRVETOqZwCLmdNkB2fmQII8du5IIqbJuUGp8DrG7kVMf3NBr9rjkZRfByQrgG4s1NXuT61VvpWMPJAOhcrImuHBheVJDEV0U3n6Xavd7Wo+pAHrHU8exvYTZ1IzZMbHc6K0iC/NpCHcH9+9DAeLDk/q1aDNqbTExnQevOHZzNqgHC2qFOlN4jfy/TLYLpLXtUismneBBqVSK3iZso3Vqy2BRXWgouI+Tt+08ffocy9XPwEzSwkgPgDlFVUikPOy5imwjpDb13RMIyMY4CKlSOdQx2rH2kPkZ0MJJPcki3KGuGl3qRvqyblMn+lZvjAu6WVLZfo7EtcxsQ0ZZxbAbGoUVl27FHg+UvIfC0I3wEcZIp7oED47Q8s0MdCijD3AwkRPvx/iyp3J0A42su7kkOooFcmUItEIqegQJ4Aki1FBv2i5vHmBobClktytZceLsKvzCeLjMpL9HcUVfUaJDKRwtUYIozpYeBnac+E6J1s6glcqLrXIHWez8N6SzokBa6SPqdtODdzzk5OJupByub6CYWsRXvxIQ7/wI= diff --git a/Makefile b/Makefile index 471e4daea1..960a1d63fa 100644 --- a/Makefile +++ b/Makefile @@ -6,6 +6,7 @@ SHELL:=bash OWNER:=jupyter ARCH:=$(shell uname -m) +DIFF_RANGE?=master...HEAD # Need to list the images in build dependency order ifeq ($(ARCH),ppc64le) @@ -60,8 +61,27 @@ dev-env: ## install libraries required to build docs and run tests docs: ## build HTML documentation make -C docs html -test/docs: ## check links in Sphinx documentation - make -C docs +n-docs-diff: ## number of docs/ files changed since branch from master + @git diff --name-only $(DIFF_RANGE) -- docs/ ':!docs/locale' | wc -l | awk '{print $$1}' + + +n-other-diff: ## number of files outside docs/ changed since branch from master + @git diff --name-only $(DIFF_RANGE) -- ':!docs/' | wc -l | awk '{print $$1}' + +tx-en: ## rebuild en locale strings and push to master (req: GH_TOKEN) + @git config --global user.email "travis@travis-ci.org" + @git config --global user.name "Travis CI" + @git checkout master + + @make -C docs clean gettext + @cd docs && sphinx-intl update -p _build/gettext -l en + + @git add docs/locale/en + @git commit -m "[ci skip] Update en source strings (build: $$TRAVIS_JOB_NUMBER)" + + @git remote add origin-tx https://$${GH_TOKEN}@github.com/jupyter/docker-stacks.git + @git push -u origin-tx master + test/%: ## run tests against a stack @TEST_IMAGE="$(OWNER)/$(notdir $@)" pytest test diff --git a/base-notebook/Dockerfile b/base-notebook/Dockerfile index b25b84e9be..5218bcad5f 100644 --- a/base-notebook/Dockerfile +++ b/base-notebook/Dockerfile @@ -79,6 +79,7 @@ RUN cd /tmp && \ $CONDA_DIR/bin/conda config --system --set show_channel_urls true && \ $CONDA_DIR/bin/conda install --quiet --yes conda="${CONDA_VERSION%.*}.*" && \ $CONDA_DIR/bin/conda update --all --quiet --yes && \ + conda list python | grep '^python ' | tr -s ' ' | cut -d '.' -f 1,2 | sed 's/$/.*/' >> $CONDA_DIR/conda-meta/pinned && \ conda clean --all -f -y && \ rm -rf /home/$NB_USER/.cache/yarn && \ fix-permissions $CONDA_DIR && \ @@ -100,7 +101,7 @@ RUN conda install --quiet --yes 'tini=0.18.0' && \ RUN conda install --quiet --yes \ 'notebook=5.7.8' \ 'jupyterhub=0.9.6' \ - 'jupyterlab=0.35.4' && \ + 'jupyterlab=0.35.5' && \ conda clean --all -f -y && \ jupyter labextension install @jupyterlab/hub-extension@^0.12.0 && \ npm cache clean --force && \ diff --git a/base-notebook/hooks/post_checkout b/base-notebook/hooks/post_checkout new file mode 100644 index 0000000000..b72ed53b68 --- /dev/null +++ b/base-notebook/hooks/post_checkout @@ -0,0 +1,4 @@ +#!/bin/bash +if [[ "$COMMIT_MSG" = *"skip ci"* || "$COMMIT_MSG" = *"ci skip"* ]]; then + exit 1; +fi \ No newline at end of file diff --git a/docs/.tx/config b/docs/.tx/config new file mode 100644 index 0000000000..a047151edc --- /dev/null +++ b/docs/.tx/config @@ -0,0 +1,27 @@ +[main] +host = https://www.transifex.com + +[jupyter-docker-stacks-1.using-po--master] +file_filter = locale//LC_MESSAGES/using.po +source_file = locale/en/LC_MESSAGES/using.po +source_lang = en +type = PO + +[jupyter-docker-stacks-1.maintaining-po--master] +file_filter = locale//LC_MESSAGES/maintaining.po +source_file = locale/en/LC_MESSAGES/maintaining.po +source_lang = en +type = PO + +[jupyter-docker-stacks-1.index-po--master] +file_filter = locale//LC_MESSAGES/index.po +source_file = locale/en/LC_MESSAGES/index.po +source_lang = en +type = PO + +[jupyter-docker-stacks-1.contributing-po--master] +file_filter = locale//LC_MESSAGES/contributing.po +source_file = locale/en/LC_MESSAGES/contributing.po +source_lang = en +type = PO + diff --git a/docs/conf.py b/docs/conf.py index 3d528a0d90..5ecdc278dc 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -52,7 +52,7 @@ # General information about the project. project = 'docker-stacks' -copyright = '2018, Project Jupyter' +copyright = '2018- Project Jupyter' author = 'Project Jupyter' # The version info for the project you're documenting, acts as replacement for @@ -191,7 +191,12 @@ 'Miscellaneous'), ] -# -- Extension configuration ------------------------------------------------- +# -- Extension configuration ---------------------------------------------- # Anchors are often dynamic -linkcheck_anchors = False \ No newline at end of file +linkcheck_anchors = False + +# -- Translation ---------------------------------------------------------- + +gettext_uuid = True +locale_dirs = ['locale/'] \ No newline at end of file diff --git a/docs/contributing/features.md b/docs/contributing/features.md index e8e0f22881..1dca0d2cf9 100644 --- a/docs/contributing/features.md +++ b/docs/contributing/features.md @@ -7,7 +7,7 @@ Thank you for contributing to the Jupyter Docker Stacks! We review pull requests Please follow the process below to suggest a new feature for inclusion in one of the core stacks: 1. [Open a GitHub issue](https://github.com/jupyter/docker-stacks/issues) describing the feature you'd like to contribute. -2. Discuss with the maintainers whether the addition makes sense in [one of the core stacks](../using/selecting.html#Core-Stacks), as a [recipe in the documentation](recipes.html), as a [community stack](stacks.html), or as something else entirely. +2. Discuss with the maintainers whether the addition makes sense in [one of the core stacks](../using/selecting.md#Core-Stacks), as a [recipe in the documentation](recipes.md), as a [community stack](stacks.md), or as something else entirely. ## Selection Criteria diff --git a/docs/contributing/recipes.md b/docs/contributing/recipes.md index 55729f3fcb..ed4172816c 100644 --- a/docs/contributing/recipes.md +++ b/docs/contributing/recipes.md @@ -1,8 +1,8 @@ # New Recipes -We welcome contributions of [recipes](../using/recipes.html), short examples of using, configuring, or extending the Docker Stacks, for inclusion in the documentation site. Follow the process below to add a new recipe: +We welcome contributions of [recipes](../using/recipes.md), short examples of using, configuring, or extending the Docker Stacks, for inclusion in the documentation site. Follow the process below to add a new recipe: 1. Open the `docs/using/recipes.md` source file. -2. Add a second-level Markdown heading naming your recipe at the bottom of the file (e.g., `## Add the RISE extension``) +2. Add a second-level Markdown heading naming your recipe at the bottom of the file (e.g., `## Add the RISE extension`) 3. Write the body of your recipe under the heading, including whatever command line, Dockerfile, links, etc. you need. 4. [Submit a pull request](https://github.com/PointCloudLibrary/pcl/wiki/A-step-by-step-guide-on-preparing-and-submitting-a-pull-request) (PR) with your changes. Maintainers will respond and work with you to address any formatting or content issues. diff --git a/docs/contributing/tests.md b/docs/contributing/tests.md index 61d9235944..c2ff4f358e 100644 --- a/docs/contributing/tests.md +++ b/docs/contributing/tests.md @@ -4,7 +4,7 @@ We greatly appreciate pull requests that extend the automated tests that vet the ## How the Tests Work -Travis executes `make build-test-all` against every pull request submitted to the `jupyter/docker-stacks` repository. The `make` command builds every docker image. After building each image, the `make` command executes `pytest` to run both image-specific tests like those in [base-notebook/test/](https://github.com/jupyter/docker-stacks/tree/master/base-notebook/test) and common tests defined in [test/](https://github.com/jupyter/docker-stacks/tree/master/test). Both kinds of tests make use of global [pytest fixtures](https://docs.pytest.org/en/latest/fixture.html) defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/master/conftest.py) file at the root of the projects. +Travis executes `make build-test-all` against pull requests submitted to the `jupyter/docker-stacks` repository. This `make` command builds every docker image. After building each image, the `make` command executes `pytest` to run both image-specific tests like those in [base-notebook/test/](https://github.com/jupyter/docker-stacks/tree/master/base-notebook/test) and common tests defined in [test/](https://github.com/jupyter/docker-stacks/tree/master/test). Both kinds of tests make use of global [pytest fixtures](https://docs.pytest.org/en/latest/fixture.html) defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/master/conftest.py) file at the root of the projects. ## Contributing New Tests diff --git a/docs/contributing/translations.md b/docs/contributing/translations.md new file mode 100644 index 0000000000..6cc0567390 --- /dev/null +++ b/docs/contributing/translations.md @@ -0,0 +1,7 @@ +# Doc Translations + +We are delighted when members of the Jupyter community want to help translate these documentation pages to other languages. If you're interested, please visit links below below to join our team on [Transifex](https://transifex.com) and to start creating, reviewing, and updating translations of the Jupyter Docker Stacks documentation. + +1. Follow the steps documented on the [Getting Started as a Translator](https://docs.transifex.com/getting-started-1/translators) page. +2. Look for *jupyter-docker-stacks* when prompted to choose a translation team. Alternatively, visit https://www.transifex.com/project-jupyter/jupyter-docker-stacks-1 after creating your account and request to join the project. +3. See [Translating with the Web Editor](https://docs.transifex.com/translation/translating-with-the-web-editor) in the Transifex documentation. \ No newline at end of file diff --git a/docs/index.rst b/docs/index.rst index fd7beb0804..c255a720c4 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -43,9 +43,10 @@ Table of Contents :maxdepth: 2 :caption: Contributor Guide - contributing/issues + contributing/issues contributing/packages contributing/recipes + contributing/translations contributing/tests contributing/features contributing/stacks diff --git a/docs/locale/en/LC_MESSAGES/contributing.po b/docs/locale/en/LC_MESSAGES/contributing.po new file mode 100644 index 0000000000..e084c70e22 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/contributing.po @@ -0,0 +1,675 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks +# package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-05-05 19:53-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.6.0\n" + +# d5ee2bafb9214b8ab9ce05ae9bc2ff43 +#: ../../contributing/features.md:1 +msgid "New Features" +msgstr "" + +# 64c3ecc68ada47afada78f945253c9e9 +#: ../../contributing/features.md:3 +msgid "" +"Thank you for contributing to the Jupyter Docker Stacks! We review pull " +"requests of new features (e.g., new packages, new scripts, new flags) to " +"balance the value of the images to the Jupyter community with the cost of" +" maintaining the images over time." +msgstr "" + +# 5a3b2e0c02d04cd0913b53f5d7f7421d +#: ../../contributing/features.md:5 +msgid "Suggesting a New Feature" +msgstr "" + +# c995f8cabb1d4b4fb53a9c56ae8e017b +#: ../../contributing/features.md:7 +msgid "" +"Please follow the process below to suggest a new feature for inclusion in" +" one of the core stacks:" +msgstr "" + +# 851e3743c7044fa6bec396a46e06937d +#: ../../contributing/features.md:9 +msgid "Open a GitHub issue describing the feature you'd like to contribute." +msgstr "" + +# da218fda29544532b12be50dead6e2d0 +#: ../../contributing/features.md:10 +msgid "" +"Discuss with the maintainers whether the addition makes sense in one of " +"the core stacks, as a recipe in the documentation, as a community stack, " +"or as something else entirely." +msgstr "" + +# 26fa58bfa79f4fe7b7d0294f9f4f934a +#: ../../contributing/features.md:12 +msgid "Selection Criteria" +msgstr "" + +# ca139cf0df684011bdf6f6f68e151796 +#: ../../contributing/features.md:14 +msgid "" +"Roughly speaking, we evaluate new features based on the following " +"criteria:" +msgstr "" + +# 55d41192f6bd4592aa15bf2fca333e4a +#: ../../contributing/features.md:16 +msgid "" +"Usefulness to Jupyter users: Is the feature generally applicable across " +"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, " +"etc.?" +msgstr "" + +# 97f3898d0a1a4ff8afa82de9d30775bc +#: ../../contributing/features.md:17 +msgid "" +"Fit with the image purpose: Does the feature match the theme of the stack" +" in which it will be added? Would it fit better in a new, community " +"stack?" +msgstr "" + +# b4ac38d7ada6485da90e64186d54dc57 +#: ../../contributing/features.md:18 +msgid "" +"Complexity of build / runtime configuration: How many lines of code does " +"the feature require in one of the Dockerfiles or startup scripts? Does it" +" require new scripts entirely? Do users need to adjust how they use the " +"images?" +msgstr "" + +# 811968d07486412bbe8d9533a429e347 +#: ../../contributing/features.md:19 +msgid "" +"Impact on image metrics: How many bytes does the feature and its " +"dependencies add to the image(s)? How many minutes do they add to the " +"build time?" +msgstr "" + +# 48f6c6506d504118972db4cc965ad54b +#: ../../contributing/features.md:20 +msgid "" +"Ability to support the addition: Can existing maintainers answer user " +"questions and address future build issues? Are the contributors " +"interested in helping with long-term maintenance? Can we write tests to " +"ensure the feature continues to work over time?" +msgstr "" + +# 813c0aa67a644056b5ca9b474f2edd94 +#: ../../contributing/features.md:22 +msgid "Submitting a Pull Request" +msgstr "" + +# f7ca9b40be90476eb97c8fcd67205e9d +#: ../../contributing/features.md:24 +msgid "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" +msgstr "" + +# 090e533a7c02452587ee9ae774ffab49 +#: ../../contributing/features.md:26 +msgid "" +"Implement the feature in a local clone of the jupyter/docker-stacks " +"project." +msgstr "" + +# 1532dda80ffb43ffb1617fe628c00809 +#: ../../contributing/features.md:27 +msgid "" +"Please build the image locally before submitting a pull request. Building" +" the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# f054869250084c329c5c24debe355d38 +# bde1ad63b1e04dae9a965862b0146dd9 +# 7cbd48f6b3684c5997ac862300c43899 +#: ../../contributing/features.md:31 ../../contributing/packages.md:13 +#: ../../contributing/tests.md:20 +msgid "Submit a pull request (PR) with your changes." +msgstr "" + +# fa69df66887f47d9a9abcd75fa8a8497 +# 7083b6579dca40a487ab6bd7a21e20eb +# 2fbcbd3f9a63431294360d65dac1734a +#: ../../contributing/features.md:32 ../../contributing/packages.md:14 +#: ../../contributing/tests.md:21 +msgid "" +"Watch for Travis to report a build success or failure for your PR on " +"GitHub." +msgstr "" + +# b6f9117aeb68454aa8a7abca30656eaa +#: ../../contributing/features.md:33 +msgid "Discuss changes with the maintainers and address any build issues." +msgstr "" + +# 42d6a0e44b104e1dbb87efffd722f75f +#: ../../contributing/issues.md:1 +msgid "Project Issues" +msgstr "" + +# 9c2a6e9f67354e86aca23758676fca43 +#: ../../contributing/issues.md:3 +msgid "" +"We appreciate your taking the time to report an issue you encountered " +"using the Jupyter Docker Stacks. Please review the following guidelines " +"when reporting your problem." +msgstr "" + +# 6a629d63e2df4d63a6d46b008639cc37 +#: ../../contributing/issues.md:7 +msgid "" +"If you believe you’ve found a security vulnerability in any of the " +"Jupyter projects included in Jupyter Docker Stacks images, please report " +"it to security@ipython.org, not in the issue trackers on GitHub. If you " +"prefer to encrypt your security reports, you can use this PGP public key." +msgstr "" + +# 530d75c287e542b194e6e6d1f2982ea7 +#: ../../contributing/issues.md:13 +msgid "" +"If you think your problem is unique to the Jupyter Docker Stacks images, " +"please search the jupyter/docker-stacks issue tracker to see if someone " +"else has already reported the same problem. If not, please open a new " +"issue and provide all of the information requested in the issue template." +msgstr "" + +# 69a18cc239b34b94800599bf185f58d6 +#: ../../contributing/issues.md:19 +msgid "" +"If the issue you're seeing is with one of the open source libraries " +"included in the Docker images and is reproducible outside the images, " +"please file a bug with the appropriate open source project." +msgstr "" + +# d60d9c017ea7411499fc4b8844685e8a +#: ../../contributing/issues.md:22 +msgid "" +"If you have a general question about how to use the Jupyter Docker Stacks" +" in your environment, in conjunction with other tools, with " +"customizations, and so on, please post your question on the Jupyter " +"Discourse site." +msgstr "" + +# 92d4aa6314a14654a1bfb74f8768cff7 +#: ../../contributing/packages.md:1 +msgid "Package Updates" +msgstr "" + +# 5f269a667f9a4c3ca342cfb49ecaefb2 +#: ../../contributing/packages.md:3 +msgid "" +"We actively seek pull requests which update packages already included in " +"the project Dockerfiles. This is a great way for first-time contributors " +"to participate in developing the Jupyter Docker Stacks." +msgstr "" + +# 30d4a79bce8d439d97e6e3555a088548 +#: ../../contributing/packages.md:5 +msgid "Please follow the process below to update a package version:" +msgstr "" + +# ba2bf1a38d6d4e42b9cb01d0aceb569f +#: ../../contributing/packages.md:7 +msgid "" +"Locate the Dockerfile containing the library you wish to update (e.g., " +"base-notebook/Dockerfile, scipy-notebook/Dockerfile)" +msgstr "" + +# 837f2edd02f340a7b903654a976afd34 +#: ../../contributing/packages.md:8 +msgid "" +"Adjust the version number for the package. We prefer to pin the major and" +" minor version number of packages so as to minimize rebuild side-effects " +"when users submit pull requests (PRs). For example, you'll find the " +"Jupyter Notebook package, notebook, installed using conda with " +"notebook=5.4.*." +msgstr "" + +# f81a7974c2ea4016b2ba58da4c04be68 +#: ../../contributing/packages.md:9 +msgid "" +"Please build the image locally before submitting a pull request. Building" +" the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 2fb7c7978a604dc9a758890e633913f3 +#: ../../contributing/packages.md:15 +msgid "" +"Discuss changes with the maintainers and address any build issues. " +"Version conflicts are the most common problem. You may need to upgrade " +"additional packages to fix build failures." +msgstr "" + +# 8df94bc571bb4beabe013aab3de18311 +#: ../../contributing/recipes.md:1 +msgid "New Recipes" +msgstr "" + +# 8c8691f0a2734bc78005b61f4b0ab06b +#: ../../contributing/recipes.md:3 +msgid "" +"We welcome contributions of recipes, short examples of using, " +"configuring, or extending the Docker Stacks, for inclusion in the " +"documentation site. Follow the process below to add a new recipe:" +msgstr "" + +# f5d1aba922b64f9783587c8f1d774c61 +#: ../../contributing/recipes.md:5 +msgid "Open the docs/using/recipes.md source file." +msgstr "" + +# 131d0a36cdf64d50b2fa88a9f6aa3db7 +#: ../../contributing/recipes.md:6 +msgid "" +"Add a second-level Markdown heading naming your recipe at the bottom of " +"the file (e.g., ## Add the RISE extension)" +msgstr "" + +# 8838b0ff2be24c23afaca9a6f43a9b66 +#: ../../contributing/recipes.md:7 +msgid "" +"Write the body of your recipe under the heading, including whatever " +"command line, Dockerfile, links, etc. you need." +msgstr "" + +# 31dad868af94494b91992050c12ec1d7 +# ee54777f272048c4919f263f299c5104 +#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111 +msgid "" +"Submit a pull request (PR) with your changes. Maintainers will respond " +"and work with you to address any formatting or content issues." +msgstr "" + +# 27c1019878c14639a9f4b418195821fc +#: ../../contributing/stacks.md:1 +msgid "Community Stacks" +msgstr "" + +# 5e68ee416aa841b1a7cbb957b0180bea +#: ../../contributing/stacks.md:3 +msgid "" +"We love to see the community create and share new Jupyter Docker images. " +"We've put together a cookiecutter project and the documentation below to " +"help you get started defining, building, and sharing your Jupyter " +"environments in Docker. Following these steps will:" +msgstr "" + +# f0bac1d3b53d406896f6d63c93612805 +#: ../../contributing/stacks.md:5 +msgid "" +"Setup a project on GitHub containing a Dockerfile based on either the " +"jupyter/base-notebook or jupyter/minimal-notebook image." +msgstr "" + +# 8fa22b86dc9f4750b0b903371f16c1e6 +#: ../../contributing/stacks.md:6 +msgid "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." +msgstr "" + +# cb04d6b8877b47e78277b7025f642ae3 +#: ../../contributing/stacks.md:7 +msgid "Configure Docker Cloud to build and host your images for others to use." +msgstr "" + +# 2663c2d034934a7b81d81845288eb18c +#: ../../contributing/stacks.md:8 +msgid "" +"Update the list of community stacks in this documentation to include your" +" image." +msgstr "" + +# 8e0fd1dc73cc40ceab19307d0cd809c1 +#: ../../contributing/stacks.md:10 +msgid "" +"This approach mirrors how we build and share the core stack images. Feel " +"free to follow it or pave your own path using alternative services and " +"build tools." +msgstr "" + +# a959f079576b42e7aad7961aa18c711e +#: ../../contributing/stacks.md:12 +msgid "Creating a Project" +msgstr "" + +# b531336cf1e44916934b6439c16e59d8 +#: ../../contributing/stacks.md:14 +msgid "First, install cookiecutter using pip or conda:" +msgstr "" + +# 02a8355204114fedbff0806aa1c0cfe7 +#: ../../contributing/stacks.md:20 +msgid "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." +msgstr "" + +# 676ff068156d4ca7b1043b4a4fe2d1f1 +#: ../../contributing/stacks.md:26 +msgid "" +"Enter a name for your new stack image. This will serve as both the git " +"repository name and the part of the Docker image name after the slash." +msgstr "" + +# 96deffa98bab47da82e5598e549c8a39 +#: ../../contributing/stacks.md:33 +msgid "" +"Enter the user or organization name under which this stack will reside on" +" Docker Cloud / Hub. You must have access to manage this Docker Cloud org" +" in order to push images here and setup automated builds." +msgstr "" + +# b796c2d7c08b4a1db5cdfd3de7d84c16 +#: ../../contributing/stacks.md:41 +msgid "" +"Select an image from the jupyter/docker-stacks project that will serve as" +" the base for your new image." +msgstr "" + +# 7ef9d73286d04b12a1350e8d9565df65 +#: ../../contributing/stacks.md:48 +msgid "Enter a longer description of the stack for your README." +msgstr "" + +# 479d3a5c6ef9481a9dc4033224c540fa +#: ../../contributing/stacks.md:54 +msgid "Initialize your project as a Git repository and push it to GitHub." +msgstr "" + +# 6edd8157d77d472ca6d1306223c91777 +#: ../../contributing/stacks.md:66 +msgid "Configuring Travis" +msgstr "" + +# 38e3784d96f64d7481f0e1fd17aff9cb +#: ../../contributing/stacks.md:68 +msgid "" +"Next, link your GitHub project to Travis CI to build your Docker image " +"whenever you or someone else submits a pull request." +msgstr "" + +# 2c032b71ddcb4495a9f609d9a35aedd7 +#: ../../contributing/stacks.md:70 +msgid "" +"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-" +"with-Travis-CI and follow the instructions to add the Travis CI " +"application to your GitHub account." +msgstr "" + +# 3bbb8357183241f7b5b82c7dd4b94b66 +#: ../../contributing/stacks.md:71 +msgid "Visit https://travis-ci.org." +msgstr "" + +# d6d51a4bd0a54432a6fdd835ff9064c5 +#: ../../contributing/stacks.md:72 +msgid "Click the + symbol at the top of the left sidebar." +msgstr "" + +# ac370ece6fb24becb8034cb994ad8f4b +#: ../../contributing/stacks.md:74 +msgid "" +"Locate your project repository either in your primary user account or in " +"one of the organizations to which you belong." +msgstr "" + +# 6b6a7bab547d4e25bd930009a6a9ea44 +#: ../../contributing/stacks.md:75 +msgid "Click the toggle to enable builds for the project repository." +msgstr "" + +# 78e190712611492fade3d0c8ddded057 +#: ../../contributing/stacks.md:76 +msgid "Click the Settings button for that repository." +msgstr "" + +# f8f7e84ec3754ea6b3641002d4ef764a +#: ../../contributing/stacks.md:78 +msgid "" +"Enable Build only if .travis.yml is present and Build pushed pull " +"requests." +msgstr "" + +# 03ef310b054e4a60aaa09b3b1b14f94c +#: ../../contributing/stacks.md:80 +msgid "Disable Build pushed branches." +msgstr "" + +# 26ed9349e73f4a65b8195acfcada213b +#: ../../contributing/stacks.md:82 +msgid "Configuring Docker Cloud" +msgstr "" + +# f0c01a2906494d039d73324e90cbae44 +#: ../../contributing/stacks.md:84 +msgid "" +"Now, configure Docker Cloud to build your stack image and push it to " +"Docker Hub repository whenever you merge a GitHub pull request to the " +"master branch of your project." +msgstr "" + +# 67de7e2035dc4a329091875f97fb0ee4 +#: ../../contributing/stacks.md:86 +msgid "Visit https://cloud.docker.com/ and login." +msgstr "" + +# f32a2dc2e1ec45b39867be18be6cbd79 +#: ../../contributing/stacks.md:87 +msgid "" +"Select the account or organization matching the one you entered when " +"prompted with stack_org by the cookiecutter." +msgstr "" + +# e6518d4caa3b418abf3ae0c90311dddf +#: ../../contributing/stacks.md:89 +msgid "Scroll to the bottom of the page and click Create repository." +msgstr "" + +# 4763c352de32492c9a843574846adb59 +#: ../../contributing/stacks.md:90 +msgid "" +"Enter the name of the image matching the one you entered when prompted " +"with stack_name by the cookiecutter." +msgstr "" + +# 79092e5007ba4bdead594a71e30cd58a +#: ../../contributing/stacks.md:92 +msgid "Enter a description for your image." +msgstr "" + +# 720800dc73ee497689251633489e09ff +#: ../../contributing/stacks.md:93 +msgid "" +"Click GitHub under the Build Settings and follow the prompts to connect " +"your account if it is not already connected." +msgstr "" + +# e085cfd6d7664d04bcd14ce89f24b75a +#: ../../contributing/stacks.md:94 +msgid "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." +msgstr "" + +# 700a2f14a3df44459dc7c4fb5627dff6 +#: ../../contributing/stacks.md:96 +msgid "Click the Create and Build button." +msgstr "" + +# 90bca72ef3f848c8bcd46aacc3362448 +#: ../../contributing/stacks.md:98 +msgid "Defining Your Image" +msgstr "" + +# fa24b82e07b54a63bf24c3126d9c90b0 +#: ../../contributing/stacks.md:100 +msgid "" +"Make edits the Dockerfile in your project to add third-party libraries " +"and configure Jupyter applications. Refer to the Dockerfiles for the core" +" stacks (e.g., jupyter/datascience-notebook) to get a feel for what's " +"possible and best practices." +msgstr "" + +# 6fd6540df8a64d769f3f0734b976d12e +#: ../../contributing/stacks.md:102 +msgid "" +"Submit pull requests to your project repository on GitHub. Ensure your " +"image builds properly on Travis before merging to master. Refer to Docker" +" Cloud for builds of your master branch that you can docker pull." +msgstr "" + +# ac1f142f0d8745428be05d7ff3549c13 +#: ../../contributing/stacks.md:104 +msgid "Sharing Your Image" +msgstr "" + +# d8e9f1a37f4c4a72bb630e7a3b265b92 +#: ../../contributing/stacks.md:106 +msgid "" +"Finally, if you'd like to add a link to your project to this " +"documentation site, please do the following:" +msgstr "" + +# 200610af72b540c9896d206dd27623e8 +#: ../../contributing/stacks.md:108 +msgid "Clone ths jupyter/docker-stacks GitHub repository." +msgstr "" + +# 7316f6af4b6f44468a68c8890a419aee +#: ../../contributing/stacks.md:109 +msgid "" +"Open the docs/using/selecting.md source file and locate the Community " +"Stacks section." +msgstr "" + +# 9d37dfec6fba48e6966c254b476e1e81 +#: ../../contributing/stacks.md:110 +msgid "" +"Add a bullet with a link to your project and a short description of what " +"your Docker image contains." +msgstr "" + +# 8d835a3452014d62a974286f209f84ce +#: ../../contributing/tests.md:1 +msgid "Image Tests" +msgstr "" + +# 6dbd44985f3c4ba1a3823c90c5944ad0 +#: ../../contributing/tests.md:3 +msgid "" +"We greatly appreciate pull requests that extend the automated tests that " +"vet the basic functionality of the Docker images." +msgstr "" + +# 4642bf6f1d2649c381a13b97b7d29d42 +#: ../../contributing/tests.md:5 +msgid "How the Tests Work" +msgstr "" + +# 8cf4546daeba45a6abd2eb0cd7fc2b73 +#: ../../contributing/tests.md:7 +msgid "" +"Travis executes make build-test-all against pull requests submitted to " +"the jupyter/docker-stacks repository. This make command builds every " +"docker image. After building each image, the make command executes pytest" +" to run both image-specific tests like those in base-notebook/test/ and " +"common tests defined in test/. Both kinds of tests make use of global " +"pytest fixtures defined in the conftest.py file at the root of the " +"projects." +msgstr "" + +# 02fe04b413994b57af9c948cb25ce53d +#: ../../contributing/tests.md:9 +msgid "Contributing New Tests" +msgstr "" + +# d317e6be0fbf487e8528ff1fe0bbdb78 +#: ../../contributing/tests.md:11 +msgid "Please follow the process below to add new tests:" +msgstr "" + +# 5db827e3a1a34a7097fda2c23743116f +#: ../../contributing/tests.md:13 +msgid "" +"If the test should run against every image built, add your test code to " +"one of the modules in test/ or create a new module." +msgstr "" + +# 58c90865c96f43138ec9089b67c7d5ba +#: ../../contributing/tests.md:14 +msgid "" +"If your test should run against a single image, add your test code to one" +" of the modules in some-notebook/test/ or create a new module." +msgstr "" + +# 332e0f9399a54ef4a488a7392a18a2a0 +#: ../../contributing/tests.md:15 +msgid "" +"Build one or more images you intend to test and run the tests locally. If" +" you use make, call:" +msgstr "" + +# 760abcc7be7744858eda5ee0b7be3107 +#: ../../contributing/tests.md:22 +msgid "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." +msgstr "" + +# 3bf94cce9dcd4567b7414c40d7db827c +#: ../../contributing/translations.md:1 +msgid "Doc Translations" +msgstr "" + +# caa387c3e37b492fb588b5d54d9e092f +#: ../../contributing/translations.md:3 +msgid "" +"We are delighted when members of the Jupyter community want to help " +"translate these documentation pages to other languages. If you're " +"interested, please visit links below below to join our team on Transifex " +"and to start creating, reviewing, and updating translations of the " +"Jupyter Docker Stacks documentation." +msgstr "" + +# 78f5029763cc4c3f9c4132202f30b083 +#: ../../contributing/translations.md:5 +msgid "Follow the steps documented on the Getting Started as a Translator page." +msgstr "" + +# 44a72a4bb6934e56b0e3d1eb78280d01 +#: ../../contributing/translations.md:6 +msgid "" +"Look for jupyter-docker-stacks when prompted to choose a translation " +"team. Alternatively, visit https://www.transifex.com/project-jupyter" +"/jupyter-docker-stacks-1 after creating your account and request to join " +"the project." +msgstr "" + +# 24a937946b16417a8bfe6715ea9a9eea +#: ../../contributing/translations.md:7 +msgid "See Translating with the Web Editor in the Transifex documentation." +msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/index.po b/docs/locale/en/LC_MESSAGES/index.po new file mode 100644 index 0000000000..298c468515 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/index.po @@ -0,0 +1,137 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks +# package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-05-05 19:53-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.6.0\n" + +# 22f1bd46933144e092bf92e3af4c6f4f +#: ../../index.rst:32 +msgid "User Guide" +msgstr "" + +# f35d75046f8c42ae8cab58d826154823 +#: ../../index.rst:42 +msgid "Contributor Guide" +msgstr "" + +# a737afe726cd49c4986d75b7d74eeed3 +#: ../../index.rst:54 +msgid "Maintainer Guide" +msgstr "" + +# 9cd216fa91ef40bbb957373faaf93732 +#: ../../index.rst:60 +msgid "Getting Help" +msgstr "" + +# a0aa0bcd999c4c5e96cc57fd77780f96 +#: ../../index.rst:2 +msgid "Jupyter Docker Stacks" +msgstr "" + +# 5d06f458dc524214b2c97e865dd2dc81 +#: ../../index.rst:4 +msgid "" +"Jupyter Docker Stacks are a set of ready-to-run Docker images containing " +"Jupyter applications and interactive computing tools. You can use a stack" +" image to do any of the following (and more):" +msgstr "" + +# c69f151c806e4cdf9bebda05b06c760e +#: ../../index.rst:6 +msgid "Start a personal Jupyter Notebook server in a local Docker container" +msgstr "" + +# b26271409ab743b2a349b3a8ca95233e +#: ../../index.rst:7 +msgid "Run JupyterLab servers for a team using JupyterHub" +msgstr "" + +# 4d60f4325fff4ffcad12703a4b9d6781 +#: ../../index.rst:8 +msgid "Write your own project Dockerfile" +msgstr "" + +# 78b0d31eb6e9462888eef92e6a84cdb7 +#: ../../index.rst:11 +msgid "Quick Start" +msgstr "" + +# d4c0e237dbe74e0d9afbf2b2f0e219c8 +#: ../../index.rst:13 +msgid "" +"You can try a `recent build of the jupyter/base-notebook image on " +"mybinder.org `_ by simply clicking the preceding " +"link. Otherwise, the two examples below may help you get started if you " +"`have Docker installed `_, know " +":doc:`which Docker image ` you want to use, and want to " +"launch a single Jupyter Notebook server in a container." +msgstr "" + +# 051ed23ef62e41058a7c889604f96035 +#: ../../index.rst:15 +msgid "" +"The other pages in this documentation describe additional uses and " +"features in detail." +msgstr "" + +# e91f3b62a1b54166b966be6d7a4f061e +#: ../../index.rst:17 +msgid "" +"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image " +"tagged ``17aba6048f44`` from Docker Hub if it is not already present on " +"the local host. It then starts a container running a Jupyter Notebook " +"server and exposes the server on host port 8888. The server logs appear " +"in the terminal. Visiting ``http://:8888/?token=`` in a " +"browser loads the Jupyter Notebook dashboard page, where ``hostname`` is " +"the name of the computer running docker and ``token`` is the secret token" +" printed in the console. The container remains intact for restart after " +"the notebook server exits.::" +msgstr "" + +# e04140e6cd8442f7a6f347d88224f591 +#: ../../index.rst:21 +msgid "" +"**Example 2:** This command performs the same operations as **Example " +"1**, but it exposes the server on host port 10000 instead of port 8888. " +"Visiting ``http://:10000/?token=`` in a browser loads " +"JupyterLab, where ``hostname`` is the name of the computer running docker" +" and ``token`` is the secret token printed in the console.::" +msgstr "" + +# 1c3229680cf44a5bb2d8450602bfcf7d +#: ../../index.rst:25 +msgid "" +"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` " +"image tagged ``9b06df75e445`` from Docker Hub if it is not already " +"present on the local host. It then starts an *ephemeral* container " +"running a Jupyter Notebook server and exposes the server on host port " +"10000. The command mounts the current working directory on the host as " +"``/home/jovyan/work`` in the container. The server logs appear in the " +"terminal. Visiting ``http://:10000/?token=`` in a " +"browser loads JupyterLab, where ``hostname`` is the name of the computer " +"running docker and ``token`` is the secret token printed in the console. " +"Docker destroys the container after notebook server exit, but any files " +"written to ``~/work`` in the container remain intact on the host.::" +msgstr "" + +# 3ac1a41d185844b1b43315a4cc74efc8 +#: ../../index.rst:30 +msgid "Table of Contents" +msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/maintaining.po b/docs/locale/en/LC_MESSAGES/maintaining.po new file mode 100644 index 0000000000..32221edda3 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/maintaining.po @@ -0,0 +1,373 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks +# package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-05-05 19:53-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.6.0\n" + +# 99bff7d6e014436daac99d7d6c9bccf0 +#: ../../maintaining/tasks.md:1 +msgid "Maintainer Playbook" +msgstr "" + +# 2adfeb6f61a94194b4f2cac30ebd3215 +#: ../../maintaining/tasks.md:3 +msgid "Merging Pull Requests" +msgstr "" + +# 0a04eb6c0525428984f07f3c249f5d73 +#: ../../maintaining/tasks.md:5 +msgid "" +"To build new images on Docker Cloud and publish them to the Docker Hub " +"registry, do the following:" +msgstr "" + +# f2710754a41e4354b51f4acd6f1f9545 +#: ../../maintaining/tasks.md:7 +msgid "Make sure Travis is green for a PR." +msgstr "" + +# db74ca47dfde4e558a20aff52176347a +#: ../../maintaining/tasks.md:8 +msgid "Merge the PR." +msgstr "" + +# 87b2e059678349b38d0badc5404484ec +#: ../../maintaining/tasks.md:9 +msgid "" +"Monitor the Docker Cloud build status for each of the stacks, starting " +"with jupyter/base-notebook and ending with jupyter/all-spark-notebook. " +"See the stack hierarchy diagram for the current, complete build order." +msgstr "" + +# 9149cb3c2bdc48ffa9109b3b6ddcf446 +#: ../../maintaining/tasks.md:10 +msgid "" +"Manually click the retry button next to any build that fails to resume " +"that build and any dependent builds." +msgstr "" + +# d204ada7a14b46338be9b7afb0bc95b0 +#: ../../maintaining/tasks.md:11 +msgid "" +"Try to avoid merging another PR to master until all outstanding builds " +"complete. There's no way at present to propagate the git SHA to build " +"through the Docker Cloud build trigger API. Every build trigger works off" +" of master HEAD." +msgstr "" + +# 9626663d7dc145979f6f75e7aaf7689f +#: ../../maintaining/tasks.md:13 +msgid "Updating the Ubuntu Base Image" +msgstr "" + +# 6951ec7a2be24782bc2f814c5c02978a +#: ../../maintaining/tasks.md:15 +msgid "" +"When there's a security fix in the Ubuntu base image or after some time " +"passes, it's a good idea to update the pinned SHA in the jupyter/base-" +"notebook Dockerfile. Submit it as a regular PR and go through the build " +"process. Expect the build to take a while to complete: every image layer " +"will rebuild." +msgstr "" + +# 37576597a1524fabb0ef175abe29ee8a +#: ../../maintaining/tasks.md:17 +msgid "Adding a New Core Image to Docker Cloud" +msgstr "" + +# 201f0506bbb24b47b79a5db01db86557 +#: ../../maintaining/tasks.md:19 +msgid "" +"When there's a new stack definition, do the following before merging the " +"PR with the new stack:" +msgstr "" + +# 5460275aca4848e297e80aa2d9d4f3ee +#: ../../maintaining/tasks.md:21 +msgid "" +"Ensure the PR includes an update to the stack overview diagram in the " +"documentation. The image links to the blockdiag source used to create it." +msgstr "" + +# 0e3d12dcfb4b42b8a3d24b9401caa757 +#: ../../maintaining/tasks.md:22 +msgid "" +"Ensure the PR updates the Makefile which is used to build the stacks in " +"order on Travis CI." +msgstr "" + +# 4175414ec7e94aab8ae15d02afff0580 +#: ../../maintaining/tasks.md:23 +msgid "" +"Create a new repository in the jupyter org on Docker Cloud named after " +"the stack folder in the git repo." +msgstr "" + +# eb598362707c44adadac8890755936ef +#: ../../maintaining/tasks.md:24 +msgid "Grant the stacks team permission to write to the repo." +msgstr "" + +# 25076c59e0ec4dc28ee2c977d5977216 +#: ../../maintaining/tasks.md:25 +msgid "Click Builds and then Configure Automated Builds for the repository." +msgstr "" + +# 1e5483f6ca3542ea9d43923d8eacf53d +#: ../../maintaining/tasks.md:26 +msgid "Select jupyter/docker-stacks as the source repository." +msgstr "" + +# 157cc21e4a1a4bda80d6e3f8a37c29d7 +#: ../../maintaining/tasks.md:27 +msgid "" +"Choose Build on Docker Cloud's infrastructure using a Small node unless " +"you have reason to believe a bigger host is required." +msgstr "" + +# 36c9c49d610a4e32b024413ce1924f04 +#: ../../maintaining/tasks.md:28 +msgid "" +"Update the Build Context in the default build rule to be /." +msgstr "" + +# b98a150760924b36ad034180f6703f71 +#: ../../maintaining/tasks.md:29 +msgid "" +"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., " +"like jupyter/base-notebook)." +msgstr "" + +# dd8eb743edb8447ca525286d44c47b11 +#: ../../maintaining/tasks.md:30 +msgid "If the new stack depends on the build of another stack in the hierarchy:" +msgstr "" + +# a7dad3d094a242adadfa852c1437ec9f +#: ../../maintaining/tasks.md:31 +msgid "Hit Save and then click Configure Automated Builds." +msgstr "" + +# bd94bcfffbc449ee85ffec18d13ba909 +#: ../../maintaining/tasks.md:32 +msgid "At the very bottom, add a build trigger named Stack hierarchy trigger." +msgstr "" + +# c1dc766b9b9f45e59510580c3e29017e +#: ../../maintaining/tasks.md:33 +msgid "Copy the build trigger URL." +msgstr "" + +# c47dc2c8c04f4af9bbb059692074d979 +#: ../../maintaining/tasks.md:34 +msgid "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." +msgstr "" + +# 53ad6138cba343c4a2314cbdfefaa3de +#: ../../maintaining/tasks.md:35 +msgid "" +"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable " +"comma separated list of URLs, creating that environment variable if it " +"does not already exist." +msgstr "" + +# c1b65a945fb84b57929a970c00fe60e7 +# f235402e08104dcbac10aee2415b5aba +#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40 +msgid "Hit Save." +msgstr "" + +# c915beb1daef4cab989b00b571d30cbb +#: ../../maintaining/tasks.md:37 +msgid "If the new stack should trigger other dependent builds:" +msgstr "" + +# b19b3d4243a648ec9aaa46f038e29636 +#: ../../maintaining/tasks.md:38 +msgid "Add an environment variable named NEXT_BUILD_TRIGGERS." +msgstr "" + +# 74dbcd642b774e46aa2d472161fe228f +#: ../../maintaining/tasks.md:39 +msgid "" +"Copy the build trigger URLs from the dependent builds into the " +"NEXT_BUILD_TRIGGERS comma separated list of URLs." +msgstr "" + +# 3d39e5c5b33641d8ba202c4cedc33849 +#: ../../maintaining/tasks.md:41 +msgid "" +"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order" +" matches that in the stack hierarchy diagram." +msgstr "" + +# c15b6f77f0784056aa45c456e49673ff +#: ../../maintaining/tasks.md:43 +msgid "Adding a New Maintainer Account" +msgstr "" + +# e3bd3ced73994d9fad596784e1469cfc +#: ../../maintaining/tasks.md:45 +msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" +msgstr "" + +# 51b166c70ba743e0b4d335b3471da69a +#: ../../maintaining/tasks.md:46 +msgid "Add the maintainer's Docker Cloud username." +msgstr "" + +# 300f5dbd933f4ee6b5a550efd35f1c52 +#: ../../maintaining/tasks.md:47 +msgid "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-" +"maintainers/members" +msgstr "" + +# e26ad8ffb6de489988e076e64b6a1415 +#: ../../maintaining/tasks.md:48 +msgid "Add the maintainer's GitHub username." +msgstr "" + +# 97362d55b4f340e6af93e7150d357906 +#: ../../maintaining/tasks.md:50 +msgid "Pushing a Build Manually" +msgstr "" + +# 050b5c7a3d9d46bcbe26d54e8585ddd8 +#: ../../maintaining/tasks.md:52 +msgid "" +"If automated builds on Docker Cloud have got you down, do the following " +"to push a build manually:" +msgstr "" + +# ead6a3a714ae4a8a9df5585c18260c16 +#: ../../maintaining/tasks.md:54 +msgid "Clone this repository." +msgstr "" + +# 48e1d6954f414fe080d7b4afd9e0c391 +#: ../../maintaining/tasks.md:55 +msgid "Check out the git SHA you want to build and publish." +msgstr "" + +# 98f385aba16144acb355a7f8ceccbf65 +#: ../../maintaining/tasks.md:56 +msgid "docker login with your Docker Hub/Cloud credentials." +msgstr "" + +# 580040491fc14cef9ecf16b58128093e +#: ../../maintaining/tasks.md:57 +msgid "Run make retry/release-all." +msgstr "" + +# bd3a5cebd1254827a53b9dba986e69fa +#: ../../maintaining/tasks.md:59 +msgid "Enabling a New Doc Language Translation" +msgstr "" + +# 5aafef10dc75417785a79aba203175e5 +#: ../../maintaining/tasks.md:61 +msgid "First enable translation on Transifex:" +msgstr "" + +# c1a249c0d0cd4e9192ed7814dfde6e34 +#: ../../maintaining/tasks.md:63 +msgid "" +"Visit https://www.transifex.com/project-jupyter/jupyter-docker-" +"stacks-1/languages/" +msgstr "" + +# 3675bff3644a4d928586f884e3bf2636 +#: ../../maintaining/tasks.md:64 +msgid "Click Edit Languages in the top right." +msgstr "" + +# 7efe7d98a98b47bd82d697673d277cbd +#: ../../maintaining/tasks.md:65 +msgid "Select the language from the dropdown." +msgstr "" + +# 174f04a821b843dcace04f708cbf3c78 +#: ../../maintaining/tasks.md:66 +msgid "Click Apply." +msgstr "" + +# 1e3868ee7dae469f9921516dd7973766 +#: ../../maintaining/tasks.md:68 +msgid "Then setup a subproject on ReadTheDocs for the language:" +msgstr "" + +# fffa155a75674f0dbe746a15eb3be492 +#: ../../maintaining/tasks.md:70 +msgid "Visit https://readthedocs.org/dashboard/import/manual/" +msgstr "" + +# a798b8e31be7408d9301187ff3e3ef69 +#: ../../maintaining/tasks.md:71 +msgid "Enter jupyter-docker-stacks- for the project name." +msgstr "" + +# 2869b2f7a89c428f903e3695dd511e9a +#: ../../maintaining/tasks.md:72 +msgid "Enter https://github.com/jupyter/docker-stacks for the URL." +msgstr "" + +# 4a964f7a3ec242b2bf03a8478f53b5d9 +#: ../../maintaining/tasks.md:73 +msgid "Check Edit advanced project options." +msgstr "" + +# baf5be1aea37451dbdb266b5aa221453 +#: ../../maintaining/tasks.md:74 +msgid "Click Next." +msgstr "" + +# 1f6b09025ce34dc1bef51a8ac114080a +#: ../../maintaining/tasks.md:75 +msgid "Select the Language from the dropdown on the next screen." +msgstr "" + +# 50c15b61ac8e4d1bbdd36681a25aa6ed +#: ../../maintaining/tasks.md:76 +msgid "Click Finish." +msgstr "" + +# 529f3729d2474287adec0ff895100248 +#: ../../maintaining/tasks.md:78 +msgid "Finally link the new language subproject to the top level doc project:" +msgstr "" + +# 024aaf54695141839eaa5537b4087a81 +#: ../../maintaining/tasks.md:80 +msgid "" +"Visit https://readthedocs.org/dashboard/jupyter-docker-" +"stacks/translations/" +msgstr "" + +# 6e5a75790d784cdaaa2cda5fac32b67e +#: ../../maintaining/tasks.md:81 +msgid "Select the subproject you created from the Project dropdown." +msgstr "" + +# 9367330f235441869d649687e97a1796 +#: ../../maintaining/tasks.md:82 +msgid "Click Add." +msgstr "" + diff --git a/docs/locale/en/LC_MESSAGES/using.po b/docs/locale/en/LC_MESSAGES/using.po new file mode 100644 index 0000000000..e5cae37a84 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/using.po @@ -0,0 +1,1540 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks +# package. +# FIRST AUTHOR , 2019. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-05-05 19:53-0400\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=utf-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Generated-By: Babel 2.6.0\n" + +# e41cd9909fcf4bfe9df2b20f447770f7 +#: ../../using/common.md:1 +msgid "Common Features" +msgstr "" + +# 611e344f2bb64ed89fa2005d030e5479 +#: ../../using/common.md:3 +msgid "" +"A container launched from any Jupyter Docker Stacks image runs a Jupyter " +"Notebook server by default. The container does so by executing a start-" +"notebook.sh script. This script configures the internal container " +"environment and then runs jupyter notebook, passing it any command line " +"arguments received." +msgstr "" + +# 608ce0de07a84d5dab8e53b4e1480cc1 +#: ../../using/common.md:5 +msgid "" +"This page describes the options supported by the startup script as well " +"as how to bypass it to run alternative commands." +msgstr "" + +# a4d5d5ad78f14210a50d59ac9a7dd8ac +#: ../../using/common.md:7 +msgid "Notebook Options" +msgstr "" + +# d1dfc4449caa4df688bf649bb1ffc782 +#: ../../using/common.md:9 +msgid "" +"You can pass Jupyter command line options to the start-notebook.sh script" +" when launching the container. For example, to secure the Notebook server" +" with a custom password hashed using IPython.lib.passwd() instead of the " +"default token, you can run the following:" +msgstr "" + +# d1444171de834a15aa9a98eeb0c5ecf4 +#: ../../using/common.md:15 +msgid "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" +msgstr "" + +# 007861f656fc4ec083b2f046ce7bce61 +#: ../../using/common.md:21 +msgid "Docker Options" +msgstr "" + +# 94984b8745f4497b8f146c8cdc503c0c +#: ../../using/common.md:23 +msgid "" +"You may instruct the start-notebook.sh script to customize the container " +"environment before launching the notebook server. You do so by passing " +"arguments to the docker run command." +msgstr "" + +# 569ce4a080664344915f3efe69effc72 +#: ../../using/common.md:26 +msgid "" +"-e NB_USER=jovyan - Instructs the startup script to change the default " +"container username from jovyan to the provided value. Causes the script " +"to rename the jovyan user home folder. For this option to take effect, " +"you must run the container with --user root and set the working directory" +" -w /home/$NB_USER. This feature is useful when mounting host volumes " +"with specific home folder." +msgstr "" + +# 0d0ff97c80094025adee1a345eb85735 +#: ../../using/common.md:27 +msgid "" +"-e NB_UID=1000 - Instructs the startup script to switch the numeric user " +"ID of $NB_USER to the given value. This feature is useful when mounting " +"host volumes with specific owner permissions. For this option to take " +"effect, you must run the container with --user root. (The startup script " +"will su $NB_USER after adjusting the user ID.) You might consider using " +"modern Docker options --user and --group-add instead. See the last bullet" +" below for details." +msgstr "" + +# 9acc25ea16124e35bba9528f734f3475 +#: ../../using/common.md:28 +msgid "" +"-e NB_GID=100 - Instructs the startup script to change the primary group " +"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if" +" it is defined, otherwise the group is named $NB_USER). This feature is " +"useful when mounting host volumes with specific group permissions. For " +"this option to take effect, you must run the container with --user root. " +"(The startup script will su $NB_USER after adjusting the group ID.) You " +"might consider using modern Docker options --user and --group-add " +"instead. See the last bullet below for details. The user is added to " +"supplemental group users (gid 100) in order to allow write access to the " +"home directory and /opt/conda. If you override the user/group logic, " +"ensure the user stays in group users if you want them to be able to " +"modify files in the image." +msgstr "" + +# 9607821e245e452d896ec1b30f7053a5 +#: ../../using/common.md:29 +msgid "" +"-e NB_GROUP= - The name used for $NB_GID, which defaults to " +"$NB_USER. This is only used if $NB_GID is specified and completely " +"optional: there is only cosmetic effect." +msgstr "" + +# 1c73d7064e21443eb3cbee69968f726e +#: ../../using/common.md:30 +msgid "" +"-e NB_UMASK= - Configures Jupyter to use a different umask value " +"from default, i.e. 022. For example, if setting umask to 002, new files " +"will be readable and writable by group members instead of just writable " +"by the owner. Wikipedia has a good article about umask. Feel free to read" +" it in order to choose the value that better fits your needs. Default " +"value should fit most situations. Note that NB_UMASK when set only " +"applies to the Jupyter process itself - you cannot use it to set a umask " +"for additional files created during run-hooks e.g. via pip or conda - if " +"you need to set a umask for these you must set umask for each command." +msgstr "" + +# 5a54345a51fa4c1b9b03d34a3de8ca74 +#: ../../using/common.md:31 +msgid "" +"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER " +"home directory owner and group to the current value of $NB_UID and " +"$NB_GID. This change will take effect even if the user home directory is " +"mounted from the host using -v as described below. The change is not " +"applied recursively by default. You can change modify the chown behavior " +"by setting CHOWN_HOME_OPTS (e.g., -e CHOWN_HOME_OPTS='-R')." +msgstr "" + +# dbd06371a36547c9aa22b8da35120c89 +#: ../../using/common.md:32 +msgid "" +"-e CHOWN_EXTRA=\",\" - Instructs the startup " +"script to change the owner and group of each comma-separated container " +"directory to the current value of $NB_UID and $NB_GID. The change is not " +"applied recursively by default. You can change modify the chown behavior " +"by setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')." +msgstr "" + +# a4a085a9571a441bb8d084df104e0593 +#: ../../using/common.md:33 +msgid "" +"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER " +"user passwordless sudo capability. You do not need this option to allow " +"the user to conda or pip install additional packages. This option is " +"useful, however, when you wish to give $NB_USER the ability to install OS" +" packages with apt or modify other root-owned files in the container. For" +" this option to take effect, you must run the container with --user root." +" (The start-notebook.sh script will su $NB_USER after adding $NB_USER to " +"sudoers.) You should only enable sudo if you trust the user or if the " +"container is running on an isolated host." +msgstr "" + +# d22e4525015d40e8b45df68936c7650f +#: ../../using/common.md:34 +msgid "" +"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed" +" SSL certificate and configure Jupyter Notebook to use it to accept " +"encrypted HTTPS connections." +msgstr "" + +# ab3e246dc22849b9abd24370da63dc55 +#: ../../using/common.md:35 +msgid "" +"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter " +"lab instead of the default jupyter notebook command. Useful in container " +"orchestration environments where setting environment variables is easier " +"than change command line parameters." +msgstr "" + +# 8a84035eba7f46c393eed97d7b240afe +#: ../../using/common.md:36 +msgid "" +"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine " +"directory as folder in the container. Useful when you want to preserve " +"notebooks and other work even after the container is destroyed. You must " +"grant the within-container notebook user or group (NB_UID or NB_GID) " +"write access to the host directory (e.g., sudo chown 1000 " +"/some/host/folder/for/work)." +msgstr "" + +# 362e3aa9c0c2469b9dd5777db3646c5e +#: ../../using/common.md:37 +msgid "" +"--user 5000 --group-add users - Launches the container with a specific " +"user ID and adds that user to the users group so that it can modify files" +" in the default home directory and /opt/conda. You can use these " +"arguments as alternatives to setting $NB_UID and $NB_GID." +msgstr "" + +# 1e7fa5e0e4f0456789e8e5f3692a33e0 +#: ../../using/common.md:39 +msgid "Startup Hooks" +msgstr "" + +# cdcdb2229de64e54b89f86c8bed5ed30 +#: ../../using/common.md:41 +msgid "" +"You can further customize the container environment by adding shell " +"scripts (*.sh) to be sourced or executables (chmod +x) to be run to the " +"paths below:" +msgstr "" + +# 9674ca5b624a4c1482caf1725ab3d01b +#: ../../using/common.md:44 +msgid "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" +msgstr "" + +# 5f11a62b1c414894af157d23ce8893ae +#: ../../using/common.md:46 +msgid "" +"/usr/local/bin/before-notebook.d/ - handled after all of the standard " +"options noted above are applied and just before the notebook server " +"launches" +msgstr "" + +# 3f97359a0aa34755b18ff1bf51d9bc47 +#: ../../using/common.md:49 +msgid "" +"See the run-hooks function in the jupyter/base-notebook start.sh script " +"for execution details." +msgstr "" + +# 75046865f61c4df3977920e74156bfe0 +#: ../../using/common.md:52 +msgid "SSL Certificates" +msgstr "" + +# 7d8e48b6d3c448f1a3a4779deee18192 +#: ../../using/common.md:54 +msgid "" +"You may mount SSL key and certificate files into a container and " +"configure Jupyter Notebook to use them to accept HTTPS connections. For " +"example, to mount a host folder containing a notebook.key and " +"notebook.crt and use them, you might run the following:" +msgstr "" + +# 502ad4a251fe4c648c45205a3e4d75bc +#: ../../using/common.md:64 +msgid "" +"Alternatively, you may mount a single PEM file containing both the key " +"and certificate. For example:" +msgstr "" + +# 619a68775c0f4bde851da52dd2fcf4d0 +#: ../../using/common.md:73 +msgid "" +"In either case, Jupyter Notebook expects the key and certificate to be a " +"base64 encoded text file. The certificate file or PEM may contain one or " +"more certificates (e.g., server, intermediate, and root)." +msgstr "" + +# d080e400a62044a7a488e7fceb7c87fd +#: ../../using/common.md:75 +msgid "For additional information about using SSL, see the following:" +msgstr "" + +# 127678fd894945b488ff9073a69c8cbe +#: ../../using/common.md:77 +msgid "" +"The docker-stacks/examples for information about how to use Let's Encrypt" +" certificates when you run these stacks on a publicly visible domain." +msgstr "" + +# 0ccecbceea074b8f898837adc6fba3fe +#: ../../using/common.md:78 +msgid "" +"The jupyter_notebook_config.py file for how this Docker image generates a" +" self-signed certificate." +msgstr "" + +# a2cd4739b7ab48558eff205a4c0c0d79 +#: ../../using/common.md:79 +msgid "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." +msgstr "" + +# 02cf3f994bc0435bab175aa7ba3bca23 +#: ../../using/common.md:81 +msgid "Alternative Commands" +msgstr "" + +# dec6483e89a24ea19227e9596ad1ef76 +#: ../../using/common.md:83 +msgid "start.sh" +msgstr "" + +# 1e497e8452b447af833630319560e351 +#: ../../using/common.md:85 +msgid "" +"The start-notebook.sh script actually inherits most of its option " +"handling capability from a more generic start.sh script. The start.sh " +"script supports all of the features described above, but allows you to " +"specify an arbitrary command to execute. For example, to run the text-" +"based ipython console in a container, do the following:" +msgstr "" + +# abb5f8d7161143e693fde71df9496362 +#: ../../using/common.md:91 +msgid "Or, to run JupyterLab instead of the classic notebook, run the following:" +msgstr "" + +# 2a8ff717ba22400a8a5f5e02fc87c03d +#: ../../using/common.md:97 +msgid "" +"This script is particularly useful when you derive a new Dockerfile from " +"this image and install additional Jupyter applications with subcommands " +"like jupyter console, jupyter kernelgateway, etc." +msgstr "" + +# 577ae6d953784517826ce5b20a4297ee +#: ../../using/common.md:99 +msgid "Others" +msgstr "" + +# 8cbff9cc00f44eb1831079f170b1f701 +#: ../../using/common.md:101 +msgid "" +"You can bypass the provided scripts and specify an arbitrary start " +"command. If you do, keep in mind that features supported by the start.sh " +"script and its kin will not function (e.g., GRANT_SUDO)." +msgstr "" + +# aaa3c260d46844d8b04d7e951fd928a1 +#: ../../using/common.md:103 +msgid "Conda Environments" +msgstr "" + +# 58f06c1abb5845abaa5ab414610ce616 +#: ../../using/common.md:105 +msgid "" +"The default Python 3.x Conda environment resides in /opt/conda. The " +"/opt/conda/bin directory is part of the default jovyan user's $PATH. That" +" directory is also whitelisted for use in sudo commands by the start.sh " +"script." +msgstr "" + +# 121c9ede94f849ca8cac9ea98d2321dd +#: ../../using/common.md:107 +msgid "" +"The jovyan user has full read/write access to the /opt/conda directory. " +"You can use either conda or pip to install new packages without any " +"additional permissions." +msgstr "" + +# 96df5e77c43d40babb98a14b987d1435 +#: ../../using/recipes.md:1 +msgid "Contributed Recipes" +msgstr "" + +# 3a4dd4c9503a4a2ea62cda4f55bcf6d0 +#: ../../using/recipes.md:3 +msgid "" +"Users sometimes share interesting ways of using the Jupyter Docker " +"Stacks. We encourage users to contribute these recipes to the " +"documentation in case they prove useful to other members of the community" +" by submitting a pull request to docs/using/recipes.md. The sections " +"below capture this knowledge." +msgstr "" + +# bea8241927a54c75a0ded413dec82e3a +#: ../../using/recipes.md:5 +msgid "Using pip install or conda install in a Child Docker image" +msgstr "" + +# 4d213737d62c45eaa3852726297b7c28 +#: ../../using/recipes.md:7 +msgid "Create a new Dockerfile like the one shown below." +msgstr "" + +# ca36eb48cc5f452a96f9440811f45cb5 +#: ../../using/recipes.md:16 +msgid "Then build a new image." +msgstr "" + +# bc376e79b2884fad991018aa30023146 +#: ../../using/recipes.md:22 +msgid "" +"To use a requirements.txt file, first create your requirements.txt file " +"with the listing of packages desired. Next, create a new Dockerfile like" +" the one shown below." +msgstr "" + +# 5d6ce581929447a0af7958c47ed1769c +#: ../../using/recipes.md:35 +msgid "For conda, the Dockerfile is similar:" +msgstr "" + +# 398d875ac92e46b9bf522f17db73075e +#: ../../using/recipes.md:47 +msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" +msgstr "" + +# 3c654dec03f74a6f9b64da850de3f4e8 +#: ../../using/recipes.md:49 +msgid "Add a Python 2.x environment" +msgstr "" + +# 60f73f66c81f495d85d971a5838f6cc3 +#: ../../using/recipes.md:51 +msgid "" +"Python 2.x was removed from all images on August 10th, 2017, starting in " +"tag cc9feab481f7. You can add a Python 2.x environment by defining your " +"own Dockerfile inheriting from one of the images like so:" +msgstr "" + +# 47c5a8d4de7b4bf18180580b07c01fa2 +#: ../../using/recipes.md:73 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440" +msgstr "" + +# 2de5eb85f4c7475ab3499f88bd20f8d9 +#: ../../using/recipes.md:75 +msgid "Run JupyterLab" +msgstr "" + +# e0e2db6436024c1a9f3827362046f21c +#: ../../using/recipes.md:77 +msgid "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." +msgstr "" + +# 29d86244710246d3a99adbe727d41fbe +#: ../../using/recipes.md:79 +msgid "" +"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 " +"jupyter/datascience-notebook start.sh jupyter lab" +msgstr "" + +# 359d14a5fbcc4bf5838c3cef102bd7d2 +#: ../../using/recipes.md:81 +msgid "Let's Encrypt a Notebook server" +msgstr "" + +# f03dce66cd314ce48b6f63f9f8b3f839 +#: ../../using/recipes.md:83 +msgid "" +"See the README for the simple automation here https://github.com/jupyter" +"/docker-stacks/tree/master/examples/make-deploy which includes steps for " +"requesting and renewing a Let's Encrypt certificate." +msgstr "" + +# ae272bea82974525ab5b17104de09344 +#: ../../using/recipes.md:85 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78" +msgstr "" + +# 69440a80a8dd40c093a11e052c5ffb7d +#: ../../using/recipes.md:87 +msgid "Slideshows with Jupyter and RISE" +msgstr "" + +# eecba36e666b4725a9696a571fddf3a4 +#: ../../using/recipes.md:89 +msgid "" +"RISE allows via extension to create live slideshows of your notebooks, " +"with no conversion, adding javascript Reveal.js:" +msgstr "" + +# 2204bca916034fd68769987aaa1c9e9a +#: ../../using/recipes.md:95 +msgid "Credit: Paolo D. based on docker-stacks/issues/43" +msgstr "" + +# d1b8d0688d7c457d9512ce73a8c323be +#: ../../using/recipes.md:97 +msgid "xgboost" +msgstr "" + +# 4a41168ccdce41ab92f12673be4145ba +#: ../../using/recipes.md:99 +msgid "" +"You need to install conda's gcc for Python xgboost to work properly. " +"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0." +msgstr "" + +# 8056222583324c679fcf24166b7539dc +#: ../../using/recipes.md:109 +msgid "Running behind a nginx proxy" +msgstr "" + +# 24d5e546f0da44448c5b64643481388c +#: ../../using/recipes.md:111 +msgid "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, " +"for instance:" +msgstr "" + +# 057c2dbd67be44b8bdf158217757829d +#: ../../using/recipes.md:113 +msgid "" +"you would prefer to access the notebook at a server URL with a path " +"(https://example.com/jupyter) rather than a port " +"(https://example.com:8888)" +msgstr "" + +# 520fd309518e445aba1117b2dcde5b71 +#: ../../using/recipes.md:114 +msgid "" +"you may have many different services in addition to Jupyter running on " +"the same server, and want to nginx to help improve server performance in " +"manage the connections" +msgstr "" + +# f4f57a6b4e6c468490102274877fecd7 +#: ../../using/recipes.md:116 +msgid "" +"Here is a quick example NGINX configuration to get started. You'll need " +"a server, a .crt and .key file for your server, and docker & docker-" +"compose installed. Then just download the files at that gist and run " +"docker-compose up -d to test it out. Customize the nginx.conf file to " +"set the desired paths and add other services." +msgstr "" + +# a1b6da6433a243a1b5e5f36aa024fe62 +#: ../../using/recipes.md:118 +msgid "Host volume mounts and notebook errors" +msgstr "" + +# 9f9cd5a20a64430e81675cedd5495031 +#: ../../using/recipes.md:120 +msgid "" +"If you are mounting a host directory as /home/jovyan/work in your " +"container and you receive permission errors or connection errors when you" +" create a notebook, be sure that the jovyan user (UID=1000 by default) " +"has read/write access to the directory on the host. Alternatively, " +"specify the UID of the jovyan user on container startup using the -e " +"NB_UID option described in the Common Features, Docker Options section" +msgstr "" + +# bfe9c4ce5c664b1d9e71694acccc72a5 +#: ../../using/recipes.md:122 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199" +msgstr "" + +# d34a4721b88942b18507ae53189ad1ad +#: ../../using/recipes.md:124 +msgid "Manpage installation" +msgstr "" + +# aa0a4cd167fe49809dfc513cf965470d +#: ../../using/recipes.md:126 +msgid "" +"Most containers, including our Ubuntu base image, ship without manpages " +"installed to save space. You can use the following dockerfile to inherit " +"from one of our images to enable manpages:" +msgstr "" + +# 6c443960b61c4b83bc348bbba654957c +#: ../../using/recipes.md:151 +msgid "" +"Adding the documentation on top of an existing singleuser image wastes a " +"lot of space and requires reinstalling every system package, which can " +"take additional time and bandwidth; the datascience-notebook image has " +"been shown to grow by almost 3GB when adding manapages in this way. " +"Enabling manpages in the base Ubuntu layer prevents this container bloat:" +msgstr "" + +# 6f7d3db232f14979ac6e11214b089d2b +#: ../../using/recipes.md:173 +msgid "Be sure to check the current base image in base-notebook before building." +msgstr "" + +# 67ffff4f1bee4b1eb570c52cc23a259d +#: ../../using/recipes.md:175 +msgid "JupyterHub" +msgstr "" + +# f082ad5f120b4d779a09e8e08f1dda79 +#: ../../using/recipes.md:177 +msgid "We also have contributed recipes for using JupyterHub." +msgstr "" + +# 021f9c498d87459ab8b7eec9902a1ff5 +#: ../../using/recipes.md:179 +msgid "Use JupyterHub's dockerspawner" +msgstr "" + +# 07655cc3f3fc4445a27cb4b1500ded88 +#: ../../using/recipes.md:181 +msgid "" +"In most cases for use with DockerSpawner, given any image that already " +"has a notebook stack set up, you would only need to add:" +msgstr "" + +# 13af5ca0e82a4b50a8043f5c1a97099b +#: ../../using/recipes.md:183 +msgid "install the jupyterhub-singleuser script (for the right Python)" +msgstr "" + +# ea56e8bbbe8d4a9db5f95d33cd178c03 +#: ../../using/recipes.md:184 +msgid "change the command to launch the single-user server" +msgstr "" + +# 97b283b80f1543c8a673644fde46971d +#: ../../using/recipes.md:186 +msgid "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should" +" be enough for most cases." +msgstr "" + +# a002a7462b6c43909fe730a6866a9c2a +#: ../../using/recipes.md:188 +msgid "" +"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-" +"stacks/issues/124 and docker-stacks/pull/185" +msgstr "" + +# a0e591ed0e2c49b4801ba78294e04e51 +#: ../../using/recipes.md:190 +msgid "Containers with a specific version of JupyterHub" +msgstr "" + +# c4c3647187f946daa180b968be35b38a +#: ../../using/recipes.md:192 +msgid "" +"To use a specific version of JupyterHub, the version of jupyterhub in " +"your image should match the version in the Hub itself." +msgstr "" + +# 5b520a1539e0481abd8bb6468ff848d7 +#: ../../using/recipes.md:199 +msgid "Credit: MinRK" +msgstr "" + +# 627a7b8ac6e5493da03459e5a05fec93 +#: ../../using/recipes.md:202 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177" +msgstr "" + +# fe647ec58496481d9a7751bde440fa0c +#: ../../using/recipes.md:204 +msgid "Spark" +msgstr "" + +# d0fc3715abab4a76812a2e7015f2be55 +#: ../../using/recipes.md:206 +msgid "A few suggestions have been made regarding using Docker Stacks with spark." +msgstr "" + +# 6182f433983649208b691dc4ad39b3b1 +#: ../../using/recipes.md:208 +msgid "Using PySpark with AWS S3" +msgstr "" + +# 536fd7b869df4ab3837b510fdaab4f83 +#: ../../using/recipes.md:210 +msgid "Using Spark session for hadoop 2.7.3" +msgstr "" + +# 4cba8e4c12704f51aae9a8d73f3fc54f +#: ../../using/recipes.md:230 +msgid "Using Spark context for hadoop 2.6.0" +msgstr "" + +# 340a026384be4c5791dd1e1ceadb68bb +#: ../../using/recipes.md:252 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127" +msgstr "" + +# a4e41f560b674eed8235533202d4a3e2 +#: ../../using/recipes.md:254 +msgid "Using Local Spark JARs" +msgstr "" + +# 98497d18d63c47d8a1c0b881567af6b2 +#: ../../using/recipes.md:270 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154" +msgstr "" + +# 721488b8395241a9a28ed073d5922d66 +#: ../../using/recipes.md:272 +msgid "Using spark-packages.org" +msgstr "" + +# c631f17a0b484bf0ab4db1db6c250b63 +#: ../../using/recipes.md:274 +msgid "" +"If you'd like to use packages from spark-packages.org, see " +"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of " +"how to specify the package identifier in the environment before creating " +"a SparkContext." +msgstr "" + +# 54aad266bbe04b2c832113f8c6de961d +#: ../../using/recipes.md:276 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43" +msgstr "" + +# 1b12c39b6e9e48c9b53a56dcbb3c687b +#: ../../using/recipes.md:278 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +msgstr "" + +# 0088c44217b4442ea1bc0776c085647e +#: ../../using/recipes.md:342 +msgid "Credit: britishbadger from docker-stacks/issues/369" +msgstr "" + +# 05e2f7930b2146b3b6dc2160e7b2938f +#: ../../using/recipes.md:344 +msgid "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., " +"with no token)" +msgstr "" + +# 96661b40222d42d7beb6ea4a4e27ed2a +#: ../../using/recipes.md:346 +msgid "(Adapted from issue 728)" +msgstr "" + +# 968a4d9ee2ce4da3b15836cb19fe73c6 +#: ../../using/recipes.md:348 +msgid "" +"The default security is very good. There are use cases, encouraged by " +"containers, where the jupyter container and the system it runs within, " +"lie inside the security boundary. In these use cases it is convenient to " +"launch the server without a password or token. In this case, you should " +"use the start.sh script to launch the server with no token:" +msgstr "" + +# 577b175adea2465682a27ca6b5dbe047 +#: ../../using/recipes.md:354 +msgid "For jupyterlab:" +msgstr "" + +# 68eca3d8da8a4e4a9582eae5db03a2f7 +#: ../../using/recipes.md:360 +msgid "For jupyter classic:" +msgstr "" + +# 749d1d070d084422912681681b95de7c +#: ../../using/recipes.md:365 +msgid "Enable nbextension spellchecker for markdown (or any other nbextension)" +msgstr "" + +# eafb01c0017241f7b0d63c9efe3bf471 +#: ../../using/recipes.md:367 +msgid "NB: this works for classic notebooks only" +msgstr "" + +# fd2b07901b0644b3851371881aaec0d3 +#: ../../using/recipes.md:380 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675" +msgstr "" + +# bd95c67863cf43f7968ba7ec8ec6ed77 +#: ../../using/running.md:1 +msgid "Running a Container" +msgstr "" + +# 05cc15a914e342de851163b9c977b78e +# 035dba075a364e20ba77adb31704057f +#: ../../using/running.md:3 ../../using/selecting.md:7 +msgid "Using one of the Jupyter Docker Stacks requires two choices:" +msgstr "" + +# a5bd470d20664a7abb0d7a4fc5a26ab6 +# 24ff2826e55444bbaf9c7852ad84a862 +#: ../../using/running.md:5 ../../using/selecting.md:9 +msgid "Which Docker image you wish to use" +msgstr "" + +# cad851a7c7bf4b58bd5c740bbd51370f +# fc4a1d9d40fc4531819c7e3268d42477 +#: ../../using/running.md:6 ../../using/selecting.md:10 +msgid "How you wish to start Docker containers from that image" +msgstr "" + +# 2a3f883d3edc4d02b67a9bc857bbf9d2 +#: ../../using/running.md:8 +msgid "This section provides details about the second." +msgstr "" + +# efdebebd730f4d34b3776e1768b4edc5 +#: ../../using/running.md:10 +msgid "Using the Docker CLI" +msgstr "" + +# 47eaf61cf553485db1e7a1554eebfd1b +#: ../../using/running.md:12 +msgid "" +"You can launch a local Docker container from the Jupyter Docker Stacks " +"using the Docker command line interface. There are numerous ways to " +"configure containers using the CLI. The following are some common " +"patterns." +msgstr "" + +# 102b2f16273f4cdda45099ccf6430e39 +#: ../../using/running.md:14 +msgid "" +"Example 1 This command pulls the jupyter/scipy-notebook image tagged " +"2c80cf3537ca from Docker Hub if it is not already present on the local " +"host. It then starts a container running a Jupyter Notebook server and " +"exposes the server on host port 8888. The server logs appear in the " +"terminal and include a URL to the notebook server." +msgstr "" + +# 3866e5dbc6bb4f12826cc9d5c6389cd0 +#: ../../using/running.md:36 +msgid "" +"Pressing Ctrl-C shuts down the notebook server but leaves the container " +"intact on disk for later restart or permanent deletion using commands " +"like the following:" +msgstr "" + +# 777e803f312d46cf9f20feedc7d88fe0 +#: ../../using/running.md:55 +msgid "" +"Example 2 This command pulls the jupyter/r-notebook image tagged " +"e5c5a7d3e52d from Docker Hub if it is not already present on the local " +"host. It then starts a container running a Jupyter Notebook server and " +"exposes the server on host port 10000. The server logs appear in the " +"terminal and include a URL to the notebook server, but with the internal " +"container port (8888) instead of the the correct host port (10000)." +msgstr "" + +# 377c4f764c4942c8806f93e74ced124e +#: ../../using/running.md:77 +msgid "" +"Pressing Ctrl-C shuts down the notebook server and immediately destroys " +"the Docker container. Files written to ~/work in the container remain " +"touched. Any other changes made in the container are lost." +msgstr "" + +# e2fecfe0aa8f486db14e7ea53c6e1c39 +#: ../../using/running.md:79 +msgid "" +"Example 3 This command pulls the jupyter/all-spark-notebook image " +"currently tagged latest from Docker Hub if an image tagged latest is not " +"already present on the local host. It then starts a container named " +"notebook running a JupyterLab server and exposes the server on a randomly" +" selected port." +msgstr "" + +# 22c531b06ab14a07b6c05571d20093d6 +#: ../../using/running.md:85 +msgid "" +"The assigned port and notebook server token are visible using other " +"Docker commands." +msgstr "" + +# 1a0c5a5c2c234271932e76999ef582ec +#: ../../using/running.md:99 +msgid "" +"Together, the URL to visit on the host machine to access the server in " +"this case is " +"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00." +msgstr "" + +# 2ebdbe40ca2844e8b9e72b7842f662bc +#: ../../using/running.md:101 +msgid "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." +msgstr "" + +# 5b052f4a27a54535af5ab5b7464dbe89 +#: ../../using/running.md:113 +msgid "Using Binder" +msgstr "" + +# da98399210274ccdaad3dae3627b1184 +#: ../../using/running.md:115 +msgid "" +"Binder is a service that allows you to create and share custom computing " +"environments for projects in version control. You can use any of the " +"Jupyter Docker Stacks images as a basis for a Binder-compatible " +"Dockerfile. See the docker-stacks example and Using a Dockerfile sections" +" in the Binder documentation for instructions." +msgstr "" + +# 55ac73b7088d4c8daee182dfa7da273f +#: ../../using/running.md:117 +msgid "Using JupyterHub" +msgstr "" + +# 927dc077eea741c2bfc0c65d20cedfe3 +#: ../../using/running.md:119 +msgid "" +"You can configure JupyterHub to launcher Docker containers from the " +"Jupyter Docker Stacks images. If you've been following the Zero to " +"JupyterHub with Kubernetes guide, see the Use an existing Docker image " +"section for details. If you have a custom JupyterHub deployment, see the " +"Picking or building a Docker image instructions for the dockerspawner " +"instead." +msgstr "" + +# 633e412af0a446b0b97a27b51a86532b +#: ../../using/running.md:121 +msgid "Using Other Tools and Services" +msgstr "" + +# f184b5fe87ea4101995177d78b4b2f17 +#: ../../using/running.md:123 +msgid "" +"You can use the Jupyter Docker Stacks with any Docker-compatible " +"technology (e.g., Docker Compose, docker-py, your favorite cloud " +"container service). See the documentation of the tool, library, or " +"service for details about how to reference, configure, and launch " +"containers from these images." +msgstr "" + +# c98fdeb172fb4ec3a8a8087c48429f04 +#: ../../using/selecting.md:1 +msgid "Selecting an Image" +msgstr "" + +# 3c714629ef574f34a2a3a38085fb9c8d +# 85328d14a09a4f8d83a92d7550bf0690 +#: ../../using/selecting.md:3 ../../using/selecting.md:14 +msgid "Core Stacks" +msgstr "" + +# c95a54d4c1fe45229ce45ebbb1ee249f +# 52f10b204ebd42dfa5f51748f680fb38 +#: ../../using/selecting.md:4 ../../using/selecting.md:123 +msgid "Image Relationships" +msgstr "" + +# 541ac85034034eaab56f331ee972b242 +# 20eed0a822964e89bf3cad70fb0afefb +#: ../../using/selecting.md:5 ../../using/selecting.md:141 +msgid "Community Stacks" +msgstr "" + +# 9bf531372259449da32ea02ec63840c9 +#: ../../using/selecting.md:12 +msgid "This section provides details about the first." +msgstr "" + +# ff7679af5a5b41b79bfab5312a8dead7 +#: ../../using/selecting.md:16 +msgid "" +"The Jupyter team maintains a set of Docker image definitions in the " +"https://github.com/jupyter/docker-stacks GitHub repository. The following" +" sections describe these images including their contents, relationships, " +"and versioning strategy." +msgstr "" + +# ad78f1eac13349fb9c5e1f2d29898915 +#: ../../using/selecting.md:18 +msgid "jupyter/base-notebook" +msgstr "" + +# 7eb0e89ad7444281a4b571f8b8ae0e89 +# 838bb6c7b9e044ab8c92b1ccdec2bb11 +# f378336c6e4e4a46a4001cae350d6199 +# 530ae4daf0fe4fec95b195912d46f61d +# 533bf0d50c5a4455854d251c0af1fc2d +# 8887645ecbec4f43857537709e20f4e2 +# 9a6a5802dfc243f8b4746d7b0f6f35b3 +# ec4654635f8c4d79ae4f46b5b7d9824b +#: ../../using/selecting.md:20 ../../using/selecting.md:37 +#: ../../using/selecting.md:49 ../../using/selecting.md:63 +#: ../../using/selecting.md:76 ../../using/selecting.md:87 +#: ../../using/selecting.md:100 ../../using/selecting.md:112 +msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags" +msgstr "" + +# 19e8cc4d204d4fcd853e5e98b088f1c5 +#: ../../using/selecting.md:24 +msgid "" +"jupyter/base-notebook is a small image supporting the options common " +"across all core stacks. It is the basis for all other stacks." +msgstr "" + +# abe2bd4773244867b879cfcd19febba1 +#: ../../using/selecting.md:26 +msgid "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" +msgstr "" + +# a42389a1eb89450da6aca8acd393ca39 +#: ../../using/selecting.md:27 +msgid "Miniconda Python 3.x in /opt/conda" +msgstr "" + +# 25f397007c0f4db5a1ea1de455b638d0 +#: ../../using/selecting.md:28 +msgid "No preinstalled scientific computing packages" +msgstr "" + +# f9119a342ec34931abcd73eed074a7b0 +#: ../../using/selecting.md:29 +msgid "" +"Unprivileged user jovyan (uid=1000, configurable, see options) in group " +"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths" +msgstr "" + +# ccaf8853148e4d06b7fb86cf5788e053 +#: ../../using/selecting.md:30 +msgid "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" +msgstr "" + +# 5df136e2752645579d66021ed3bce9d9 +#: ../../using/selecting.md:31 +msgid "A start-singleuser.sh script useful for launching containers in JupyterHub" +msgstr "" + +# 54cb2007aaba4dbf86693d23f065f9e1 +#: ../../using/selecting.md:32 +msgid "" +"A start.sh script useful for running alternative commands in the " +"container (e.g. ipython, jupyter kernelgateway, jupyter lab)" +msgstr "" + +# 6276758896934d1a95e201188ca88581 +#: ../../using/selecting.md:33 +msgid "Options for a self-signed HTTPS certificate and passwordless sudo" +msgstr "" + +# 79f980cbfd974e008ded2250b54f8883 +#: ../../using/selecting.md:35 +msgid "jupyter/minimal-notebook" +msgstr "" + +# 9b4d477117294b2bb5b43d8652a91411 +#: ../../using/selecting.md:41 +msgid "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." +msgstr "" + +# 5e4b7b7c197d42269cea410998165328 +#: ../../using/selecting.md:43 +msgid "Everything in jupyter/base-notebook" +msgstr "" + +# 8ffa13035bc94e8094923da873afffc0 +#: ../../using/selecting.md:44 +msgid "Pandoc and TeX Live for notebook document conversion" +msgstr "" + +# 6a8674b3982d418588c44c51c5333332 +#: ../../using/selecting.md:45 +msgid "git, emacs, jed, nano, tzdata, and unzip" +msgstr "" + +# 1d7b56913ee14365bf3e6c151cfeed30 +#: ../../using/selecting.md:47 +msgid "jupyter/r-notebook" +msgstr "" + +# 4e739543ae274c89a73b86a2e2dbfaf3 +#: ../../using/selecting.md:53 +msgid "jupyter/r-notebook includes popular packages from the R ecosystem." +msgstr "" + +# 3fb4f35b1ea94491a43ffa8ffeb964a3 +# 7be6194575844080a173a1d4af5a46da +#: ../../using/selecting.md:55 ../../using/selecting.md:69 +msgid "Everything in jupyter/minimal-notebook and its ancestor images" +msgstr "" + +# 5630c81956d6488881eed4aa4f788096 +#: ../../using/selecting.md:56 +msgid "The R interpreter and base environment" +msgstr "" + +# b64173b2d08a485ea32a05f12622fdc1 +# 4f8609f03211436eb3c1d63133982858 +#: ../../using/selecting.md:57 ../../using/selecting.md:119 +msgid "IRKernel to support R code in Jupyter notebooks" +msgstr "" + +# 86a316eba14944cba3dc611949d0fab8 +#: ../../using/selecting.md:58 +msgid "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, " +"tibble, stringr, lubridate, and broom from conda-forge" +msgstr "" + +# bc3f6ff1c7dd4b8ca53e3814a83dfd35 +#: ../../using/selecting.md:59 +msgid "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, " +"nycflights13, caret, rcurl, and randomforest packages from conda-forge" +msgstr "" + +# 5222f4d373c84249a4ba0480fb8db3a8 +#: ../../using/selecting.md:61 +msgid "jupyter/scipy-notebook" +msgstr "" + +# 700f5e415b1d41d8b378e09624094d74 +#: ../../using/selecting.md:67 +msgid "" +"jupyter/scipy-notebook includes popular packages from the scientific " +"Python ecosystem." +msgstr "" + +# 0e9b3eff7379426489b766e66a8d45b8 +#: ../../using/selecting.md:70 +msgid "" +"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, " +"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, " +"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages" +msgstr "" + +# bf633775d17141bd9d4308406b0fab85 +#: ../../using/selecting.md:71 +msgid "ipywidgets for interactive visualizations in Python notebooks" +msgstr "" + +# a380ec62a87649509a3c0192a6b001f5 +#: ../../using/selecting.md:72 +msgid "Facets for visualizing machine learning datasets" +msgstr "" + +# ab5fb5a329c34d648eec5edb3da42bb5 +#: ../../using/selecting.md:74 +msgid "jupyter/tensorflow-notebook" +msgstr "" + +# 47dce5b8eeb849a9a56f93a4570b6f09 +#: ../../using/selecting.md:80 +msgid "" +"jupyter/tensorflow-notebook includes popular Python deep learning " +"libraries." +msgstr "" + +# b141cf514f5d4effa57ebb81cb6bd1ed +# 8b1be211fcc940ef9e20c661df60d2ad +#: ../../using/selecting.md:82 ../../using/selecting.md:106 +msgid "Everything in jupyter/scipy-notebook and its ancestor images" +msgstr "" + +# 1bfc470730d6484984c1f365bb056de1 +#: ../../using/selecting.md:83 +msgid "tensorflow and keras machine learning libraries" +msgstr "" + +# 505a7e4bf3614f919bca04234179ee09 +#: ../../using/selecting.md:85 +msgid "jupyter/datascience-notebook" +msgstr "" + +# cef11c0bcecc4b80832e78d2b1d1330a +#: ../../using/selecting.md:91 +msgid "" +"jupyter/datascience-notebook includes libraries for data analysis from " +"the Julia, Python, and R communities." +msgstr "" + +# 19bd5d1f94cb49f383d759bfa3f9dce6 +#: ../../using/selecting.md:93 +msgid "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, " +"and their ancestor images" +msgstr "" + +# 839a27e685d544788f93350789fc4c69 +#: ../../using/selecting.md:94 +msgid "The Julia compiler and base environment" +msgstr "" + +# 389dacb00a264c899cad2518c1203fe4 +#: ../../using/selecting.md:95 +msgid "IJulia to support Julia code in Jupyter notebooks" +msgstr "" + +# 9d560201cf654dc1b14153793258e3a3 +#: ../../using/selecting.md:96 +msgid "HDF5, Gadfly, and RDatasets packages" +msgstr "" + +# 93a7dcfdca074fdb87e92efbadc5fa73 +#: ../../using/selecting.md:98 +msgid "jupyter/pyspark-notebook" +msgstr "" + +# 576bec9122ce405a9a162ef1f21413ca +#: ../../using/selecting.md:104 +msgid "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." +msgstr "" + +# 3e64994adabf403ebd4111e7fe4e8c66 +#: ../../using/selecting.md:107 +msgid "Apache Spark with Hadoop binaries" +msgstr "" + +# 94aa3a29350441079731fda40ba4c0ab +#: ../../using/selecting.md:108 +msgid "Mesos client libraries" +msgstr "" + +# 1cdbad177653419e86d26e56bdf71a47 +#: ../../using/selecting.md:110 +msgid "jupyter/all-spark-notebook" +msgstr "" + +# a122e974fa11467b814b190d24e29a7c +#: ../../using/selecting.md:116 +msgid "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for " +"Apache Spark, optionally on Mesos." +msgstr "" + +# 10ec575fffcd4a9f9d0d8c95250ee316 +#: ../../using/selecting.md:118 +msgid "Everything in jupyter/pyspark-notebook and its ancestor images" +msgstr "" + +# 8f59798f190f4a87b7e4855922db31e0 +#: ../../using/selecting.md:120 +msgid "Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" +msgstr "" + +# 44a5a2bef65b41ba8dc432fecc6203b7 +#: ../../using/selecting.md:121 +msgid "ggplot2, sparklyr, and rcurl packages" +msgstr "" + +# a8c71c9f788a42de87a58dee32b34139 +#: ../../using/selecting.md:125 +msgid "" +"The following diagram depicts the build dependency tree of the core " +"images. (i.e., the FROM statements in their Dockerfiles). Any given image" +" inherits the complete content of all ancestor images pointing to it." +msgstr "" + +# 6c01def83d214a4b92fd6c229c4f50a0 +#: ../../using/selecting.md:129 +msgid "Builds" +msgstr "" + +# d6b5e32382164e2a8efa7a0cc414914a +#: ../../using/selecting.md:131 +msgid "" +"Pull requests to the jupyter/docker-stacks repository trigger builds of " +"all images on Travis CI. These images are for testing purposes only and " +"are not saved for use. When pull requests merge to master, all images " +"rebuild on Docker Cloud and become available to docker pull from Docker " +"Hub." +msgstr "" + +# 1991e435563c4c5b990aed6763504bea +#: ../../using/selecting.md:133 +msgid "Versioning" +msgstr "" + +# 3c74950bf43d45ce93e873da75a8fa7c +#: ../../using/selecting.md:135 +msgid "" +"The latest tag in each Docker Hub repository tracks the master branch " +"HEAD reference on GitHub. latest is a moving target, by definition, and " +"will have backward-incompatible changes regularly." +msgstr "" + +# 83cd6274afe847dcbe95a453f6fee2e1 +#: ../../using/selecting.md:137 +msgid "" +"Every image on Docker Hub also receives a 12-character tag which " +"corresponds with the git commit SHA that triggered the image build. You " +"can inspect the state of the jupyter/docker-stacks repository for that " +"commit to review the definition of the image (e.g., images with tag " +"7c45ec67c8e7 were built from https://github.com/jupyter/docker-" +"stacks/tree/7c45ec67c8e7)." +msgstr "" + +# 9de32dc00e7c45138197eecca9018dd5 +#: ../../using/selecting.md:139 +msgid "" +"You must refer to git-SHA image tags when stability and reproducibility " +"are important in your work. (e.g. FROM jupyter/scipy-" +"notebook:7c45ec67c8e7, docker run -it --rm jupyter/scipy-" +"notebook:7c45ec67c8e7). You should only use latest when a one-off " +"container instance is acceptable (e.g., you want to briefly try a new " +"library in a notebook)." +msgstr "" + +# a3c6faf51ba6492499382b8c31a2d76f +#: ../../using/selecting.md:143 +msgid "" +"The core stacks are just a tiny sample of what's possible when combining " +"Jupyter with other technologies. We encourage members of the Jupyter " +"community to create their own stacks based on the core images and link " +"them below." +msgstr "" + +# 5e06096348924f51881d05f984e91381 +#: ../../using/selecting.md:145 +msgid "This list only has 2 examples. You can be the next!" +msgstr "" + +# 978ce64398404c889fb00f07b5a0c6c8 +#: ../../using/selecting.md:147 +msgid "" +"csharp-notebook is a community Jupyter Docker Stack image. Try C# in " +"Jupyter Notebooks. The image includes more than 200 Jupyter Notebooks " +"with example C# code and can readily be tried online via mybinder.org. " +"Click here to launch ." +msgstr "" + +# 76eb0a1648324472a6555850b70ca3bc +#: ../../using/selecting.md:149 +msgid "" +"education-notebook is a community Jupyter Docker Stack image. The image " +"includes nbgrader and RISE on top of the datascience-notebook image. " +"Click here to launch it on ." +msgstr "" + +# b1892840b7b24962bdd9485e0f6d1ead +#: ../../using/selecting.md:151 +msgid "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." +msgstr "" + +# e8bd6dfe48a44bd09804fa04b72e1471 +#: ../../using/specifics.md:1 +msgid "Image Specifics" +msgstr "" + +# c1ab9b1a320a4f28ae49e578627595ef +#: ../../using/specifics.md:3 +msgid "This page provides details about features specific to one or more images." +msgstr "" + +# 4d189fd621134ee58b72055d032387ca +#: ../../using/specifics.md:5 +msgid "Apache Spark" +msgstr "" + +# 1ebe3699513d44bc99f6d3eb8a9fe5b8 +#: ../../using/specifics.md:7 +msgid "" +"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images " +"support the use of Apache Spark in Python, R, and Scala notebooks. The " +"following sections provide some examples of how to get started using " +"them." +msgstr "" + +# 02762daed83646c3bb92b8a2952f237a +#: ../../using/specifics.md:9 +msgid "Using Spark Local Mode" +msgstr "" + +# 17b34b37b2514f7f8a03d3e7bbb5b609 +#: ../../using/specifics.md:11 +msgid "" +"Spark local mode is useful for experimentation on small data when you do " +"not have a Spark cluster available." +msgstr "" + +# 13d15d820e4a481eaefbe6bd53728a7c +# 3bfab29528ae44029716add6192b627c +#: ../../using/specifics.md:13 ../../using/specifics.md:69 +msgid "In a Python Notebook" +msgstr "" + +# 3dc8937d38fe423c91bce4a44bbec105 +# 015f2179b4cb497889a8bd64f8816377 +#: ../../using/specifics.md:22 ../../using/specifics.md:96 +msgid "In a R Notebook" +msgstr "" + +# ba52f62ac0e04181a5ab3cd51ef3480a +# 569dd56bba454440a3ee598683a0f822 +#: ../../using/specifics.md:34 ../../using/specifics.md:117 +msgid "In a Spylon Kernel Scala Notebook" +msgstr "" + +# f6f29ad5fbe843f79496da70a040a345 +#: ../../using/specifics.md:36 +#, python-format +msgid "" +"Spylon kernel instantiates a SparkContext for you in variable sc after " +"you configure Spark options in a %%init_spark magic cell." +msgstr "" + +# 931c98145855457d916b7b89d9dc718a +# 00a1f40cf41b4896a3fde7251feb0809 +#: ../../using/specifics.md:50 ../../using/specifics.md:132 +msgid "In an Apache Toree Scala Notebook" +msgstr "" + +# 03ef9966ede74a97b04e1854b1c79cda +#: ../../using/specifics.md:52 +msgid "" +"Apache Toree instantiates a local SparkContext for you in variable sc " +"when the kernel starts." +msgstr "" + +# baac8bfd2f0e49b0bce9b645a735c02a +#: ../../using/specifics.md:59 +msgid "Connecting to a Spark Cluster on Mesos" +msgstr "" + +# 32218f10947a486888a1429452f21e5e +#: ../../using/specifics.md:61 +msgid "This configuration allows your compute cluster to scale with your data." +msgstr "" + +# 6f13341afbce4709ab138670ad666fcc +#: ../../using/specifics.md:63 +msgid "Deploy Spark on Mesos." +msgstr "" + +# d1865378f23942afb087c79b8be9ef76 +#: ../../using/specifics.md:64 +msgid "" +"Configure each slave with the --no-switch_user flag or create the " +"$NB_USER account on every slave node." +msgstr "" + +# 574e9a6c755e441386d96ec5bd5db6cf +# ea2a7da5b48240b78ffb98f4dd3c6fa8 +#: ../../using/specifics.md:65 ../../using/specifics.md:161 +msgid "" +"Run the Docker container with --net=host in a location that is network " +"addressable by all of your Spark workers. (This is a Spark networking " +"requirement.)" +msgstr "" + +# 219499497367418bbb05718852cf1463 +# 4daffa53b58d4576aec1181c8a4d5947 +#: ../../using/specifics.md:66 ../../using/specifics.md:162 +msgid "" +"NOTE: When using --net=host, you must also use the flags --pid=host -e " +"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-" +"stacks/issues/64 for details." +msgstr "" + +# dc09dc0efca6464aa9ac1dd6a6a7ab0b +#: ../../using/specifics.md:67 +msgid "Follow the language specific instructions below." +msgstr "" + +# 4a61e4180b0c4a569f6bc0757ab09a69 +#: ../../using/specifics.md:134 +msgid "" +"The Apache Toree kernel automatically creates a SparkContext when it " +"starts based on configuration information from its command line arguments" +" and environment variables. You can pass information about your Mesos " +"cluster via the SPARK_OPTS environment variable when you spawn a " +"container." +msgstr "" + +# 7647d636b1f444eab30838ba3a8ff889 +#: ../../using/specifics.md:136 +msgid "" +"For instance, to pass information about a Mesos master, Spark binary " +"location in HDFS, and an executor options, you could start the container " +"like so:" +msgstr "" + +# fc231a361033452498d26ddc435a2d48 +#: ../../using/specifics.md:144 +msgid "" +"Note that this is the same information expressed in a notebook in the " +"Python case above. Once the kernel spec has your cluster information, you" +" can test your cluster in an Apache Toree notebook like so:" +msgstr "" + +# d20fe02617394234a8c2d400162a88d3 +#: ../../using/specifics.md:155 +msgid "Connecting to a Spark Cluster in Standalone Mode" +msgstr "" + +# 3ca478a816eb4cc996e656df0c4738d8 +#: ../../using/specifics.md:157 +msgid "" +"Connection to Spark Cluster on Standalone Mode requires the following set" +" of steps:" +msgstr "" + +# f93abc3c1c004ec2871acfb9a233952b +#: ../../using/specifics.md:159 +msgid "" +"Verify that the docker image (check the Dockerfile) and the Spark Cluster" +" which is being deployed, run the same version of Spark." +msgstr "" + +# cb5a7b58234c42fbb75ccfedab7dd607 +#: ../../using/specifics.md:160 +msgid "Deploy Spark in Standalone Mode." +msgstr "" + +# 84ac8ee338244480ae2363ace97f39bb +#: ../../using/specifics.md:163 +msgid "" +"The language specific instructions are almost same as mentioned above for" +" Mesos, only the master url would now be something like " +"spark://10.10.10.10:7077" +msgstr "" + +# 5e2d68073fa34580ab031a31f91f7f31 +#: ../../using/specifics.md:165 +msgid "Tensorflow" +msgstr "" + +# 3b854359945548279e7addfecaef9492 +#: ../../using/specifics.md:167 +msgid "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." +msgstr "" + +# 0d42c934f9024f58bf2fd0e978f1e750 +#: ../../using/specifics.md:169 +msgid "Single Machine Mode" +msgstr "" + +# 62b50887e594424dbd129e2326931ff2 +#: ../../using/specifics.md:183 +msgid "Distributed Mode" +msgstr "" + diff --git a/docs/locale/it/LC_MESSAGES/contributing.po b/docs/locale/it/LC_MESSAGES/contributing.po new file mode 100644 index 0000000000..fa379ab44c --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/contributing.po @@ -0,0 +1,631 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: it\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +# 9527c87037fb4592a05d144d80f69f89 +#: ../../contributing/features.md:1 +msgid "New Features" +msgstr "" + +# 81de205103144b289398603fa4aee789 +#: ../../contributing/features.md:3 +msgid "" +"Thank you for contributing to the Jupyter Docker Stacks! We review pull " +"requests of new features (e.g., new packages, new scripts, new flags) to " +"balance the value of the images to the Jupyter community with the cost of " +"maintaining the images over time." +msgstr "" + +# b35331d86206420aa8235d20ef037215 +#: ../../contributing/features.md:5 +msgid "Suggesting a New Feature" +msgstr "" + +# 6c6b00518c1f4dc88049b82f213a36cc +#: ../../contributing/features.md:7 +msgid "" +"Please follow the process below to suggest a new feature for inclusion in " +"one of the core stacks:" +msgstr "" + +# a9cd9d0730cc4159aa227e970ae2d9d0 +#: ../../contributing/features.md:9 +msgid "Open a GitHub issue describing the feature you'd like to contribute." +msgstr "" + +# 8433ea2c70b94556b9a62c35cb88a4c8 +#: ../../contributing/features.md:10 +msgid "" +"Discuss with the maintainers whether the addition makes sense in one of the " +"core stacks, as a recipe in the documentation, as a community stack, or as " +"something else entirely." +msgstr "" + +# a995c15adfb7424e9852693b90569d7a +#: ../../contributing/features.md:12 +msgid "Selection Criteria" +msgstr "" + +# 981cef217f4e4225984c5c7989f592f8 +#: ../../contributing/features.md:14 +msgid "" +"Roughly speaking, we evaluate new features based on the following criteria:" +msgstr "" + +# 32194c09119e428a871acb859d696500 +#: ../../contributing/features.md:16 +msgid "" +"Usefulness to Jupyter users: Is the feature generally applicable across " +"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?" +msgstr "" + +# 7b5acf7ef5854ac4b2c55b1a51464796 +#: ../../contributing/features.md:17 +msgid "" +"Fit with the image purpose: Does the feature match the theme of the stack in" +" which it will be added? Would it fit better in a new, community stack?" +msgstr "" + +# 55d1f51c3b264dcfb252771c83d8ca36 +#: ../../contributing/features.md:18 +msgid "" +"Complexity of build / runtime configuration: How many lines of code does the" +" feature require in one of the Dockerfiles or startup scripts? Does it " +"require new scripts entirely? Do users need to adjust how they use the " +"images?" +msgstr "" + +# 2a332f3b95064b43a1833166fd84f53c +#: ../../contributing/features.md:19 +msgid "" +"Impact on image metrics: How many bytes does the feature and its " +"dependencies add to the image(s)? How many minutes do they add to the build " +"time?" +msgstr "" + +# 30966a8cde0844bd85f6114c65f79ec4 +#: ../../contributing/features.md:20 +msgid "" +"Ability to support the addition: Can existing maintainers answer user " +"questions and address future build issues? Are the contributors interested " +"in helping with long-term maintenance? Can we write tests to ensure the " +"feature continues to work over time?" +msgstr "" + +# 6085a8c0829e411588a37777bfe5e0f4 +#: ../../contributing/features.md:22 +msgid "Submitting a Pull Request" +msgstr "" + +# fa5dc8dbaedb483b888622cc9d1e94ae +#: ../../contributing/features.md:24 +msgid "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" +msgstr "" + +# 23ae2ae62bdb4a35bc42d9efc7759944 +#: ../../contributing/features.md:26 +msgid "" +"Implement the feature in a local clone of the jupyter/docker-stacks project." +msgstr "" + +# ef476261493c48d998fb384d651b4012 +#: ../../contributing/features.md:27 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 6bd20fd181f44e39a4913154db0c7221 +# 4277e486510d49a08448d209a5cdad69 +# f8c596a67a4f43c1a1c82a0f38a846f7 +#: ../../contributing/features.md:31 ../../contributing/packages.md:13 +#: ../../contributing/tests.md:20 +msgid "Submit a pull request (PR) with your changes." +msgstr "" + +# a7aa4a8d9d3d44eda2f1cf757e569c4e +# d8f1d1f00b2a4e9690b4e0da736ac662 +# e4f93545f2284342a2b3ad1f52eaf26c +#: ../../contributing/features.md:32 ../../contributing/packages.md:14 +#: ../../contributing/tests.md:21 +msgid "" +"Watch for Travis to report a build success or failure for your PR on GitHub." +msgstr "" + +# f80657a299424b8685d452d70479bae6 +#: ../../contributing/features.md:33 +msgid "Discuss changes with the maintainers and address any build issues." +msgstr "" + +# 57ead3e81b9b4ebaa7a3491818f60089 +#: ../../contributing/issues.md:1 +msgid "Project Issues" +msgstr "" + +# f27080bf0c8d43a08f283b3c5e28ddc7 +#: ../../contributing/issues.md:3 +msgid "" +"We appreciate your taking the time to report an issue you encountered using " +"the Jupyter Docker Stacks. Please review the following guidelines when " +"reporting your problem." +msgstr "" + +# 3713984479614d4aa9237328bc2e233b +#: ../../contributing/issues.md:7 +msgid "" +"If you believe you’ve found a security vulnerability in any of the Jupyter " +"projects included in Jupyter Docker Stacks images, please report it to " +"security@ipython.org, not in the issue trackers on GitHub. If you prefer to " +"encrypt your security reports, you can use this PGP public key." +msgstr "" + +# 0c7fad6ee9304bbe80baf1737d0f478c +#: ../../contributing/issues.md:13 +msgid "" +"If you think your problem is unique to the Jupyter Docker Stacks images, " +"please search the jupyter/docker-stacks issue tracker to see if someone else" +" has already reported the same problem. If not, please open a new issue and " +"provide all of the information requested in the issue template." +msgstr "" + +# 70860cacf75b40a687363712f3bf00ce +#: ../../contributing/issues.md:19 +msgid "" +"If the issue you're seeing is with one of the open source libraries included" +" in the Docker images and is reproducible outside the images, please file a " +"bug with the appropriate open source project." +msgstr "" + +# 76822159e56f40f3bb38ea93e054238c +#: ../../contributing/issues.md:22 +msgid "" +"If you have a general question about how to use the Jupyter Docker Stacks in" +" your environment, in conjunction with other tools, with customizations, and" +" so on, please post your question on the Jupyter Discourse site." +msgstr "" + +# 3815aec9c791444cbdf26a71e28a1f7c +#: ../../contributing/packages.md:1 +msgid "Package Updates" +msgstr "" + +# 0bc1f6af65c74cc5a812a14b9c5a055f +#: ../../contributing/packages.md:3 +msgid "" +"We actively seek pull requests which update packages already included in the" +" project Dockerfiles. This is a great way for first-time contributors to " +"participate in developing the Jupyter Docker Stacks." +msgstr "" + +# ff8faef49758489fb97ddaba60763a0e +#: ../../contributing/packages.md:5 +msgid "Please follow the process below to update a package version:" +msgstr "" + +# e3878a1a1a444bb592fe32f468693ed7 +#: ../../contributing/packages.md:7 +msgid "" +"Locate the Dockerfile containing the library you wish to update (e.g., base-" +"notebook/Dockerfile, scipy-notebook/Dockerfile)" +msgstr "" + +# d5aac81ecab24592860296ab74936724 +#: ../../contributing/packages.md:8 +msgid "" +"Adjust the version number for the package. We prefer to pin the major and " +"minor version number of packages so as to minimize rebuild side-effects when" +" users submit pull requests (PRs). For example, you'll find the Jupyter " +"Notebook package, notebook, installed using conda with notebook=5.4.*." +msgstr "" + +# 0eed3a80d95146bab769d4456addcce4 +#: ../../contributing/packages.md:9 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 1be104e942024f2b98eb10e0006b9de3 +#: ../../contributing/packages.md:15 +msgid "" +"Discuss changes with the maintainers and address any build issues. Version " +"conflicts are the most common problem. You may need to upgrade additional " +"packages to fix build failures." +msgstr "" + +# adf5db8b690d466a8d339c756a5a153c +#: ../../contributing/recipes.md:1 +msgid "New Recipes" +msgstr "" + +# 7d306f8fe4a641e4a48b61111c16b8e8 +#: ../../contributing/recipes.md:3 +msgid "" +"We welcome contributions of recipes, short examples of using, configuring, " +"or extending the Docker Stacks, for inclusion in the documentation site. " +"Follow the process below to add a new recipe:" +msgstr "" + +# 5b84ed1b594845ec81f39b87e7c5d82b +#: ../../contributing/recipes.md:5 +msgid "Open the docs/using/recipes.md source file." +msgstr "" + +# 52f2b459bff447fe82c60ea02c4e751c +#: ../../contributing/recipes.md:6 +msgid "" +"Add a second-level Markdown heading naming your recipe at the bottom of the " +"file (e.g., `## Add the RISE extension``)" +msgstr "" + +# 56b4b4356d3e45f5bbe6eb14f9540628 +#: ../../contributing/recipes.md:7 +msgid "" +"Write the body of your recipe under the heading, including whatever command " +"line, Dockerfile, links, etc. you need." +msgstr "" + +# 6a3115ec07cf42a28c755a607658f855 +# f4f9a3d6544b4e4087e97124098459eb +#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111 +msgid "" +"Submit a pull request (PR) with your changes. Maintainers will respond and " +"work with you to address any formatting or content issues." +msgstr "" + +# 0b8332c390304a1ab29a4b2b030e7997 +#: ../../contributing/stacks.md:1 +msgid "Community Stacks" +msgstr "" + +# 69ee7d697c7240b78ea8c7873fc1528b +#: ../../contributing/stacks.md:3 +msgid "" +"We love to see the community create and share new Jupyter Docker images. " +"We've put together a cookiecutter project and the documentation below to " +"help you get started defining, building, and sharing your Jupyter " +"environments in Docker. Following these steps will:" +msgstr "" + +# 0f392d5680ba4ea2812ff450f8e19d44 +#: ../../contributing/stacks.md:5 +msgid "" +"Setup a project on GitHub containing a Dockerfile based on either the " +"jupyter/base-notebook or jupyter/minimal-notebook image." +msgstr "" + +# c05df9d2cf8c4505b0951f0ea88f1daf +#: ../../contributing/stacks.md:6 +msgid "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." +msgstr "" + +# 077482de9feb4fa2b1e5e477fd5591f1 +#: ../../contributing/stacks.md:7 +msgid "" +"Configure Docker Cloud to build and host your images for others to use." +msgstr "" + +# e2fe70e1ea6e4322a8dfa4380f8e54bb +#: ../../contributing/stacks.md:8 +msgid "" +"Update the list of community stacks in this documentation to include your " +"image." +msgstr "" + +# 3af1a3dc1eae4a7d96a883b911fc5894 +#: ../../contributing/stacks.md:10 +msgid "" +"This approach mirrors how we build and share the core stack images. Feel " +"free to follow it or pave your own path using alternative services and build" +" tools." +msgstr "" + +# 0107f213096c41c8b1cb367b84fee30d +#: ../../contributing/stacks.md:12 +msgid "Creating a Project" +msgstr "" + +# cb35d196dc42402f9b338e56fcd3faa6 +#: ../../contributing/stacks.md:14 +msgid "First, install cookiecutter using pip or conda:" +msgstr "" + +# 09066f77e38c42889844dafb226df4bd +#: ../../contributing/stacks.md:20 +msgid "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." +msgstr "" + +# 26f05981d3fe49abb07bba85a4a3890f +#: ../../contributing/stacks.md:26 +msgid "" +"Enter a name for your new stack image. This will serve as both the git " +"repository name and the part of the Docker image name after the slash." +msgstr "" + +# c6aba910076b49ca97dcb902f13d2a4d +#: ../../contributing/stacks.md:33 +msgid "" +"Enter the user or organization name under which this stack will reside on " +"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in " +"order to push images here and setup automated builds." +msgstr "" + +# 176a346034074822b7634c6c86dace42 +#: ../../contributing/stacks.md:41 +msgid "" +"Select an image from the jupyter/docker-stacks project that will serve as " +"the base for your new image." +msgstr "" + +# 3611e7452640414d9d0535292abd113d +#: ../../contributing/stacks.md:48 +msgid "Enter a longer description of the stack for your README." +msgstr "" + +# 782321361a3b4116a2d3dafa7cc1424f +#: ../../contributing/stacks.md:54 +msgid "Initialize your project as a Git repository and push it to GitHub." +msgstr "" + +# b699fe5155774c93938427a241d0f239 +#: ../../contributing/stacks.md:66 +msgid "Configuring Travis" +msgstr "" + +# 6440a7c3a9444dda88445913807d1a48 +#: ../../contributing/stacks.md:68 +msgid "" +"Next, link your GitHub project to Travis CI to build your Docker image " +"whenever you or someone else submits a pull request." +msgstr "" + +# c0613debece54f82a922700157994c5b +#: ../../contributing/stacks.md:70 +msgid "" +"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-" +"Travis-CI and follow the instructions to add the Travis CI application to " +"your GitHub account." +msgstr "" + +# 4cf36f34a47b410a982be3237af720cd +#: ../../contributing/stacks.md:71 +msgid "Visit https://travis-ci.org." +msgstr "" + +# fdd694f5ebf443ce9d2d220d5945c299 +#: ../../contributing/stacks.md:72 +msgid "Click the + symbol at the top of the left sidebar." +msgstr "" + +# 05acff6addad4f919fe21c27329b1e51 +#: ../../contributing/stacks.md:74 +msgid "" +"Locate your project repository either in your primary user account or in one" +" of the organizations to which you belong." +msgstr "" + +# a1917b1360434fb18a3522e0a9806a11 +#: ../../contributing/stacks.md:75 +msgid "Click the toggle to enable builds for the project repository." +msgstr "" + +# 7dcbafc96c4a4ef88d7bc34e31a0af04 +#: ../../contributing/stacks.md:76 +msgid "Click the Settings button for that repository." +msgstr "" + +# dd006e53f5cc4c1ea1501d62119f526e +#: ../../contributing/stacks.md:78 +msgid "" +"Enable Build only if .travis.yml is present and Build pushed pull requests." +msgstr "" + +# 0a5e54cd5f294a52983c2ec73559f810 +#: ../../contributing/stacks.md:80 +msgid "Disable Build pushed branches." +msgstr "" + +# 2ddf5289794648a3b7d1f604ce744331 +#: ../../contributing/stacks.md:82 +msgid "Configuring Docker Cloud" +msgstr "" + +# 5108ce3f722a430eb29e1a5928a86fcf +#: ../../contributing/stacks.md:84 +msgid "" +"Now, configure Docker Cloud to build your stack image and push it to Docker " +"Hub repository whenever you merge a GitHub pull request to the master branch" +" of your project." +msgstr "" + +# 7ab258ec2f1e4942a983996a6c5e6fa5 +#: ../../contributing/stacks.md:86 +msgid "Visit https://cloud.docker.com/ and login." +msgstr "" + +# 3677166ebbc04b2aafc4f117e33f6bf5 +#: ../../contributing/stacks.md:87 +msgid "" +"Select the account or organization matching the one you entered when " +"prompted with stack_org by the cookiecutter." +msgstr "" + +# 0997628fd41449c5b0598e7e1bf1f005 +#: ../../contributing/stacks.md:89 +msgid "Scroll to the bottom of the page and click Create repository." +msgstr "" + +# 8504105c95594c288fdd9066006757b0 +#: ../../contributing/stacks.md:90 +msgid "" +"Enter the name of the image matching the one you entered when prompted with " +"stack_name by the cookiecutter." +msgstr "" + +# c92796a106c846f585c88fb5a015fa6d +#: ../../contributing/stacks.md:92 +msgid "Enter a description for your image." +msgstr "" + +# fba832c82f3042499563598365fedfd5 +#: ../../contributing/stacks.md:93 +msgid "" +"Click GitHub under the Build Settings and follow the prompts to connect your" +" account if it is not already connected." +msgstr "" + +# bff3581410014975943ca77637142f14 +#: ../../contributing/stacks.md:94 +msgid "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." +msgstr "" + +# 72cbc93bfe354e279e9384e7c95c801b +#: ../../contributing/stacks.md:96 +msgid "Click the Create and Build button." +msgstr "" + +# bbb495328efd4fe7b339b7a7ffe908b0 +#: ../../contributing/stacks.md:98 +msgid "Defining Your Image" +msgstr "" + +# 60052c2d1afc4a57baa59c1bf22d321c +#: ../../contributing/stacks.md:100 +msgid "" +"Make edits the Dockerfile in your project to add third-party libraries and " +"configure Jupyter applications. Refer to the Dockerfiles for the core stacks" +" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and " +"best practices." +msgstr "" + +# 0855b53115ae4b6780cc82c9389224cb +#: ../../contributing/stacks.md:102 +msgid "" +"Submit pull requests to your project repository on GitHub. Ensure your image" +" builds properly on Travis before merging to master. Refer to Docker Cloud " +"for builds of your master branch that you can docker pull." +msgstr "" + +# de4bcc6e0ac1468ea761c038661ca19f +#: ../../contributing/stacks.md:104 +msgid "Sharing Your Image" +msgstr "" + +# a67495f9ae984a368364a698084f060e +#: ../../contributing/stacks.md:106 +msgid "" +"Finally, if you'd like to add a link to your project to this documentation " +"site, please do the following:" +msgstr "" + +# 7357ed96047e42e6ae9e4bf123a00bed +#: ../../contributing/stacks.md:108 +msgid "Clone ths jupyter/docker-stacks GitHub repository." +msgstr "" + +# ee9284fe69244dcd8d44b25b8dc8b3a2 +#: ../../contributing/stacks.md:109 +msgid "" +"Open the docs/using/selecting.md source file and locate the Community Stacks" +" section." +msgstr "" + +# aa0e41b99c354b5b88336489084e2006 +#: ../../contributing/stacks.md:110 +msgid "" +"Add a bullet with a link to your project and a short description of what " +"your Docker image contains." +msgstr "" + +# 0f652c5259d544b595e847365dfe843a +#: ../../contributing/tests.md:1 +msgid "Image Tests" +msgstr "" + +# 569da0112572470b9bc5f045bcfb49d0 +#: ../../contributing/tests.md:3 +msgid "" +"We greatly appreciate pull requests that extend the automated tests that vet" +" the basic functionality of the Docker images." +msgstr "" + +# 67b27592447e47af8b0b00eeb745fc70 +#: ../../contributing/tests.md:5 +msgid "How the Tests Work" +msgstr "" + +# e2c3d76accff489eb2a6eab7b55ae3be +#: ../../contributing/tests.md:7 +msgid "" +"Travis executes make build-test-all against every pull request submitted to " +"the jupyter/docker-stacks repository. The make command builds every docker " +"image. After building each image, the make command executes pytest to run " +"both image-specific tests like those in base-notebook/test/ and common tests" +" defined in test/. Both kinds of tests make use of global pytest fixtures " +"defined in the conftest.py file at the root of the projects." +msgstr "" + +# 15207b72b26741f0a6a77949a4d9d0f4 +#: ../../contributing/tests.md:9 +msgid "Contributing New Tests" +msgstr "" + +# 5470865e6d144e51a428221e49e448fb +#: ../../contributing/tests.md:11 +msgid "Please follow the process below to add new tests:" +msgstr "" + +# 36aedaa2624c4e4493af145bc5f246e0 +#: ../../contributing/tests.md:13 +msgid "" +"If the test should run against every image built, add your test code to one " +"of the modules in test/ or create a new module." +msgstr "" + +# dccbb0425be7438db7ade2f4892c6c25 +#: ../../contributing/tests.md:14 +msgid "" +"If your test should run against a single image, add your test code to one of" +" the modules in some-notebook/test/ or create a new module." +msgstr "" + +# 33ab248b51d24fa0b29923489bf6dfbf +#: ../../contributing/tests.md:15 +msgid "" +"Build one or more images you intend to test and run the tests locally. If " +"you use make, call:" +msgstr "" + +# 0453d92037cb4e47a025bc9021bdc7db +#: ../../contributing/tests.md:22 +msgid "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." +msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/index.po b/docs/locale/it/LC_MESSAGES/index.po new file mode 100644 index 0000000000..68e8aafc36 --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/index.po @@ -0,0 +1,175 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Nicola Landolfi , 2019 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Last-Translator: Nicola Landolfi , 2019\n" +"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: it\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +# 85291a2c92d440a089cf156fba58b86a +#: ../../index.rst:32 ../../index.rst:32 +msgid "User Guide" +msgstr "Guida Utente" + +# e4a3fd32059d4486b6b0f3a6fb5065b5 +#: ../../index.rst:42 ../../index.rst:42 +msgid "Contributor Guide" +msgstr "Come contribuire" + +# 45de48c8617d4ebe83b7ff7141295836 +#: ../../index.rst:53 ../../index.rst:53 +msgid "Maintainer Guide" +msgstr "Guida per i Maintainer" + +# aa99c4562d8d4cb3abfea375470e8af3 +#: ../../index.rst:59 ../../index.rst:59 +msgid "Getting Help" +msgstr "Assistenza" + +# 76df09037a6147c8a85be8ef14c15532 +#: ../../index.rst:2 +msgid "Jupyter Docker Stacks" +msgstr "Jupyter Docker Stacks" + +# b3fb253184e64174b26a2da73f221cc1 +#: ../../index.rst:4 +msgid "" +"Jupyter Docker Stacks are a set of ready-to-run Docker images containing " +"Jupyter applications and interactive computing tools. You can use a stack " +"image to do any of the following (and more):" +msgstr "" +"Jupyter Docker Stacks consiste in una collezione di immagini Docker pronte " +"all'uso, contenenti applicazioni Jupyter e strumenti per l'interactive " +"computing. Esse permettono di (e non solo):" + +# 8cd55fb113a049e7be445b21084df7ea +#: ../../index.rst:6 +msgid "Start a personal Jupyter Notebook server in a local Docker container" +msgstr "" +"Avviare un server personale Jupyter Notebook all'interno di un container " +"Docker in locale" + +# 285fa13bed8547b4af0cfc480adf4861 +#: ../../index.rst:7 +msgid "Run JupyterLab servers for a team using JupyterHub" +msgstr "Configurare un server JupyterLab da utilizzare con JupyterHub" + +# a49d31cedd4946ea98d7a4c720340d84 +#: ../../index.rst:8 +msgid "Write your own project Dockerfile" +msgstr "Creare Dockerfile personalizzati" + +# 0aff0df2e46a44b4bc8070545e83c42c +#: ../../index.rst:11 +msgid "Quick Start" +msgstr "Per iniziare" + +# 3262accd283140058db73005072be200 +#: ../../index.rst:13 +msgid "" +"You can try a `recent build of the jupyter/base-notebook image on " +"mybinder.org `_ by simply clicking the preceding " +"link. Otherwise, the two examples below may help you get started if you " +"`have Docker installed `_, know " +":doc:`which Docker image ` you want to use, and want to " +"launch a single Jupyter Notebook server in a container." +msgstr "" +"Potete provare `una build recente dell'immagine jupyter/base-notebook su " +"mybinder.org `_ cliccando sul link precedente. " +"Oppure, i due esempi in basso potrebbero aiutarvi a muovere i primi passi se" +" `avete installato Docker `_, avete scelto" +" :doc:` l'immagine da utilizzare ` e volete lanciare un " +"solo server Jupyter Notebook in un container." + +# 9e4094e8de264e20bca0af8f6cf888b7 +#: ../../index.rst:15 +msgid "" +"The other pages in this documentation describe additional uses and features " +"in detail." +msgstr "" +"Le altre pagine di questa documentazione descrivono nel dettaglio le varie " +"funzionalità ed ulteriori casi d'uso." + +# 8b75310f2eaa4aac95d9387e0a4db9e8 +#: ../../index.rst:17 +msgid "" +"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image " +"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the " +"local host. It then starts a container running a Jupyter Notebook server and" +" exposes the server on host port 8888. The server logs appear in the " +"terminal. Visiting ``http://:8888/?token=`` in a browser " +"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of" +" the computer running docker and ``token`` is the secret token printed in " +"the console. The container remains intact for restart after the notebook " +"server exits.::" +msgstr "" +"**Esempio 1:** Questo comando esegue il pull dell'immagine ``jupyter/scipy-" +"notebook`` avente tag ``17aba6048f44`` da Docker Hub se non dovesse essere " +"già presente sull'host locale. Poi avvia un container con un server Jupyter " +"Notebook in ascolto sulla porta 8888 dell'host. I log del server compaiono " +"nel terminale. All'indirizzo ``http://:8888/?token=`` è " +"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del " +"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato " +"sul terminale. L'uscita dal server del notebook lascia intatto il container:" + +# 9e0229c99f404aceb7e517387ae88365 +#: ../../index.rst:21 +msgid "" +"**Example 2:** This command performs the same operations as **Example 1**, " +"but it exposes the server on host port 10000 instead of port 8888. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console.::" +msgstr "" +"**Esempio 2:** Questo comando esegue le stesse operazioni dell'**Esempio " +"1**, ma mette in ascolto il server sulla porta 10000 anziché 8888:" + +# 02c25d3f0abe48348100dd878c243a75 +#: ../../index.rst:25 +msgid "" +"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image" +" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the" +" local host. It then starts an *ephemeral* container running a Jupyter " +"Notebook server and exposes the server on host port 10000. The command " +"mounts the current working directory on the host as ``/home/jovyan/work`` in" +" the container. The server logs appear in the terminal. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console. Docker destroys the container " +"after notebook server exit, but any files written to ``~/work`` in the " +"container remain intact on the host.::" +msgstr "" +"**Esempio 3:** Questo comando esegue il pull dell'immagine ``jupyter" +"/datascience-notebook`` avente tag ``9b06df75e445`` da Docker Hub se non " +"dovesse essere già presente sull'host locale. Poi avvia un container " +"*effimero* con un server Jupyter Notebook in ascolto sulla porta 10000. " +"Inoltre, il comando monta la directory di lavoro corrente dell'host come " +"``/home/jovyan/work`` all'interno del container. I log del server compaiono " +"nel terminale. All'indirizzo ``http://:10000/?token=`` è " +"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del " +"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato " +"sul terminale. Docker distrugge il container all'uscita del server del " +"notebook, tuttavia i file salvati in ``~/work`` all'interno del container " +"restano inalterati sull'host:" + +# 1bc0c7d54cd343d689362047c0b00122 +#: ../../index.rst:30 +msgid "Table of Contents" +msgstr "Indice" diff --git a/docs/locale/it/LC_MESSAGES/maintaining.po b/docs/locale/it/LC_MESSAGES/maintaining.po new file mode 100644 index 0000000000..d0a988b03e --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/maintaining.po @@ -0,0 +1,277 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: it\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +# cefae71d9a804ab69c7e9f0a53eb7475 +#: ../../maintaining/tasks.md:1 +msgid "Maintainer Playbook" +msgstr "" + +# af6a24b053794e55bddfe6e2e21ae74f +#: ../../maintaining/tasks.md:3 +msgid "Merging Pull Requests" +msgstr "" + +# c34b1d3b543346689adbca91331ac048 +#: ../../maintaining/tasks.md:5 +msgid "" +"To build new images on Docker Cloud and publish them to the Docker Hub " +"registry, do the following:" +msgstr "" + +# 1597bb99448f41b994d1c7073b9c8721 +#: ../../maintaining/tasks.md:7 +msgid "Make sure Travis is green for a PR." +msgstr "" + +# 401ed2733771440e8ef089f54cf2984d +#: ../../maintaining/tasks.md:8 +msgid "Merge the PR." +msgstr "" + +# 6d0bf2e7538640a0989e56df3c9d1106 +#: ../../maintaining/tasks.md:9 +msgid "" +"Monitor the Docker Cloud build status for each of the stacks, starting with " +"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the " +"stack hierarchy diagram for the current, complete build order." +msgstr "" + +# 428124fa830d4c74a618d7b3c696599c +#: ../../maintaining/tasks.md:10 +msgid "" +"Manually click the retry button next to any build that fails to resume that " +"build and any dependent builds." +msgstr "" + +# c4034a02dab8435f8d76c2d32321a262 +#: ../../maintaining/tasks.md:11 +msgid "" +"Try to avoid merging another PR to master until all outstanding builds " +"complete. There's no way at present to propagate the git SHA to build " +"through the Docker Cloud build trigger API. Every build trigger works off of" +" master HEAD." +msgstr "" + +# 62ddd25e15064cea950f9f13a663dcdb +#: ../../maintaining/tasks.md:13 +msgid "Updating the Ubuntu Base Image" +msgstr "" + +# 091b1ce707f44bc6ae9742cf55b92ebf +#: ../../maintaining/tasks.md:15 +msgid "" +"When there's a security fix in the Ubuntu base image or after some time " +"passes, it's a good idea to update the pinned SHA in the jupyter/base-" +"notebook Dockerfile. Submit it as a regular PR and go through the build " +"process. Expect the build to take a while to complete: every image layer " +"will rebuild." +msgstr "" + +# d834495e774a4fee952324e4cc5ab514 +#: ../../maintaining/tasks.md:17 +msgid "Adding a New Core Image to Docker Cloud" +msgstr "" + +# b765140c2d1446849b747351532d6290 +#: ../../maintaining/tasks.md:19 +msgid "" +"When there's a new stack definition, do the following before merging the PR " +"with the new stack:" +msgstr "" + +# b7b25a83cd3246bd886926722c30ac1a +#: ../../maintaining/tasks.md:21 +msgid "" +"Ensure the PR includes an update to the stack overview diagram in the " +"documentation. The image links to the blockdiag source used to create it." +msgstr "" + +# 50edc8e02aa9497d81dc312eafe5d2bf +#: ../../maintaining/tasks.md:22 +msgid "" +"Ensure the PR updates the Makefile which is used to build the stacks in " +"order on Travis CI." +msgstr "" + +# fabcb32a80a04a639aebd8b55d38119e +#: ../../maintaining/tasks.md:23 +msgid "" +"Create a new repository in the jupyter org on Docker Cloud named after the " +"stack folder in the git repo." +msgstr "" + +# 1811dcec60e3433d94514eaeebecb44b +#: ../../maintaining/tasks.md:24 +msgid "Grant the stacks team permission to write to the repo." +msgstr "" + +# afa7b1fcb0224380a111fe94f7781d60 +#: ../../maintaining/tasks.md:25 +msgid "Click Builds and then Configure Automated Builds for the repository." +msgstr "" + +# 35b969b9f7a442d99f54a73494033d90 +#: ../../maintaining/tasks.md:26 +msgid "Select jupyter/docker-stacks as the source repository." +msgstr "" + +# fe715af4446d409cb4d5ee81255bd86e +#: ../../maintaining/tasks.md:27 +msgid "" +"Choose Build on Docker Cloud's infrastructure using a Small node unless you " +"have reason to believe a bigger host is required." +msgstr "" + +# dc41895431b64657b5e24a8c96779ca6 +#: ../../maintaining/tasks.md:28 +msgid "" +"Update the Build Context in the default build rule to be /." +msgstr "" + +# e4d220bf1cb54781bc03f16a17ddafb8 +#: ../../maintaining/tasks.md:29 +msgid "" +"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., " +"like jupyter/base-notebook)." +msgstr "" + +# c5a459d038714ff78d4f156ee227d9ca +#: ../../maintaining/tasks.md:30 +msgid "" +"If the new stack depends on the build of another stack in the hierarchy:" +msgstr "" + +# 611376c2ec6942479f60129177d312cc +#: ../../maintaining/tasks.md:31 +msgid "Hit Save and then click Configure Automated Builds." +msgstr "" + +# 81cc56c63891432d89d4df3001f1bcde +#: ../../maintaining/tasks.md:32 +msgid "At the very bottom, add a build trigger named Stack hierarchy trigger." +msgstr "" + +# 9e55682a966a422c846a3463c7a30cfe +#: ../../maintaining/tasks.md:33 +msgid "Copy the build trigger URL." +msgstr "" + +# a9d853a1d45b4ead965813822a96c934 +#: ../../maintaining/tasks.md:34 +msgid "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." +msgstr "" + +# 327d4522c3884247871aa406bbe19402 +#: ../../maintaining/tasks.md:35 +msgid "" +"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma" +" separated list of URLs, creating that environment variable if it does not " +"already exist." +msgstr "" + +# 1aa0e4b95ab847e0be8ac9647433c991 +# 7dfff62380a041968ee6e739b1ca271f +#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40 +msgid "Hit Save." +msgstr "" + +# 8315ed043efb40238227f8be0ad61b52 +#: ../../maintaining/tasks.md:37 +msgid "If the new stack should trigger other dependent builds:" +msgstr "" + +# 6e0e15d05a544476b91794d10b8732ff +#: ../../maintaining/tasks.md:38 +msgid "Add an environment variable named NEXT_BUILD_TRIGGERS." +msgstr "" + +# 9dc2029e6360433ab7181187f7040d48 +#: ../../maintaining/tasks.md:39 +msgid "" +"Copy the build trigger URLs from the dependent builds into the " +"NEXT_BUILD_TRIGGERS comma separated list of URLs." +msgstr "" + +# 89165b279d9142e9b8e5d7a923fca2be +#: ../../maintaining/tasks.md:41 +msgid "" +"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order " +"matches that in the stack hierarchy diagram." +msgstr "" + +# 51c8151943794bc8b1d51d65ccd84736 +#: ../../maintaining/tasks.md:43 +msgid "Adding a New Maintainer Account" +msgstr "" + +# 1994c19e7a734b2cad9af0afcd7da31e +#: ../../maintaining/tasks.md:45 +msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" +msgstr "" + +# 390ccdde528146bbbc3d2f62717a647c +#: ../../maintaining/tasks.md:46 +msgid "Add the maintainer's Docker Cloud username." +msgstr "" + +# b0227c37244c4b82848cc2655f134d21 +#: ../../maintaining/tasks.md:47 +msgid "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members" +msgstr "" + +# b0fdbdd14b1444d1b696d8367aa111fb +#: ../../maintaining/tasks.md:48 +msgid "Add the maintainer's GitHub username." +msgstr "" + +# abe2cb04fcb9447496bf3bc9fb230cdc +#: ../../maintaining/tasks.md:50 +msgid "Pushing a Build Manually" +msgstr "" + +# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd +#: ../../maintaining/tasks.md:52 +msgid "" +"If automated builds on Docker Cloud have got you down, do the following to " +"push a build manually:" +msgstr "" + +# 3ebef623fa2f46f49ef639ad17105d4a +#: ../../maintaining/tasks.md:54 +msgid "Clone this repository." +msgstr "" + +# dcf8e9e8c72e40b9aa23c090311d6ea2 +#: ../../maintaining/tasks.md:55 +msgid "Check out the git SHA you want to build and publish." +msgstr "" + +# fe788ad30f694b1f9b013cabfa820343 +#: ../../maintaining/tasks.md:56 +msgid "docker login with your Docker Hub/Cloud credentials." +msgstr "" + +# 649dc474ffaa483eb625ed8061cb0097 +#: ../../maintaining/tasks.md:57 +msgid "Run make retry/release-all." +msgstr "" diff --git a/docs/locale/it/LC_MESSAGES/using.po b/docs/locale/it/LC_MESSAGES/using.po new file mode 100644 index 0000000000..340965296a --- /dev/null +++ b/docs/locale/it/LC_MESSAGES/using.po @@ -0,0 +1,1530 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: it\n" +"Plural-Forms: nplurals=2; plural=(n != 1);\n" + +# 22b65331d42e414b9320143d30499447 +#: ../../using/common.md:1 +msgid "Common Features" +msgstr "" + +# dd3cb2a88856437aad5f76b607f80deb +#: ../../using/common.md:3 +msgid "" +"A container launched from any Jupyter Docker Stacks image runs a Jupyter " +"Notebook server by default. The container does so by executing a start-" +"notebook.sh script. This script configures the internal container " +"environment and then runs jupyter notebook, passing it any command line " +"arguments received." +msgstr "" + +# 4bc2911886254b1cafcffcce7d7ef9b3 +#: ../../using/common.md:5 +msgid "" +"This page describes the options supported by the startup script as well as " +"how to bypass it to run alternative commands." +msgstr "" + +# bb55c8d7786e4c1f8e11c1e309931c41 +#: ../../using/common.md:7 +msgid "Notebook Options" +msgstr "" + +# 66f14be1ff1746c1abdccafb894fa2e6 +#: ../../using/common.md:9 +msgid "" +"You can pass Jupyter command line options to the start-notebook.sh script " +"when launching the container. For example, to secure the Notebook server " +"with a custom password hashed using IPython.lib.passwd() instead of the " +"default token, you can run the following:" +msgstr "" + +# 5d73f06cae2c4990a942c76988f19c1f +#: ../../using/common.md:15 +msgid "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" +msgstr "" + +# 9d43ee0e147b43469f56c4895720f682 +#: ../../using/common.md:21 +msgid "Docker Options" +msgstr "" + +# 3f0f5c9d0b254d829e6f07e0a2ca2544 +#: ../../using/common.md:23 +msgid "" +"You may instruct the start-notebook.sh script to customize the container " +"environment before launching the notebook server. You do so by passing " +"arguments to the docker run command." +msgstr "" + +# 4621c78dfaeb43379c5d3437238b2ef8 +#: ../../using/common.md:26 +msgid "" +"-e NB_USER=jovyan - Instructs the startup script to change the default " +"container username from jovyan to the provided value. Causes the script to " +"rename the jovyan user home folder. For this option to take effect, you must" +" run the container with --user root and set the working directory -w " +"/home/$NB_USER. This feature is useful when mounting host volumes with " +"specific home folder." +msgstr "" + +# 9120ad3c28c84f3fbb2433c79a83907a +#: ../../using/common.md:27 +msgid "" +"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID " +"of $NB_USER to the given value. This feature is useful when mounting host " +"volumes with specific owner permissions. For this option to take effect, you" +" must run the container with --user root. (The startup script will su " +"$NB_USER after adjusting the user ID.) You might consider using modern " +"Docker options --user and --group-add instead. See the last bullet below for" +" details." +msgstr "" + +# f2a9954159b546468e50a4d9665dd534 +#: ../../using/common.md:28 +msgid "" +"-e NB_GID=100 - Instructs the startup script to change the primary group " +"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it" +" is defined, otherwise the group is named $NB_USER). This feature is useful" +" when mounting host volumes with specific group permissions. For this option" +" to take effect, you must run the container with --user root. (The startup " +"script will su $NB_USER after adjusting the group ID.) You might consider " +"using modern Docker options --user and --group-add instead. See the last " +"bullet below for details. The user is added to supplemental group users " +"(gid 100) in order to allow write access to the home directory and " +"/opt/conda. If you override the user/group logic, ensure the user stays in " +"group users if you want them to be able to modify files in the image." +msgstr "" + +# 1d362c57a99b47e1b3cb571f23c17e67 +#: ../../using/common.md:29 +msgid "" +"-e NB_GROUP= - The name used for $NB_GID, which defaults to $NB_USER." +" This is only used if $NB_GID is specified and completely optional: there " +"is only cosmetic effect." +msgstr "" + +# de1cd66f1e174d519cfcf764a0286773 +#: ../../using/common.md:30 +msgid "" +"-e NB_UMASK= - Configures Jupyter to use a different umask value from" +" default, i.e. 022. For example, if setting umask to 002, new files will be " +"readable and writable by group members instead of just writable by the " +"owner. Wikipedia has a good article about umask. Feel free to read it in " +"order to choose the value that better fits your needs. Default value should " +"fit most situations. Note that NB_UMASK when set only applies to the Jupyter" +" process itself - you cannot use it to set a umask for additional files " +"created during run-hooks e.g. via pip or conda - if you need to set a umask " +"for these you must set umask for each command." +msgstr "" + +# 325f270ee0484e728c638fb0ca4c9c93 +#: ../../using/common.md:31 +msgid "" +"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home" +" directory owner and group to the current value of $NB_UID and $NB_GID. This" +" change will take effect even if the user home directory is mounted from the" +" host using -v as described below. The change is not applied recursively by " +"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS" +" (e.g., -e CHOWN_HOME_OPTS='-R')." +msgstr "" + +# 85b3d1d9890c46b08bb62370c6ed93a2 +#: ../../using/common.md:32 +msgid "" +"-e CHOWN_EXTRA=\",\" - Instructs the startup " +"script to change the owner and group of each comma-separated container " +"directory to the current value of $NB_UID and $NB_GID. The change is not " +"applied recursively by default. You can change modify the chown behavior by " +"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')." +msgstr "" + +# bb7a47817b734d7ab9d95e4c4f18911f +#: ../../using/common.md:33 +msgid "" +"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user " +"passwordless sudo capability. You do not need this option to allow the user " +"to conda or pip install additional packages. This option is useful, however," +" when you wish to give $NB_USER the ability to install OS packages with apt " +"or modify other root-owned files in the container. For this option to take " +"effect, you must run the container with --user root. (The start-notebook.sh " +"script will su $NB_USER after adding $NB_USER to sudoers.) You should only " +"enable sudo if you trust the user or if the container is running on an " +"isolated host." +msgstr "" + +# d148b1f0275342b0bf231ae5e819590f +#: ../../using/common.md:34 +msgid "" +"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed " +"SSL certificate and configure Jupyter Notebook to use it to accept encrypted" +" HTTPS connections." +msgstr "" + +# aafdc956c76142a0acfe467ffde5ce68 +#: ../../using/common.md:35 +msgid "" +"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab " +"instead of the default jupyter notebook command. Useful in container " +"orchestration environments where setting environment variables is easier " +"than change command line parameters." +msgstr "" + +# 9a4fc69536fa4e8580ed4f5e77d338f0 +#: ../../using/common.md:36 +msgid "" +"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine " +"directory as folder in the container. Useful when you want to preserve " +"notebooks and other work even after the container is destroyed. You must " +"grant the within-container notebook user or group (NB_UID or NB_GID) write " +"access to the host directory (e.g., sudo chown 1000 " +"/some/host/folder/for/work)." +msgstr "" + +# 684334b1f55b42e4a05e194f3a3a3497 +#: ../../using/common.md:37 +msgid "" +"--user 5000 --group-add users - Launches the container with a specific user " +"ID and adds that user to the users group so that it can modify files in the " +"default home directory and /opt/conda. You can use these arguments as " +"alternatives to setting $NB_UID and $NB_GID." +msgstr "" + +# 42df7956876a4592be13f4ce3c9c8f54 +#: ../../using/common.md:39 +msgid "Startup Hooks" +msgstr "" + +# c8d2e31d4d0544a486a070c4cc7d8afd +#: ../../using/common.md:41 +msgid "" +"You can further customize the container environment by adding shell scripts " +"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:" +msgstr "" + +# 473e6aea1cbc4e50b75eec179a476b46 +#: ../../using/common.md:44 +msgid "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" +msgstr "" + +# f9d0cc48b06f4cbfa911ef6169222f6b +#: ../../using/common.md:46 +msgid "" +"/usr/local/bin/before-notebook.d/ - handled after all of the standard " +"options noted above are applied and just before the notebook server launches" +msgstr "" + +# 68e7bf5e72d747f886129a962ae84eef +#: ../../using/common.md:49 +msgid "" +"See the run-hooks function in the jupyter/base-notebook start.sh script for " +"execution details." +msgstr "" + +# 7a9436da93a34647a59ee4cc77be5300 +#: ../../using/common.md:52 +msgid "SSL Certificates" +msgstr "" + +# e69958fe476445eda760433dcc2fac24 +#: ../../using/common.md:54 +msgid "" +"You may mount SSL key and certificate files into a container and configure " +"Jupyter Notebook to use them to accept HTTPS connections. For example, to " +"mount a host folder containing a notebook.key and notebook.crt and use them," +" you might run the following:" +msgstr "" + +# b38385bb5753460397e87480c71d621f +#: ../../using/common.md:64 +msgid "" +"Alternatively, you may mount a single PEM file containing both the key and " +"certificate. For example:" +msgstr "" + +# 7867b25df06444e8b7bd0c87292cafd8 +#: ../../using/common.md:73 +msgid "" +"In either case, Jupyter Notebook expects the key and certificate to be a " +"base64 encoded text file. The certificate file or PEM may contain one or " +"more certificates (e.g., server, intermediate, and root)." +msgstr "" + +# 030c5c35440b45d8b1a82abdb946609f +#: ../../using/common.md:75 +msgid "For additional information about using SSL, see the following:" +msgstr "" + +# a50ac1b5bbc749e8a5c4f9ecbd523d14 +#: ../../using/common.md:77 +msgid "" +"The docker-stacks/examples for information about how to use Let's Encrypt " +"certificates when you run these stacks on a publicly visible domain." +msgstr "" + +# 9cc027cb57c044a782068bf45d3bc22e +#: ../../using/common.md:78 +msgid "" +"The jupyter_notebook_config.py file for how this Docker image generates a " +"self-signed certificate." +msgstr "" + +# dbfcfb88b099481781c8f3b3011a73e9 +#: ../../using/common.md:79 +msgid "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." +msgstr "" + +# f8fcaea33627485799126c6b6e08e7dc +#: ../../using/common.md:81 +msgid "Alternative Commands" +msgstr "" + +# 10a9b432d6dd4a8a804da1976d27127e +#: ../../using/common.md:83 +msgid "start.sh" +msgstr "" + +# 3dca69ef1ed44f08a99c8a3f82645ffa +#: ../../using/common.md:85 +msgid "" +"The start-notebook.sh script actually inherits most of its option handling " +"capability from a more generic start.sh script. The start.sh script supports" +" all of the features described above, but allows you to specify an arbitrary" +" command to execute. For example, to run the text-based ipython console in a" +" container, do the following:" +msgstr "" + +# f9ade4ab67f54867a79b59937239d9a7 +#: ../../using/common.md:91 +msgid "" +"Or, to run JupyterLab instead of the classic notebook, run the following:" +msgstr "" + +# 4575181991e844a1bc113b6c2821d0d8 +#: ../../using/common.md:97 +msgid "" +"This script is particularly useful when you derive a new Dockerfile from " +"this image and install additional Jupyter applications with subcommands like" +" jupyter console, jupyter kernelgateway, etc." +msgstr "" + +# d4d085e167a942709b72de803ee03bc0 +#: ../../using/common.md:99 +msgid "Others" +msgstr "" + +# 34c4fb744a514987b41ad23dba573c46 +#: ../../using/common.md:101 +msgid "" +"You can bypass the provided scripts and specify your an arbitrary start " +"command. If you do, keep in mind that features supported by the start.sh " +"script and its kin will not function (e.g., GRANT_SUDO)." +msgstr "" + +# bcd8d95440b2493a9ffbca0678a14ed9 +#: ../../using/common.md:103 +msgid "Conda Environments" +msgstr "" + +# 9f62047ae18e44e3bad5b3a183a3683a +#: ../../using/common.md:105 +msgid "" +"The default Python 3.x Conda environment resides in /opt/conda. The " +"/opt/conda/bin directory is part of the default jovyan user's $PATH. That " +"directory is also whitelisted for use in sudo commands by the start.sh " +"script." +msgstr "" + +# 6c8c478e872d444b904fecd01e9911da +#: ../../using/common.md:107 +msgid "" +"The jovyan user has full read/write access to the /opt/conda directory. You " +"can use either conda or pip to install new packages without any additional " +"permissions." +msgstr "" + +# cdff04cd2c814d2a993dcf793c1a32a0 +#: ../../using/recipes.md:1 +msgid "Contributed Recipes" +msgstr "" + +# 674d282d2bc64a07b2d1aae14a954453 +#: ../../using/recipes.md:3 +msgid "" +"Users sometimes share interesting ways of using the Jupyter Docker Stacks. " +"We encourage users to contribute these recipes to the documentation in case " +"they prove useful to other members of the community by submitting a pull " +"request to docs/using/recipes.md. The sections below capture this knowledge." +msgstr "" + +# a01a0ec46bc8469290ee140a69d6b0a4 +#: ../../using/recipes.md:5 +msgid "Using pip install or conda install in a Child Docker image" +msgstr "" + +# 95d414d34880400bb6f17842eaacdb47 +#: ../../using/recipes.md:7 +msgid "Create a new Dockerfile like the one shown below." +msgstr "" + +# 1fa3f126a9a6401d9941748e79380f8e +#: ../../using/recipes.md:16 +msgid "Then build a new image." +msgstr "" + +# 1bff41f678f847d98ffa744cf037c502 +#: ../../using/recipes.md:22 +msgid "" +"To use a requirements.txt file, first create your requirements.txt file with" +" the listing of packages desired. Next, create a new Dockerfile like the " +"one shown below." +msgstr "" + +# a11c4c3379f64b4f8028d4b4c7437292 +#: ../../using/recipes.md:35 +msgid "For conda, the Dockerfile is similar:" +msgstr "" + +# 42213789b3a14b02a491455f3bcdfa9a +#: ../../using/recipes.md:47 +msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" +msgstr "" + +# 471f68531d274ce4a7ad2a9f4274d8a9 +#: ../../using/recipes.md:49 +msgid "Add a Python 2.x environment" +msgstr "" + +# c721d45a7e9e4ce99799d587a7aa0921 +#: ../../using/recipes.md:51 +msgid "" +"Python 2.x was removed from all images on August 10th, 2017, starting in tag" +" cc9feab481f7. You can add a Python 2.x environment by defining your own " +"Dockerfile inheriting from one of the images like so:" +msgstr "" + +# e07ac0abd67c4bb2a746953b44cd2ba8 +#: ../../using/recipes.md:73 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440" +msgstr "" + +# 88ae461b17e140a1ae71a9c175b4bd0d +#: ../../using/recipes.md:75 +msgid "Run JupyterLab" +msgstr "" + +# dbf08b368b5346ec8f6549737e561e5f +#: ../../using/recipes.md:77 +msgid "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." +msgstr "" + +# 866e89573c5d4a70abd44bf374ed2e62 +#: ../../using/recipes.md:79 +msgid "" +"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 " +"jupyter/datascience-notebook start.sh jupyter lab" +msgstr "" + +# 1531d01600af476b8401421c9305cdf3 +#: ../../using/recipes.md:81 +msgid "Let's Encrypt a Notebook server" +msgstr "" + +# ac1d8a654ce64ec3b318d9c341602e1a +#: ../../using/recipes.md:83 +msgid "" +"See the README for the simple automation here https://github.com/jupyter" +"/docker-stacks/tree/master/examples/make-deploy which includes steps for " +"requesting and renewing a Let's Encrypt certificate." +msgstr "" + +# 17ac8453774a4b028df89f2bdb3feec1 +#: ../../using/recipes.md:85 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78" +msgstr "" + +# 020d1144ff094e49ba690fd3292bad1a +#: ../../using/recipes.md:87 +msgid "Slideshows with Jupyter and RISE" +msgstr "" + +# b84e3e74e66349a695be5f2eb177757b +#: ../../using/recipes.md:89 +msgid "" +"RISE allows via extension to create live slideshows of your notebooks, with " +"no conversion, adding javascript Reveal.js:" +msgstr "" + +# 14fd425e7dad41c9b00fee87d7d2225e +#: ../../using/recipes.md:95 +msgid "Credit: Paolo D. based on docker-stacks/issues/43" +msgstr "" + +# 3e38842bbf0244f5897f995d7744d4ed +#: ../../using/recipes.md:97 +msgid "xgboost" +msgstr "" + +# daf9711129e84131ad1f676e646f9e03 +#: ../../using/recipes.md:99 +msgid "" +"You need to install conda's gcc for Python xgboost to work properly. " +"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0." +msgstr "" + +# faf7639219434c4d902b0e9bd6e626c2 +#: ../../using/recipes.md:109 +msgid "Running behind a nginx proxy" +msgstr "" + +# 912ad155cb4a45069d9e8ec8b1b87cb0 +#: ../../using/recipes.md:111 +msgid "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for" +" instance:" +msgstr "" + +# 7adc9717c9f84756963824bb3b851eda +#: ../../using/recipes.md:113 +msgid "" +"you would prefer to access the notebook at a server URL with a path " +"(https://example.com/jupyter) rather than a port (https://example.com:8888)" +msgstr "" + +# 1ed3d2d40ad948b19f6d1b5777c13f5f +#: ../../using/recipes.md:114 +msgid "" +"you may have many different services in addition to Jupyter running on the " +"same server, and want to nginx to help improve server performance in manage " +"the connections" +msgstr "" + +# 276ccfb626504c1fbe8d645f1c82a24f +#: ../../using/recipes.md:116 +msgid "" +"Here is a quick example NGINX configuration to get started. You'll need a " +"server, a .crt and .key file for your server, and docker & docker-compose " +"installed. Then just download the files at that gist and run docker-compose" +" up -d to test it out. Customize the nginx.conf file to set the desired " +"paths and add other services." +msgstr "" + +# ba9a795db881452d8a815f3bf2f3aa7a +#: ../../using/recipes.md:118 +msgid "Host volume mounts and notebook errors" +msgstr "" + +# 3cecb98fa6e54f99a09a04b81a4bc04e +#: ../../using/recipes.md:120 +msgid "" +"If you are mounting a host directory as /home/jovyan/work in your container " +"and you receive permission errors or connection errors when you create a " +"notebook, be sure that the jovyan user (UID=1000 by default) has read/write " +"access to the directory on the host. Alternatively, specify the UID of the " +"jovyan user on container startup using the -e NB_UID option described in the" +" Common Features, Docker Options section" +msgstr "" + +# b71f0c2e0f184959a9a6f0765b9f0b4e +#: ../../using/recipes.md:122 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199" +msgstr "" + +# 29b6203639a444d38051b7dd23195ad5 +#: ../../using/recipes.md:124 +msgid "Manpage installation" +msgstr "" + +# a4261a1c819e48ef848fb16bacd237dd +#: ../../using/recipes.md:126 +msgid "" +"Most containers, including our Ubuntu base image, ship without manpages " +"installed to save space. You can use the following dockerfile to inherit " +"from one of our images to enable manpages:" +msgstr "" + +# df6c0841b76247a893a7494d446d63ad +#: ../../using/recipes.md:151 +msgid "" +"Adding the documentation on top of an existing singleuser image wastes a lot" +" of space and requires reinstalling every system package, which can take " +"additional time and bandwidth; the datascience-notebook image has been shown" +" to grow by almost 3GB when adding manapages in this way. Enabling manpages " +"in the base Ubuntu layer prevents this container bloat:" +msgstr "" + +# b41452481f5d421fa005b0e1a33bf9b4 +#: ../../using/recipes.md:173 +msgid "" +"Be sure to check the current base image in base-notebook before building." +msgstr "" + +# 7b0274764c614b46b0a2e663231e59b7 +#: ../../using/recipes.md:175 +msgid "JupyterHub" +msgstr "" + +# ccf49b18478443ecbd9fd7fc9c171cd9 +#: ../../using/recipes.md:177 +msgid "We also have contributed recipes for using JupyterHub." +msgstr "" + +# e5835af60f9c4bfeb8e6995d703f730e +#: ../../using/recipes.md:179 +msgid "Use JupyterHub's dockerspawner" +msgstr "" + +# 9305102339904086861ef2246beb8f08 +#: ../../using/recipes.md:181 +msgid "" +"In most cases for use with DockerSpawner, given any image that already has a" +" notebook stack set up, you would only need to add:" +msgstr "" + +# 5d92054033604627ae5b3161c3d0b903 +#: ../../using/recipes.md:183 +msgid "install the jupyterhub-singleuser script (for the right Python)" +msgstr "" + +# fcf37a1789f84906bde9085583cff95b +#: ../../using/recipes.md:184 +msgid "change the command to launch the single-user server" +msgstr "" + +# e6f1488b2ffb4beaa2414ca545f10261 +#: ../../using/recipes.md:186 +msgid "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be" +" enough for most cases." +msgstr "" + +# bbd864e6695a4cca862d9fa909b51dc0 +#: ../../using/recipes.md:188 +msgid "" +"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-" +"stacks/issues/124 and docker-stacks/pull/185" +msgstr "" + +# 260577d0e15f4102bbad7486357528d4 +#: ../../using/recipes.md:190 +msgid "Containers with a specific version of JupyterHub" +msgstr "" + +# 041f84f19f0e4d4c8b050a2ccc2cb812 +#: ../../using/recipes.md:192 +msgid "" +"To use a specific version of JupyterHub, the version of jupyterhub in your " +"image should match the version in the Hub itself." +msgstr "" + +# 41410dcc4e264932b64e96e6857b1bd3 +#: ../../using/recipes.md:199 +msgid "Credit: MinRK" +msgstr "" + +# 68fe2ae525474d91af1d8647378f078b +#: ../../using/recipes.md:202 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177" +msgstr "" + +# 3b6b7a3b35aa42a8a70a5c9e91af21d2 +#: ../../using/recipes.md:204 +msgid "Spark" +msgstr "" + +# 8d1092f2b1a64da292134b240b621f48 +#: ../../using/recipes.md:206 +msgid "" +"A few suggestions have been made regarding using Docker Stacks with spark." +msgstr "" + +# 54e47498667747d1a7f576895d140c6f +#: ../../using/recipes.md:208 +msgid "Using PySpark with AWS S3" +msgstr "" + +# 127111e623114603b4c841b66ce8f16f +#: ../../using/recipes.md:210 +msgid "Using Spark session for hadoop 2.7.3" +msgstr "" + +# 5454399deea24bb2a166ddd1fd168752 +#: ../../using/recipes.md:230 +msgid "Using Spark context for hadoop 2.6.0" +msgstr "" + +# af0c5beb70664b74b6798a869023b3ca +#: ../../using/recipes.md:252 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127" +msgstr "" + +# 56531d33de8c46bb853db7ecef65d1ef +#: ../../using/recipes.md:254 +msgid "Using Local Spark JARs" +msgstr "" + +# 783af638cf454b6ea8bfd04df9da967f +#: ../../using/recipes.md:270 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154" +msgstr "" + +# 80df4b671dc64d9bad9bd2915524fe02 +#: ../../using/recipes.md:272 +msgid "Using spark-packages.org" +msgstr "" + +# 14c79ea3fbf446fc92ab63c36e874f96 +#: ../../using/recipes.md:274 +msgid "" +"If you'd like to use packages from spark-packages.org, see " +"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how " +"to specify the package identifier in the environment before creating a " +"SparkContext." +msgstr "" + +# 5a1cab88fa6c477a99f4352670b6cf76 +#: ../../using/recipes.md:276 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43" +msgstr "" + +# 753a64e86395492481c9541dcb91f0ed +#: ../../using/recipes.md:278 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +msgstr "" + +# 53fbe7a910d84359af93acf195711ffd +#: ../../using/recipes.md:342 +msgid "Credit: britishbadger from docker-stacks/issues/369" +msgstr "" + +# c82c3fc2484d48d5889dd8e3e79723b2 +#: ../../using/recipes.md:344 +msgid "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with " +"no token)" +msgstr "" + +# 53c63d298efa42cab5d39c3b242d44e0 +#: ../../using/recipes.md:346 +msgid "(Adapted from issue 728)" +msgstr "" + +# cb4bd116d7334212b7fa5a78602e370d +#: ../../using/recipes.md:348 +msgid "" +"The default security is very good. There are use cases, encouraged by " +"containers, where the jupyter container and the system it runs within, lie " +"inside the security boundary. In these use cases it is convenient to launch " +"the server without a password or token. In this case, you should use the " +"start.sh script to launch the server with no token:" +msgstr "" + +# 59cd4c1e695f42c09ea911048769f8b7 +#: ../../using/recipes.md:354 +msgid "For jupyterlab:" +msgstr "" + +# 49d382c7a9c14ddda58b2e88521dc3bc +#: ../../using/recipes.md:360 +msgid "For jupyter classic:" +msgstr "" + +# 297f3ad3d8504a75a0fd5659fa73b67c +#: ../../using/recipes.md:365 +msgid "" +"Enable nbextension spellchecker for markdown (or any other nbextension)" +msgstr "" + +# e2b10f15c91e4db9b7898a1a191526c7 +#: ../../using/recipes.md:367 +msgid "NB: this works for classic notebooks only" +msgstr "" + +# 158be3dba029417b832640f01cd22f75 +#: ../../using/recipes.md:380 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675" +msgstr "" + +# ade5800ecee24c9eb4f16af9585951fc +#: ../../using/running.md:1 +msgid "Running a Container" +msgstr "" + +# da480368616a4ffa976061bdc0128763 +# 1b0a0481a9454392a32c005d7513e453 +#: ../../using/running.md:3 ../../using/selecting.md:7 +msgid "Using one of the Jupyter Docker Stacks requires two choices:" +msgstr "" + +# d94683d29b6341a98420c4e6adebc4bb +# 436b43aa9da944d281cf51ea731d286a +#: ../../using/running.md:5 ../../using/selecting.md:9 +msgid "Which Docker image you wish to use" +msgstr "" + +# de5bb072aa194beebbf587038b36bdcf +# fca43aa36e854a9ab4d2b2816c015847 +#: ../../using/running.md:6 ../../using/selecting.md:10 +msgid "How you wish to start Docker containers from that image" +msgstr "" + +# 19634063eb14436daa48af3b1ee3fcc5 +#: ../../using/running.md:8 +msgid "This section provides details about the second." +msgstr "" + +# b855cc98da54497fa98956b68d00e840 +#: ../../using/running.md:10 +msgid "Using the Docker CLI" +msgstr "" + +# 555174be66b049e2ad53de52d8e37aa0 +#: ../../using/running.md:12 +msgid "" +"You can launch a local Docker container from the Jupyter Docker Stacks using" +" the Docker command line interface. There are numerous ways to configure " +"containers using the CLI. The following are some common patterns." +msgstr "" + +# d433157f1f834a66b66143513ffe8c9d +#: ../../using/running.md:14 +msgid "" +"Example 1 This command pulls the jupyter/scipy-notebook image tagged " +"2c80cf3537ca from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 8888. The server logs appear in the terminal and " +"include a URL to the notebook server." +msgstr "" + +# 3a56c8c4932644e6b938b5401fb98d26 +#: ../../using/running.md:36 +msgid "" +"Pressing Ctrl-C shuts down the notebook server but leaves the container " +"intact on disk for later restart or permanent deletion using commands like " +"the following:" +msgstr "" + +# e3f24ae3050d452aa42f3a92ba36f61c +#: ../../using/running.md:55 +msgid "" +"Example 2 This command pulls the jupyter/r-notebook image tagged " +"e5c5a7d3e52d from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 10000. The server logs appear in the terminal and " +"include a URL to the notebook server, but with the internal container port " +"(8888) instead of the the correct host port (10000)." +msgstr "" + +# d54172836b0349cb8e8ccbcb6c33ec45 +#: ../../using/running.md:77 +msgid "" +"Pressing Ctrl-C shuts down the notebook server and immediately destroys the " +"Docker container. Files written to ~/work in the container remain touched. " +"Any other changes made in the container are lost." +msgstr "" + +# 0d90bfa0543f4669a0b2bb4b62e2e7dc +#: ../../using/running.md:79 +msgid "" +"Example 3 This command pulls the jupyter/all-spark-notebook image currently " +"tagged latest from Docker Hub if an image tagged latest is not already " +"present on the local host. It then starts a container named notebook running" +" a JupyterLab server and exposes the server on a randomly selected port." +msgstr "" + +# 04e49785faff4511b8576e9d997bea67 +#: ../../using/running.md:85 +msgid "" +"The assigned port and notebook server token are visible using other Docker " +"commands." +msgstr "" + +# f88af44236f948ccbda342b1c93364d3 +#: ../../using/running.md:99 +msgid "" +"Together, the URL to visit on the host machine to access the server in this " +"case is " +"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00." +msgstr "" + +# ed09c347d7aa4dd79e505562f4f5efdd +#: ../../using/running.md:101 +msgid "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." +msgstr "" + +# 7fdc11c0394e4af88bb3c3178814d184 +#: ../../using/running.md:113 +msgid "Using Binder" +msgstr "" + +# 69b162f507f14323b3dbf8758e2964b2 +#: ../../using/running.md:115 +msgid "" +"Binder is a service that allows you to create and share custom computing " +"environments for projects in version control. You can use any of the Jupyter" +" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the" +" docker-stacks example and Using a Dockerfile sections in the Binder " +"documentation for instructions." +msgstr "" + +# f148f5335f354e549f00dce0cc630475 +#: ../../using/running.md:117 +msgid "Using JupyterHub" +msgstr "" + +# a23469fb52db4edfb3e98c1dc3115b50 +#: ../../using/running.md:119 +msgid "" +"You can configure JupyterHub to launcher Docker containers from the Jupyter " +"Docker Stacks images. If you've been following the Zero to JupyterHub with " +"Kubernetes guide, see the Use an existing Docker image section for details. " +"If you have a custom JupyterHub deployment, see the Picking or building a " +"Docker image instructions for the dockerspawner instead." +msgstr "" + +# bb8d103e20df4ebab2321ae4eee584e7 +#: ../../using/running.md:121 +msgid "Using Other Tools and Services" +msgstr "" + +# c6ef8c5aac54431d931df9f5d5f890d5 +#: ../../using/running.md:123 +msgid "" +"You can use the Jupyter Docker Stacks with any Docker-compatible technology " +"(e.g., Docker Compose, docker-py, your favorite cloud container service). " +"See the documentation of the tool, library, or service for details about how" +" to reference, configure, and launch containers from these images." +msgstr "" + +# d34ba542e6ed43a7b490cfa65b67d9c3 +#: ../../using/selecting.md:1 +msgid "Selecting an Image" +msgstr "" + +# 70b39f1dbdb242599b33cd78bbe6a850 +# cb08cf9b24364322a943a40bea1fd39f +#: ../../using/selecting.md:3 ../../using/selecting.md:14 +msgid "Core Stacks" +msgstr "" + +# 7a8f664007004185a07b672d25205ca2 +# 5040afcacc8d4cdeb5bc9b0ed6a06c88 +#: ../../using/selecting.md:4 ../../using/selecting.md:123 +msgid "Image Relationships" +msgstr "" + +# e364abca4ff948f5a6dba4d5685f9fe8 +# ae86feb2ae9c4ed081379460d4a559fb +#: ../../using/selecting.md:5 ../../using/selecting.md:141 +msgid "Community Stacks" +msgstr "" + +# 27b83c7429d142b89e0e425b662e94a9 +#: ../../using/selecting.md:12 +msgid "This section provides details about the first." +msgstr "" + +# b24fe11f42e84aaf8d2378535737148e +#: ../../using/selecting.md:16 +msgid "" +"The Jupyter team maintains a set of Docker image definitions in the " +"https://github.com/jupyter/docker-stacks GitHub repository. The following " +"sections describe these images including their contents, relationships, and " +"versioning strategy." +msgstr "" + +# 6562071d34574731baa6241fc067690c +#: ../../using/selecting.md:18 +msgid "jupyter/base-notebook" +msgstr "" + +# 79c95b7cb9df4670a0fab5737942396f +# 2d8e2926bd6f4db69959f5f0456c4682 +# 6d074c8de6fd4895b715a3525ccb8bb4 +# 7337ce8d03e5474887cd6affc21ec03b +# 2fb0a6afd5b24c33820ccaed19dd886d +# 1ad0f64aec2c4439937fa4d02ee0fe49 +# f955c9a3be324d2db1f47a643b9d51a3 +# 667016f994f84648853707ce13241d45 +#: ../../using/selecting.md:20 ../../using/selecting.md:37 +#: ../../using/selecting.md:49 ../../using/selecting.md:63 +#: ../../using/selecting.md:76 ../../using/selecting.md:87 +#: ../../using/selecting.md:100 ../../using/selecting.md:112 +msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags" +msgstr "" + +# 864aa76e1043469fa96b27f26dcad7d1 +#: ../../using/selecting.md:24 +msgid "" +"jupyter/base-notebook is a small image supporting the options common across " +"all core stacks. It is the basis for all other stacks." +msgstr "" + +# d869d6c4081e483180f51de5f5e225a7 +#: ../../using/selecting.md:26 +msgid "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" +msgstr "" + +# d6384943a3394b9d9a5a505e2387d392 +#: ../../using/selecting.md:27 +msgid "Miniconda Python 3.x in /opt/conda" +msgstr "" + +# 031a321f6173495daef86225cd234a72 +#: ../../using/selecting.md:28 +msgid "No preinstalled scientific computing packages" +msgstr "" + +# e37862b78262475182c34461d2fae08e +#: ../../using/selecting.md:29 +msgid "" +"Unprivileged user jovyan (uid=1000, configurable, see options) in group " +"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths" +msgstr "" + +# cdd04f4dbb864e82b8b993ccb1670687 +#: ../../using/selecting.md:30 +msgid "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" +msgstr "" + +# 0e3cf3b3a6e540be861ef295f1808099 +#: ../../using/selecting.md:31 +msgid "" +"A start-singleuser.sh script useful for launching containers in JupyterHub" +msgstr "" + +# 3b561d51339f422d801a408007ca16f3 +#: ../../using/selecting.md:32 +msgid "" +"A start.sh script useful for running alternative commands in the container " +"(e.g. ipython, jupyter kernelgateway, jupyter lab)" +msgstr "" + +# 9e8346716bc148fb8df45bce44fa7c38 +#: ../../using/selecting.md:33 +msgid "Options for a self-signed HTTPS certificate and passwordless sudo" +msgstr "" + +# ee56473bbb334a9b96db5870f6be611c +#: ../../using/selecting.md:35 +msgid "jupyter/minimal-notebook" +msgstr "" + +# eec9e5e3162343eba481b73cc223fa49 +#: ../../using/selecting.md:41 +msgid "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." +msgstr "" + +# cf19dcbf0d084508924f166d2b0fa7e3 +#: ../../using/selecting.md:43 +msgid "Everything in jupyter/base-notebook" +msgstr "" + +# 52d17abfd2f14628a9937f1b7584582d +#: ../../using/selecting.md:44 +msgid "Pandoc and TeX Live for notebook document conversion" +msgstr "" + +# b81070edc9c849c184be4687ce17b786 +#: ../../using/selecting.md:45 +msgid "git, emacs, jed, nano, tzdata, and unzip" +msgstr "" + +# aa65fcb5d17649bb88ded23f0880e147 +#: ../../using/selecting.md:47 +msgid "jupyter/r-notebook" +msgstr "" + +# 54b4b695a8ed493bb79993e62dd164c2 +#: ../../using/selecting.md:53 +msgid "jupyter/r-notebook includes popular packages from the R ecosystem." +msgstr "" + +# d83a0f40bfc34554a0c362f02c656e55 +# c27e75f042064ae0a64447053b46785e +#: ../../using/selecting.md:55 ../../using/selecting.md:69 +msgid "Everything in jupyter/minimal-notebook and its ancestor images" +msgstr "" + +# 99e3f1d20553480c81dda15a66369f52 +#: ../../using/selecting.md:56 +msgid "The R interpreter and base environment" +msgstr "" + +# 34bc2c80ad014b019fb54fc1fad024c4 +# 8c5a996a6b0c4309810071f5194f532a +#: ../../using/selecting.md:57 ../../using/selecting.md:119 +msgid "IRKernel to support R code in Jupyter notebooks" +msgstr "" + +# a24d121e485e4bd9bbe4df9883a7c148 +#: ../../using/selecting.md:58 +msgid "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, " +"stringr, lubridate, and broom from conda-forge" +msgstr "" + +# d49e405f45dd40a69e64b1636f69381d +#: ../../using/selecting.md:59 +msgid "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13," +" caret, rcurl, and randomforest packages from conda-forge" +msgstr "" + +# 9cfe9452daa04dfc982c2d99948a37eb +#: ../../using/selecting.md:61 +msgid "jupyter/scipy-notebook" +msgstr "" + +# 47f831c00a78451bb75de1467d90d34c +#: ../../using/selecting.md:67 +msgid "" +"jupyter/scipy-notebook includes popular packages from the scientific Python " +"ecosystem." +msgstr "" + +# da192888520b4b2ca9ae8ca5162aba6c +#: ../../using/selecting.md:70 +msgid "" +"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, " +"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, " +"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages" +msgstr "" + +# be048a3494074da99c0f5b98454feda8 +#: ../../using/selecting.md:71 +msgid "ipywidgets for interactive visualizations in Python notebooks" +msgstr "" + +# c3e92433ff5f4702beeaea78d6ee6fd7 +#: ../../using/selecting.md:72 +msgid "Facets for visualizing machine learning datasets" +msgstr "" + +# ff01e76ad1544fb48e024a617ae932b5 +#: ../../using/selecting.md:74 +msgid "jupyter/tensorflow-notebook" +msgstr "" + +# bf2f117cf3a047aa8be8cd73f4080455 +#: ../../using/selecting.md:80 +msgid "" +"jupyter/tensorflow-notebook includes popular Python deep learning libraries." +msgstr "" + +# 1fccef5b590549ffb4ea6933eaf12674 +# 1140d31915eb42fc89725521ec90c1dc +#: ../../using/selecting.md:82 ../../using/selecting.md:106 +msgid "Everything in jupyter/scipy-notebook and its ancestor images" +msgstr "" + +# 099eb36a6961440b8bea7901b226a96d +#: ../../using/selecting.md:83 +msgid "tensorflow and keras machine learning libraries" +msgstr "" + +# 13413eabaac34b94b4bc5ae28e445dda +#: ../../using/selecting.md:85 +msgid "jupyter/datascience-notebook" +msgstr "" + +# 23244942c9ef4eb8aba10cd558bf5fe9 +#: ../../using/selecting.md:91 +msgid "" +"jupyter/datascience-notebook includes libraries for data analysis from the " +"Julia, Python, and R communities." +msgstr "" + +# 7e65863f6a0840729876d3669158c4ce +#: ../../using/selecting.md:93 +msgid "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and " +"their ancestor images" +msgstr "" + +# 6246f4a0d2454714860e4ffa80aef958 +#: ../../using/selecting.md:94 +msgid "The Julia compiler and base environment" +msgstr "" + +# 143e63b9b0a9418a8c93870f6186808e +#: ../../using/selecting.md:95 +msgid "IJulia to support Julia code in Jupyter notebooks" +msgstr "" + +# 7a170fe5f6a949cc939d2f40200b3336 +#: ../../using/selecting.md:96 +msgid "HDF5, Gadfly, and RDatasets packages" +msgstr "" + +# 4b741debc1e84661ab63b8bf0d9c3bbe +#: ../../using/selecting.md:98 +msgid "jupyter/pyspark-notebook" +msgstr "" + +# 815f62ec44f54dbfaa5a052d15580b94 +#: ../../using/selecting.md:104 +msgid "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." +msgstr "" + +# 0cb03ee6cd9d488597be17be045f3b74 +#: ../../using/selecting.md:107 +msgid "Apache Spark with Hadoop binaries" +msgstr "" + +# 977ee95d9f664fe2a62505e0a78b1447 +#: ../../using/selecting.md:108 +msgid "Mesos client libraries" +msgstr "" + +# 43c0814f5a024a598dd26a4af0212cea +#: ../../using/selecting.md:110 +msgid "jupyter/all-spark-notebook" +msgstr "" + +# 0c1536b3ff6d40a885e9cdd881dc19bd +#: ../../using/selecting.md:116 +msgid "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache " +"Spark, optionally on Mesos." +msgstr "" + +# ecf9548ffc5e4e0eb4bbdf6cb458cf32 +#: ../../using/selecting.md:118 +msgid "Everything in jupyter/pyspark-notebook and its ancestor images" +msgstr "" + +# 5f6081607cab47739c306516cf84a814 +#: ../../using/selecting.md:120 +msgid "" +"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" +msgstr "" + +# a4b50e47f8684dfbbe71e0c3353199dd +#: ../../using/selecting.md:121 +msgid "ggplot2, sparklyr, and rcurl packages" +msgstr "" + +# ebbdf9189d96433e9323aae035f37ec2 +#: ../../using/selecting.md:125 +msgid "" +"The following diagram depicts the build dependency tree of the core images. " +"(i.e., the FROM statements in their Dockerfiles). Any given image inherits " +"the complete content of all ancestor images pointing to it." +msgstr "" + +# df2da8e55aa740a485fd638aa7397b8a +#: ../../using/selecting.md:129 +msgid "Builds" +msgstr "" + +# 56066ef1cd834061b3c3aea7567221c7 +#: ../../using/selecting.md:131 +msgid "" +"Pull requests to the jupyter/docker-stacks repository trigger builds of all " +"images on Travis CI. These images are for testing purposes only and are not " +"saved for use. When pull requests merge to master, all images rebuild on " +"Docker Cloud and become available to docker pull from Docker Hub." +msgstr "" + +# f4781cd0f2c040458a15b80846026405 +#: ../../using/selecting.md:133 +msgid "Versioning" +msgstr "" + +# 28addf6682f24cbdb1b6cd1836a6dc74 +#: ../../using/selecting.md:135 +msgid "" +"The latest tag in each Docker Hub repository tracks the master branch HEAD " +"reference on GitHub. latest is a moving target, by definition, and will have" +" backward-incompatible changes regularly." +msgstr "" + +# 92c07d80753b4fda9406b3b2694684e7 +#: ../../using/selecting.md:137 +msgid "" +"Every image on Docker Hub also receives a 12-character tag which corresponds" +" with the git commit SHA that triggered the image build. You can inspect the" +" state of the jupyter/docker-stacks repository for that commit to review the" +" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from" +" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)." +msgstr "" + +# 5bdfd71620394fa4812120220718ffeb +#: ../../using/selecting.md:139 +msgid "" +"You must refer to git-SHA image tags when stability and reproducibility are " +"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, " +"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only " +"use latest when a one-off container instance is acceptable (e.g., you want " +"to briefly try a new library in a notebook)." +msgstr "" + +# 90cc227d51734f8586d42982f3b7a559 +#: ../../using/selecting.md:143 +msgid "" +"The core stacks are just a tiny sample of what's possible when combining " +"Jupyter with other technologies. We encourage members of the Jupyter " +"community to create their own stacks based on the core images and link them " +"below." +msgstr "" + +# f1c9edb79eae4a5f929fdc1e0e2d4366 +#: ../../using/selecting.md:145 +msgid "This list only has 2 examples. You can be the next!" +msgstr "" + +# 7346986f864848708411fa0788d3b4e4 +#: ../../using/selecting.md:147 +msgid "" +"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter" +" Notebooks. The image includes more than 200 Jupyter Notebooks with example " +"C# code and can readily be tried online via mybinder.org. Click here to " +"launch ." +msgstr "" + +# a2e061cf04bf4e96a4d40c03790d64bc +#: ../../using/selecting.md:149 +msgid "" +"education-notebook is a community Jupyter Docker Stack image. The image " +"includes nbgrader and RISE on top of the datascience-notebook image. Click " +"here to launch it on ." +msgstr "" + +# c3720b9d103947499b34ebd19567733f +#: ../../using/selecting.md:151 +msgid "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." +msgstr "" + +# b9f784eaaa0a4072929bc51254fa322e +#: ../../using/specifics.md:1 +msgid "Image Specifics" +msgstr "" + +# dfb2958ae819459383ad8c75ba65dd39 +#: ../../using/specifics.md:3 +msgid "" +"This page provides details about features specific to one or more images." +msgstr "" + +# 9cfa68a10a3c4eb8b63c435e43bf77fc +#: ../../using/specifics.md:5 +msgid "Apache Spark" +msgstr "" + +# 536591b439514687b086cf6a4c6f7a93 +#: ../../using/specifics.md:7 +msgid "" +"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support " +"the use of Apache Spark in Python, R, and Scala notebooks. The following " +"sections provide some examples of how to get started using them." +msgstr "" + +# 21d870dca44845948d9ab959f8ccc105 +#: ../../using/specifics.md:9 +msgid "Using Spark Local Mode" +msgstr "" + +# bda9eb0bb22b4e8e8662fcd037d9d585 +#: ../../using/specifics.md:11 +msgid "" +"Spark local mode is useful for experimentation on small data when you do not" +" have a Spark cluster available." +msgstr "" + +# 91033be3c31b48d4a1a6a235491bd897 +# 6cc19049cacb4403989934496ecc4375 +#: ../../using/specifics.md:13 ../../using/specifics.md:71 +msgid "In a Python Notebook" +msgstr "" + +# 556a0ebdcab54a87b01f1b8bed45628e +# 823b89e12a514c54b10255bcc2081397 +#: ../../using/specifics.md:24 ../../using/specifics.md:98 +msgid "In a R Notebook" +msgstr "" + +# a42af3a3c0a44602b15d8d7ed52d267b +# cb0340653342464892f57379cf775ea9 +#: ../../using/specifics.md:36 ../../using/specifics.md:119 +msgid "In a Spylon Kernel Scala Notebook" +msgstr "" + +# f6efc67ea4d14900a978e0d581e6448a +#: ../../using/specifics.md:38 +msgid "" +"Spylon kernel instantiates a SparkContext for you in variable sc after you " +"configure Spark options in a %%init_spark magic cell." +msgstr "" + +# 48c05ebdfde54ea6b8794b47171a6c10 +# 66315cf3b7554105bfeaf6a3a5b43b73 +#: ../../using/specifics.md:52 ../../using/specifics.md:134 +msgid "In an Apache Toree Scala Notebook" +msgstr "" + +# 5d8060e95aa941e58a64d0465dbacafa +#: ../../using/specifics.md:54 +msgid "" +"Apache Toree instantiates a local SparkContext for you in variable sc when " +"the kernel starts." +msgstr "" + +# 1a30fe3a85fa44b1860efb1e8bf123e3 +#: ../../using/specifics.md:61 +msgid "Connecting to a Spark Cluster on Mesos" +msgstr "" + +# 74263d337820458d851a4b869d14f1cf +#: ../../using/specifics.md:63 +msgid "" +"This configuration allows your compute cluster to scale with your data." +msgstr "" + +# c7ca76d01c6e4f10ad8f793b65dc41db +#: ../../using/specifics.md:65 +msgid "Deploy Spark on Mesos." +msgstr "" + +# 296f9c1d6f2a4950a1147913198bc1bc +#: ../../using/specifics.md:66 +msgid "" +"Configure each slave with the --no-switch_user flag or create the $NB_USER " +"account on every slave node." +msgstr "" + +# 2d988e27cde44fa09feaed27ce3b7a06 +# 6045e72f079c4fc2ab9e3ce622968bc8 +#: ../../using/specifics.md:67 ../../using/specifics.md:163 +msgid "" +"Run the Docker container with --net=host in a location that is network " +"addressable by all of your Spark workers. (This is a Spark networking " +"requirement.)" +msgstr "" + +# f20142628b0f40379f87031abd6461b2 +# b00bbd0a10d4480db69f870cdf5fe094 +#: ../../using/specifics.md:68 ../../using/specifics.md:164 +msgid "" +"NOTE: When using --net=host, you must also use the flags --pid=host -e " +"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 " +"for details." +msgstr "" + +# 46c5b891e7ce4fa78d3c0eeff0e22635 +#: ../../using/specifics.md:69 +msgid "Follow the language specific instructions below." +msgstr "" + +# 90c742c66172412c862fcf09a2661bf5 +#: ../../using/specifics.md:136 +msgid "" +"The Apache Toree kernel automatically creates a SparkContext when it starts " +"based on configuration information from its command line arguments and " +"environment variables. You can pass information about your Mesos cluster via" +" the SPARK_OPTS environment variable when you spawn a container." +msgstr "" + +# 7c2b15ef25ba4cd29ff222b808a8fd68 +#: ../../using/specifics.md:138 +msgid "" +"For instance, to pass information about a Mesos master, Spark binary " +"location in HDFS, and an executor options, you could start the container " +"like so:" +msgstr "" + +# 94f9511094e044f08129c273ce3efaf0 +#: ../../using/specifics.md:146 +msgid "" +"Note that this is the same information expressed in a notebook in the Python" +" case above. Once the kernel spec has your cluster information, you can test" +" your cluster in an Apache Toree notebook like so:" +msgstr "" + +# e0c67007d0cc4c9da0fb73d5ed25356d +#: ../../using/specifics.md:157 +msgid "Connecting to a Spark Cluster in Standalone Mode" +msgstr "" + +# 6c6f7d3049814b25a3acf211e2587ec2 +#: ../../using/specifics.md:159 +msgid "" +"Connection to Spark Cluster on Standalone Mode requires the following set of" +" steps:" +msgstr "" + +# 4634540d7990421fb60e85b6241dd816 +#: ../../using/specifics.md:161 +msgid "" +"Verify that the docker image (check the Dockerfile) and the Spark Cluster " +"which is being deployed, run the same version of Spark." +msgstr "" + +# d6b4329933e24b69879a4621b26bf454 +#: ../../using/specifics.md:162 +msgid "Deploy Spark in Standalone Mode." +msgstr "" + +# 3dfcc2e12ca34c92ac8ebf96e4a37066 +#: ../../using/specifics.md:165 +msgid "" +"The language specific instructions are almost same as mentioned above for " +"Mesos, only the master url would now be something like " +"spark://10.10.10.10:7077" +msgstr "" + +# 9e271f07799e4cb0a4b79df224a5639f +#: ../../using/specifics.md:167 +msgid "Tensorflow" +msgstr "" + +# 2a525d328e6f419f98d2ed3b99978e25 +#: ../../using/specifics.md:169 +msgid "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." +msgstr "" + +# 4440ceaa200f4029b5cbaf9c895a8e5c +#: ../../using/specifics.md:171 +msgid "Single Machine Mode" +msgstr "" + +# d82de0694427429fa44d9988c1db4851 +#: ../../using/specifics.md:185 +msgid "Distributed Mode" +msgstr "" diff --git a/docs/locale/pt_BR/LC_MESSAGES/contributing.po b/docs/locale/pt_BR/LC_MESSAGES/contributing.po new file mode 100644 index 0000000000..352a46023f --- /dev/null +++ b/docs/locale/pt_BR/LC_MESSAGES/contributing.po @@ -0,0 +1,631 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pt_BR\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +# 9527c87037fb4592a05d144d80f69f89 +#: ../../contributing/features.md:1 +msgid "New Features" +msgstr "" + +# 81de205103144b289398603fa4aee789 +#: ../../contributing/features.md:3 +msgid "" +"Thank you for contributing to the Jupyter Docker Stacks! We review pull " +"requests of new features (e.g., new packages, new scripts, new flags) to " +"balance the value of the images to the Jupyter community with the cost of " +"maintaining the images over time." +msgstr "" + +# b35331d86206420aa8235d20ef037215 +#: ../../contributing/features.md:5 +msgid "Suggesting a New Feature" +msgstr "" + +# 6c6b00518c1f4dc88049b82f213a36cc +#: ../../contributing/features.md:7 +msgid "" +"Please follow the process below to suggest a new feature for inclusion in " +"one of the core stacks:" +msgstr "" + +# a9cd9d0730cc4159aa227e970ae2d9d0 +#: ../../contributing/features.md:9 +msgid "Open a GitHub issue describing the feature you'd like to contribute." +msgstr "" + +# 8433ea2c70b94556b9a62c35cb88a4c8 +#: ../../contributing/features.md:10 +msgid "" +"Discuss with the maintainers whether the addition makes sense in one of the " +"core stacks, as a recipe in the documentation, as a community stack, or as " +"something else entirely." +msgstr "" + +# a995c15adfb7424e9852693b90569d7a +#: ../../contributing/features.md:12 +msgid "Selection Criteria" +msgstr "" + +# 981cef217f4e4225984c5c7989f592f8 +#: ../../contributing/features.md:14 +msgid "" +"Roughly speaking, we evaluate new features based on the following criteria:" +msgstr "" + +# 32194c09119e428a871acb859d696500 +#: ../../contributing/features.md:16 +msgid "" +"Usefulness to Jupyter users: Is the feature generally applicable across " +"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?" +msgstr "" + +# 7b5acf7ef5854ac4b2c55b1a51464796 +#: ../../contributing/features.md:17 +msgid "" +"Fit with the image purpose: Does the feature match the theme of the stack in" +" which it will be added? Would it fit better in a new, community stack?" +msgstr "" + +# 55d1f51c3b264dcfb252771c83d8ca36 +#: ../../contributing/features.md:18 +msgid "" +"Complexity of build / runtime configuration: How many lines of code does the" +" feature require in one of the Dockerfiles or startup scripts? Does it " +"require new scripts entirely? Do users need to adjust how they use the " +"images?" +msgstr "" + +# 2a332f3b95064b43a1833166fd84f53c +#: ../../contributing/features.md:19 +msgid "" +"Impact on image metrics: How many bytes does the feature and its " +"dependencies add to the image(s)? How many minutes do they add to the build " +"time?" +msgstr "" + +# 30966a8cde0844bd85f6114c65f79ec4 +#: ../../contributing/features.md:20 +msgid "" +"Ability to support the addition: Can existing maintainers answer user " +"questions and address future build issues? Are the contributors interested " +"in helping with long-term maintenance? Can we write tests to ensure the " +"feature continues to work over time?" +msgstr "" + +# 6085a8c0829e411588a37777bfe5e0f4 +#: ../../contributing/features.md:22 +msgid "Submitting a Pull Request" +msgstr "" + +# fa5dc8dbaedb483b888622cc9d1e94ae +#: ../../contributing/features.md:24 +msgid "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" +msgstr "" + +# 23ae2ae62bdb4a35bc42d9efc7759944 +#: ../../contributing/features.md:26 +msgid "" +"Implement the feature in a local clone of the jupyter/docker-stacks project." +msgstr "" + +# ef476261493c48d998fb384d651b4012 +#: ../../contributing/features.md:27 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 6bd20fd181f44e39a4913154db0c7221 +# 4277e486510d49a08448d209a5cdad69 +# f8c596a67a4f43c1a1c82a0f38a846f7 +#: ../../contributing/features.md:31 ../../contributing/packages.md:13 +#: ../../contributing/tests.md:20 +msgid "Submit a pull request (PR) with your changes." +msgstr "" + +# a7aa4a8d9d3d44eda2f1cf757e569c4e +# d8f1d1f00b2a4e9690b4e0da736ac662 +# e4f93545f2284342a2b3ad1f52eaf26c +#: ../../contributing/features.md:32 ../../contributing/packages.md:14 +#: ../../contributing/tests.md:21 +msgid "" +"Watch for Travis to report a build success or failure for your PR on GitHub." +msgstr "" + +# f80657a299424b8685d452d70479bae6 +#: ../../contributing/features.md:33 +msgid "Discuss changes with the maintainers and address any build issues." +msgstr "" + +# 57ead3e81b9b4ebaa7a3491818f60089 +#: ../../contributing/issues.md:1 +msgid "Project Issues" +msgstr "" + +# f27080bf0c8d43a08f283b3c5e28ddc7 +#: ../../contributing/issues.md:3 +msgid "" +"We appreciate your taking the time to report an issue you encountered using " +"the Jupyter Docker Stacks. Please review the following guidelines when " +"reporting your problem." +msgstr "" + +# 3713984479614d4aa9237328bc2e233b +#: ../../contributing/issues.md:7 +msgid "" +"If you believe you’ve found a security vulnerability in any of the Jupyter " +"projects included in Jupyter Docker Stacks images, please report it to " +"security@ipython.org, not in the issue trackers on GitHub. If you prefer to " +"encrypt your security reports, you can use this PGP public key." +msgstr "" + +# 0c7fad6ee9304bbe80baf1737d0f478c +#: ../../contributing/issues.md:13 +msgid "" +"If you think your problem is unique to the Jupyter Docker Stacks images, " +"please search the jupyter/docker-stacks issue tracker to see if someone else" +" has already reported the same problem. If not, please open a new issue and " +"provide all of the information requested in the issue template." +msgstr "" + +# 70860cacf75b40a687363712f3bf00ce +#: ../../contributing/issues.md:19 +msgid "" +"If the issue you're seeing is with one of the open source libraries included" +" in the Docker images and is reproducible outside the images, please file a " +"bug with the appropriate open source project." +msgstr "" + +# 76822159e56f40f3bb38ea93e054238c +#: ../../contributing/issues.md:22 +msgid "" +"If you have a general question about how to use the Jupyter Docker Stacks in" +" your environment, in conjunction with other tools, with customizations, and" +" so on, please post your question on the Jupyter Discourse site." +msgstr "" + +# 3815aec9c791444cbdf26a71e28a1f7c +#: ../../contributing/packages.md:1 +msgid "Package Updates" +msgstr "" + +# 0bc1f6af65c74cc5a812a14b9c5a055f +#: ../../contributing/packages.md:3 +msgid "" +"We actively seek pull requests which update packages already included in the" +" project Dockerfiles. This is a great way for first-time contributors to " +"participate in developing the Jupyter Docker Stacks." +msgstr "" + +# ff8faef49758489fb97ddaba60763a0e +#: ../../contributing/packages.md:5 +msgid "Please follow the process below to update a package version:" +msgstr "" + +# e3878a1a1a444bb592fe32f468693ed7 +#: ../../contributing/packages.md:7 +msgid "" +"Locate the Dockerfile containing the library you wish to update (e.g., base-" +"notebook/Dockerfile, scipy-notebook/Dockerfile)" +msgstr "" + +# d5aac81ecab24592860296ab74936724 +#: ../../contributing/packages.md:8 +msgid "" +"Adjust the version number for the package. We prefer to pin the major and " +"minor version number of packages so as to minimize rebuild side-effects when" +" users submit pull requests (PRs). For example, you'll find the Jupyter " +"Notebook package, notebook, installed using conda with notebook=5.4.*." +msgstr "" + +# 0eed3a80d95146bab769d4456addcce4 +#: ../../contributing/packages.md:9 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 1be104e942024f2b98eb10e0006b9de3 +#: ../../contributing/packages.md:15 +msgid "" +"Discuss changes with the maintainers and address any build issues. Version " +"conflicts are the most common problem. You may need to upgrade additional " +"packages to fix build failures." +msgstr "" + +# adf5db8b690d466a8d339c756a5a153c +#: ../../contributing/recipes.md:1 +msgid "New Recipes" +msgstr "" + +# 7d306f8fe4a641e4a48b61111c16b8e8 +#: ../../contributing/recipes.md:3 +msgid "" +"We welcome contributions of recipes, short examples of using, configuring, " +"or extending the Docker Stacks, for inclusion in the documentation site. " +"Follow the process below to add a new recipe:" +msgstr "" + +# 5b84ed1b594845ec81f39b87e7c5d82b +#: ../../contributing/recipes.md:5 +msgid "Open the docs/using/recipes.md source file." +msgstr "" + +# 52f2b459bff447fe82c60ea02c4e751c +#: ../../contributing/recipes.md:6 +msgid "" +"Add a second-level Markdown heading naming your recipe at the bottom of the " +"file (e.g., `## Add the RISE extension``)" +msgstr "" + +# 56b4b4356d3e45f5bbe6eb14f9540628 +#: ../../contributing/recipes.md:7 +msgid "" +"Write the body of your recipe under the heading, including whatever command " +"line, Dockerfile, links, etc. you need." +msgstr "" + +# 6a3115ec07cf42a28c755a607658f855 +# f4f9a3d6544b4e4087e97124098459eb +#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111 +msgid "" +"Submit a pull request (PR) with your changes. Maintainers will respond and " +"work with you to address any formatting or content issues." +msgstr "" + +# 0b8332c390304a1ab29a4b2b030e7997 +#: ../../contributing/stacks.md:1 +msgid "Community Stacks" +msgstr "" + +# 69ee7d697c7240b78ea8c7873fc1528b +#: ../../contributing/stacks.md:3 +msgid "" +"We love to see the community create and share new Jupyter Docker images. " +"We've put together a cookiecutter project and the documentation below to " +"help you get started defining, building, and sharing your Jupyter " +"environments in Docker. Following these steps will:" +msgstr "" + +# 0f392d5680ba4ea2812ff450f8e19d44 +#: ../../contributing/stacks.md:5 +msgid "" +"Setup a project on GitHub containing a Dockerfile based on either the " +"jupyter/base-notebook or jupyter/minimal-notebook image." +msgstr "" + +# c05df9d2cf8c4505b0951f0ea88f1daf +#: ../../contributing/stacks.md:6 +msgid "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." +msgstr "" + +# 077482de9feb4fa2b1e5e477fd5591f1 +#: ../../contributing/stacks.md:7 +msgid "" +"Configure Docker Cloud to build and host your images for others to use." +msgstr "" + +# e2fe70e1ea6e4322a8dfa4380f8e54bb +#: ../../contributing/stacks.md:8 +msgid "" +"Update the list of community stacks in this documentation to include your " +"image." +msgstr "" + +# 3af1a3dc1eae4a7d96a883b911fc5894 +#: ../../contributing/stacks.md:10 +msgid "" +"This approach mirrors how we build and share the core stack images. Feel " +"free to follow it or pave your own path using alternative services and build" +" tools." +msgstr "" + +# 0107f213096c41c8b1cb367b84fee30d +#: ../../contributing/stacks.md:12 +msgid "Creating a Project" +msgstr "" + +# cb35d196dc42402f9b338e56fcd3faa6 +#: ../../contributing/stacks.md:14 +msgid "First, install cookiecutter using pip or conda:" +msgstr "" + +# 09066f77e38c42889844dafb226df4bd +#: ../../contributing/stacks.md:20 +msgid "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." +msgstr "" + +# 26f05981d3fe49abb07bba85a4a3890f +#: ../../contributing/stacks.md:26 +msgid "" +"Enter a name for your new stack image. This will serve as both the git " +"repository name and the part of the Docker image name after the slash." +msgstr "" + +# c6aba910076b49ca97dcb902f13d2a4d +#: ../../contributing/stacks.md:33 +msgid "" +"Enter the user or organization name under which this stack will reside on " +"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in " +"order to push images here and setup automated builds." +msgstr "" + +# 176a346034074822b7634c6c86dace42 +#: ../../contributing/stacks.md:41 +msgid "" +"Select an image from the jupyter/docker-stacks project that will serve as " +"the base for your new image." +msgstr "" + +# 3611e7452640414d9d0535292abd113d +#: ../../contributing/stacks.md:48 +msgid "Enter a longer description of the stack for your README." +msgstr "" + +# 782321361a3b4116a2d3dafa7cc1424f +#: ../../contributing/stacks.md:54 +msgid "Initialize your project as a Git repository and push it to GitHub." +msgstr "" + +# b699fe5155774c93938427a241d0f239 +#: ../../contributing/stacks.md:66 +msgid "Configuring Travis" +msgstr "" + +# 6440a7c3a9444dda88445913807d1a48 +#: ../../contributing/stacks.md:68 +msgid "" +"Next, link your GitHub project to Travis CI to build your Docker image " +"whenever you or someone else submits a pull request." +msgstr "" + +# c0613debece54f82a922700157994c5b +#: ../../contributing/stacks.md:70 +msgid "" +"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-" +"Travis-CI and follow the instructions to add the Travis CI application to " +"your GitHub account." +msgstr "" + +# 4cf36f34a47b410a982be3237af720cd +#: ../../contributing/stacks.md:71 +msgid "Visit https://travis-ci.org." +msgstr "" + +# fdd694f5ebf443ce9d2d220d5945c299 +#: ../../contributing/stacks.md:72 +msgid "Click the + symbol at the top of the left sidebar." +msgstr "" + +# 05acff6addad4f919fe21c27329b1e51 +#: ../../contributing/stacks.md:74 +msgid "" +"Locate your project repository either in your primary user account or in one" +" of the organizations to which you belong." +msgstr "" + +# a1917b1360434fb18a3522e0a9806a11 +#: ../../contributing/stacks.md:75 +msgid "Click the toggle to enable builds for the project repository." +msgstr "" + +# 7dcbafc96c4a4ef88d7bc34e31a0af04 +#: ../../contributing/stacks.md:76 +msgid "Click the Settings button for that repository." +msgstr "" + +# dd006e53f5cc4c1ea1501d62119f526e +#: ../../contributing/stacks.md:78 +msgid "" +"Enable Build only if .travis.yml is present and Build pushed pull requests." +msgstr "" + +# 0a5e54cd5f294a52983c2ec73559f810 +#: ../../contributing/stacks.md:80 +msgid "Disable Build pushed branches." +msgstr "" + +# 2ddf5289794648a3b7d1f604ce744331 +#: ../../contributing/stacks.md:82 +msgid "Configuring Docker Cloud" +msgstr "" + +# 5108ce3f722a430eb29e1a5928a86fcf +#: ../../contributing/stacks.md:84 +msgid "" +"Now, configure Docker Cloud to build your stack image and push it to Docker " +"Hub repository whenever you merge a GitHub pull request to the master branch" +" of your project." +msgstr "" + +# 7ab258ec2f1e4942a983996a6c5e6fa5 +#: ../../contributing/stacks.md:86 +msgid "Visit https://cloud.docker.com/ and login." +msgstr "" + +# 3677166ebbc04b2aafc4f117e33f6bf5 +#: ../../contributing/stacks.md:87 +msgid "" +"Select the account or organization matching the one you entered when " +"prompted with stack_org by the cookiecutter." +msgstr "" + +# 0997628fd41449c5b0598e7e1bf1f005 +#: ../../contributing/stacks.md:89 +msgid "Scroll to the bottom of the page and click Create repository." +msgstr "" + +# 8504105c95594c288fdd9066006757b0 +#: ../../contributing/stacks.md:90 +msgid "" +"Enter the name of the image matching the one you entered when prompted with " +"stack_name by the cookiecutter." +msgstr "" + +# c92796a106c846f585c88fb5a015fa6d +#: ../../contributing/stacks.md:92 +msgid "Enter a description for your image." +msgstr "" + +# fba832c82f3042499563598365fedfd5 +#: ../../contributing/stacks.md:93 +msgid "" +"Click GitHub under the Build Settings and follow the prompts to connect your" +" account if it is not already connected." +msgstr "" + +# bff3581410014975943ca77637142f14 +#: ../../contributing/stacks.md:94 +msgid "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." +msgstr "" + +# 72cbc93bfe354e279e9384e7c95c801b +#: ../../contributing/stacks.md:96 +msgid "Click the Create and Build button." +msgstr "" + +# bbb495328efd4fe7b339b7a7ffe908b0 +#: ../../contributing/stacks.md:98 +msgid "Defining Your Image" +msgstr "" + +# 60052c2d1afc4a57baa59c1bf22d321c +#: ../../contributing/stacks.md:100 +msgid "" +"Make edits the Dockerfile in your project to add third-party libraries and " +"configure Jupyter applications. Refer to the Dockerfiles for the core stacks" +" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and " +"best practices." +msgstr "" + +# 0855b53115ae4b6780cc82c9389224cb +#: ../../contributing/stacks.md:102 +msgid "" +"Submit pull requests to your project repository on GitHub. Ensure your image" +" builds properly on Travis before merging to master. Refer to Docker Cloud " +"for builds of your master branch that you can docker pull." +msgstr "" + +# de4bcc6e0ac1468ea761c038661ca19f +#: ../../contributing/stacks.md:104 +msgid "Sharing Your Image" +msgstr "" + +# a67495f9ae984a368364a698084f060e +#: ../../contributing/stacks.md:106 +msgid "" +"Finally, if you'd like to add a link to your project to this documentation " +"site, please do the following:" +msgstr "" + +# 7357ed96047e42e6ae9e4bf123a00bed +#: ../../contributing/stacks.md:108 +msgid "Clone ths jupyter/docker-stacks GitHub repository." +msgstr "" + +# ee9284fe69244dcd8d44b25b8dc8b3a2 +#: ../../contributing/stacks.md:109 +msgid "" +"Open the docs/using/selecting.md source file and locate the Community Stacks" +" section." +msgstr "" + +# aa0e41b99c354b5b88336489084e2006 +#: ../../contributing/stacks.md:110 +msgid "" +"Add a bullet with a link to your project and a short description of what " +"your Docker image contains." +msgstr "" + +# 0f652c5259d544b595e847365dfe843a +#: ../../contributing/tests.md:1 +msgid "Image Tests" +msgstr "" + +# 569da0112572470b9bc5f045bcfb49d0 +#: ../../contributing/tests.md:3 +msgid "" +"We greatly appreciate pull requests that extend the automated tests that vet" +" the basic functionality of the Docker images." +msgstr "" + +# 67b27592447e47af8b0b00eeb745fc70 +#: ../../contributing/tests.md:5 +msgid "How the Tests Work" +msgstr "" + +# e2c3d76accff489eb2a6eab7b55ae3be +#: ../../contributing/tests.md:7 +msgid "" +"Travis executes make build-test-all against every pull request submitted to " +"the jupyter/docker-stacks repository. The make command builds every docker " +"image. After building each image, the make command executes pytest to run " +"both image-specific tests like those in base-notebook/test/ and common tests" +" defined in test/. Both kinds of tests make use of global pytest fixtures " +"defined in the conftest.py file at the root of the projects." +msgstr "" + +# 15207b72b26741f0a6a77949a4d9d0f4 +#: ../../contributing/tests.md:9 +msgid "Contributing New Tests" +msgstr "" + +# 5470865e6d144e51a428221e49e448fb +#: ../../contributing/tests.md:11 +msgid "Please follow the process below to add new tests:" +msgstr "" + +# 36aedaa2624c4e4493af145bc5f246e0 +#: ../../contributing/tests.md:13 +msgid "" +"If the test should run against every image built, add your test code to one " +"of the modules in test/ or create a new module." +msgstr "" + +# dccbb0425be7438db7ade2f4892c6c25 +#: ../../contributing/tests.md:14 +msgid "" +"If your test should run against a single image, add your test code to one of" +" the modules in some-notebook/test/ or create a new module." +msgstr "" + +# 33ab248b51d24fa0b29923489bf6dfbf +#: ../../contributing/tests.md:15 +msgid "" +"Build one or more images you intend to test and run the tests locally. If " +"you use make, call:" +msgstr "" + +# 0453d92037cb4e47a025bc9021bdc7db +#: ../../contributing/tests.md:22 +msgid "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." +msgstr "" diff --git a/docs/locale/pt_BR/LC_MESSAGES/index.po b/docs/locale/pt_BR/LC_MESSAGES/index.po new file mode 100644 index 0000000000..8478557bda --- /dev/null +++ b/docs/locale/pt_BR/LC_MESSAGES/index.po @@ -0,0 +1,177 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Allan Neri Fernandes da Silva , 2019 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Last-Translator: Allan Neri Fernandes da Silva , 2019\n" +"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pt_BR\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +# 85291a2c92d440a089cf156fba58b86a +#: ../../index.rst:32 ../../index.rst:32 +msgid "User Guide" +msgstr "Guia de uso" + +# e4a3fd32059d4486b6b0f3a6fb5065b5 +#: ../../index.rst:42 ../../index.rst:42 +msgid "Contributor Guide" +msgstr "Guia de contribuição" + +# 45de48c8617d4ebe83b7ff7141295836 +#: ../../index.rst:53 ../../index.rst:53 +msgid "Maintainer Guide" +msgstr "Guia de manutenção" + +# aa99c4562d8d4cb3abfea375470e8af3 +#: ../../index.rst:59 ../../index.rst:59 +msgid "Getting Help" +msgstr "Obtendo ajuda" + +# 76df09037a6147c8a85be8ef14c15532 +#: ../../index.rst:2 +msgid "Jupyter Docker Stacks" +msgstr "Jupyter Docker Stacks" + +# b3fb253184e64174b26a2da73f221cc1 +#: ../../index.rst:4 +msgid "" +"Jupyter Docker Stacks are a set of ready-to-run Docker images containing " +"Jupyter applications and interactive computing tools. You can use a stack " +"image to do any of the following (and more):" +msgstr "" +"Jupyter Docker Stacks são um conjunto de imagens Docker prontas para uso " +"contendo aplicações Jupyter e ferramentas interativas. Você pode usar uma " +"pilha de imagens para fazer qualquer uma dessas coisas (e muito mais):" + +# 8cd55fb113a049e7be445b21084df7ea +#: ../../index.rst:6 +msgid "Start a personal Jupyter Notebook server in a local Docker container" +msgstr "Rodar um servidor Jupyter Notebook em um container Docker local" + +# 285fa13bed8547b4af0cfc480adf4861 +#: ../../index.rst:7 +msgid "Run JupyterLab servers for a team using JupyterHub" +msgstr "Rode um servidor JupyterLab para uma equipe usando JupyterHub" + +# a49d31cedd4946ea98d7a4c720340d84 +#: ../../index.rst:8 +msgid "Write your own project Dockerfile" +msgstr "Escrever seu próprio Dockerfile" + +# 0aff0df2e46a44b4bc8070545e83c42c +#: ../../index.rst:11 +msgid "Quick Start" +msgstr "Guia rápido" + +# 3262accd283140058db73005072be200 +#: ../../index.rst:13 +msgid "" +"You can try a `recent build of the jupyter/base-notebook image on " +"mybinder.org `_ by simply clicking the preceding " +"link. Otherwise, the two examples below may help you get started if you " +"`have Docker installed `_, know " +":doc:`which Docker image ` you want to use, and want to " +"launch a single Jupyter Notebook server in a container." +msgstr "" +"Você pode tentar um `build recente da imagem do jupyter/base-notebook em " +"mybinder.org `_ simplesmente clicando neste link. " +"Caso contrário, os dois exemplos abaixo podem te ajudar a começar se você " +"`já tem o Docker instalado `_ , sabe " +":doc:`qual imagem ` usar, e quer iniciar um servidor " +"Jupyter Notebook em um contêiner." + +# 9e4094e8de264e20bca0af8f6cf888b7 +#: ../../index.rst:15 +msgid "" +"The other pages in this documentation describe additional uses and features " +"in detail." +msgstr "" +"As próximas paginas desta documentação descrevem os usos e as " +"funcionalidades adicionais com mais detalhes" + +# 8b75310f2eaa4aac95d9387e0a4db9e8 +#: ../../index.rst:17 +msgid "" +"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image " +"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the " +"local host. It then starts a container running a Jupyter Notebook server and" +" exposes the server on host port 8888. The server logs appear in the " +"terminal. Visiting ``http://:8888/?token=`` in a browser " +"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of" +" the computer running docker and ``token`` is the secret token printed in " +"the console. The container remains intact for restart after the notebook " +"server exits.::" +msgstr "" +"**Exemplo 1:** Este comando faz um pull da imagem ``jupyter/scipy-notebook``" +" com a tag ``17aba6048f44`` do Docker Hub se ela ainda não estiver em sua " +"maquina local. Em seguida inicia um contêiner executando um servidor Jupyter" +" Notebook e expondo a porta 8888 do host. Os logs do servidor aparecem no " +"terminal. Acessando o endereço ``http://:8888/?token=`` " +"através de um navegador carregará o painel de controle do Jupyter Notebook, " +"onde ``hostname`` é o nome do computador executando o docker e ``token`` é o" +" token secreto exibido no console. O contêiner permanece intacto para " +"reinicialização após o termino do servidor.::" + +# 9e0229c99f404aceb7e517387ae88365 +#: ../../index.rst:21 +msgid "" +"**Example 2:** This command performs the same operations as **Example 1**, " +"but it exposes the server on host port 10000 instead of port 8888. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console.::" +msgstr "" +"**Exemplo 2:** Este comando faz as mesma coisas do **Exemplo 1**, mas expõe " +"a porta 10000 do host em vez da 8888. Acessando o endereço " +"``http://:10000/?token=`` através de um navegador carregará" +" o JupyterLab, onde ``hostname`` é o nome do computador executando o docker " +"e ``token`` é o token secreto exibido no console.::" + +# 02c25d3f0abe48348100dd878c243a75 +#: ../../index.rst:25 +msgid "" +"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image" +" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the" +" local host. It then starts an *ephemeral* container running a Jupyter " +"Notebook server and exposes the server on host port 10000. The command " +"mounts the current working directory on the host as ``/home/jovyan/work`` in" +" the container. The server logs appear in the terminal. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console. Docker destroys the container " +"after notebook server exit, but any files written to ``~/work`` in the " +"container remain intact on the host.::" +msgstr "" +"**Exemplo 3:** Este comando faz um pull da imagem ``jupyter/datascience-" +"notebook`` com a tag ``9b06df75e445`` do Docker Hub se ela ainda não estiver" +" em sua maquina local. Em seguida inicia um contêiner *passageiro* rodando " +"um servidor Jupyter Notebook expondo no host a porta 10000 do servidor. O " +"comando associa o diretório atual do host com o diretório " +"``/home/jovyan/work`` do contêiner. Os logs do servidor aparecem no " +"terminal. Acessando o endereço ``http://:10000/?token=`` " +"através de um navegador carregará o JupyterLab, onde ``hostname`` é o nome " +"do computador executando o docker e ``token`` é o token secreto exibido no " +"console. O Docker destrói o contêiner depois que o servidor for finalizado, " +"mas os arquivos escritos em ``~work`` do contêiner permanecem intactos no " +"host.::" + +# 1bc0c7d54cd343d689362047c0b00122 +#: ../../index.rst:30 +msgid "Table of Contents" +msgstr "Índice" diff --git a/docs/locale/pt_BR/LC_MESSAGES/maintaining.po b/docs/locale/pt_BR/LC_MESSAGES/maintaining.po new file mode 100644 index 0000000000..fc0e3f25d4 --- /dev/null +++ b/docs/locale/pt_BR/LC_MESSAGES/maintaining.po @@ -0,0 +1,277 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pt_BR\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +# cefae71d9a804ab69c7e9f0a53eb7475 +#: ../../maintaining/tasks.md:1 +msgid "Maintainer Playbook" +msgstr "" + +# af6a24b053794e55bddfe6e2e21ae74f +#: ../../maintaining/tasks.md:3 +msgid "Merging Pull Requests" +msgstr "" + +# c34b1d3b543346689adbca91331ac048 +#: ../../maintaining/tasks.md:5 +msgid "" +"To build new images on Docker Cloud and publish them to the Docker Hub " +"registry, do the following:" +msgstr "" + +# 1597bb99448f41b994d1c7073b9c8721 +#: ../../maintaining/tasks.md:7 +msgid "Make sure Travis is green for a PR." +msgstr "" + +# 401ed2733771440e8ef089f54cf2984d +#: ../../maintaining/tasks.md:8 +msgid "Merge the PR." +msgstr "" + +# 6d0bf2e7538640a0989e56df3c9d1106 +#: ../../maintaining/tasks.md:9 +msgid "" +"Monitor the Docker Cloud build status for each of the stacks, starting with " +"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the " +"stack hierarchy diagram for the current, complete build order." +msgstr "" + +# 428124fa830d4c74a618d7b3c696599c +#: ../../maintaining/tasks.md:10 +msgid "" +"Manually click the retry button next to any build that fails to resume that " +"build and any dependent builds." +msgstr "" + +# c4034a02dab8435f8d76c2d32321a262 +#: ../../maintaining/tasks.md:11 +msgid "" +"Try to avoid merging another PR to master until all outstanding builds " +"complete. There's no way at present to propagate the git SHA to build " +"through the Docker Cloud build trigger API. Every build trigger works off of" +" master HEAD." +msgstr "" + +# 62ddd25e15064cea950f9f13a663dcdb +#: ../../maintaining/tasks.md:13 +msgid "Updating the Ubuntu Base Image" +msgstr "" + +# 091b1ce707f44bc6ae9742cf55b92ebf +#: ../../maintaining/tasks.md:15 +msgid "" +"When there's a security fix in the Ubuntu base image or after some time " +"passes, it's a good idea to update the pinned SHA in the jupyter/base-" +"notebook Dockerfile. Submit it as a regular PR and go through the build " +"process. Expect the build to take a while to complete: every image layer " +"will rebuild." +msgstr "" + +# d834495e774a4fee952324e4cc5ab514 +#: ../../maintaining/tasks.md:17 +msgid "Adding a New Core Image to Docker Cloud" +msgstr "" + +# b765140c2d1446849b747351532d6290 +#: ../../maintaining/tasks.md:19 +msgid "" +"When there's a new stack definition, do the following before merging the PR " +"with the new stack:" +msgstr "" + +# b7b25a83cd3246bd886926722c30ac1a +#: ../../maintaining/tasks.md:21 +msgid "" +"Ensure the PR includes an update to the stack overview diagram in the " +"documentation. The image links to the blockdiag source used to create it." +msgstr "" + +# 50edc8e02aa9497d81dc312eafe5d2bf +#: ../../maintaining/tasks.md:22 +msgid "" +"Ensure the PR updates the Makefile which is used to build the stacks in " +"order on Travis CI." +msgstr "" + +# fabcb32a80a04a639aebd8b55d38119e +#: ../../maintaining/tasks.md:23 +msgid "" +"Create a new repository in the jupyter org on Docker Cloud named after the " +"stack folder in the git repo." +msgstr "" + +# 1811dcec60e3433d94514eaeebecb44b +#: ../../maintaining/tasks.md:24 +msgid "Grant the stacks team permission to write to the repo." +msgstr "" + +# afa7b1fcb0224380a111fe94f7781d60 +#: ../../maintaining/tasks.md:25 +msgid "Click Builds and then Configure Automated Builds for the repository." +msgstr "" + +# 35b969b9f7a442d99f54a73494033d90 +#: ../../maintaining/tasks.md:26 +msgid "Select jupyter/docker-stacks as the source repository." +msgstr "" + +# fe715af4446d409cb4d5ee81255bd86e +#: ../../maintaining/tasks.md:27 +msgid "" +"Choose Build on Docker Cloud's infrastructure using a Small node unless you " +"have reason to believe a bigger host is required." +msgstr "" + +# dc41895431b64657b5e24a8c96779ca6 +#: ../../maintaining/tasks.md:28 +msgid "" +"Update the Build Context in the default build rule to be /." +msgstr "" + +# e4d220bf1cb54781bc03f16a17ddafb8 +#: ../../maintaining/tasks.md:29 +msgid "" +"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., " +"like jupyter/base-notebook)." +msgstr "" + +# c5a459d038714ff78d4f156ee227d9ca +#: ../../maintaining/tasks.md:30 +msgid "" +"If the new stack depends on the build of another stack in the hierarchy:" +msgstr "" + +# 611376c2ec6942479f60129177d312cc +#: ../../maintaining/tasks.md:31 +msgid "Hit Save and then click Configure Automated Builds." +msgstr "" + +# 81cc56c63891432d89d4df3001f1bcde +#: ../../maintaining/tasks.md:32 +msgid "At the very bottom, add a build trigger named Stack hierarchy trigger." +msgstr "" + +# 9e55682a966a422c846a3463c7a30cfe +#: ../../maintaining/tasks.md:33 +msgid "Copy the build trigger URL." +msgstr "" + +# a9d853a1d45b4ead965813822a96c934 +#: ../../maintaining/tasks.md:34 +msgid "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." +msgstr "" + +# 327d4522c3884247871aa406bbe19402 +#: ../../maintaining/tasks.md:35 +msgid "" +"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma" +" separated list of URLs, creating that environment variable if it does not " +"already exist." +msgstr "" + +# 1aa0e4b95ab847e0be8ac9647433c991 +# 7dfff62380a041968ee6e739b1ca271f +#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40 +msgid "Hit Save." +msgstr "" + +# 8315ed043efb40238227f8be0ad61b52 +#: ../../maintaining/tasks.md:37 +msgid "If the new stack should trigger other dependent builds:" +msgstr "" + +# 6e0e15d05a544476b91794d10b8732ff +#: ../../maintaining/tasks.md:38 +msgid "Add an environment variable named NEXT_BUILD_TRIGGERS." +msgstr "" + +# 9dc2029e6360433ab7181187f7040d48 +#: ../../maintaining/tasks.md:39 +msgid "" +"Copy the build trigger URLs from the dependent builds into the " +"NEXT_BUILD_TRIGGERS comma separated list of URLs." +msgstr "" + +# 89165b279d9142e9b8e5d7a923fca2be +#: ../../maintaining/tasks.md:41 +msgid "" +"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order " +"matches that in the stack hierarchy diagram." +msgstr "" + +# 51c8151943794bc8b1d51d65ccd84736 +#: ../../maintaining/tasks.md:43 +msgid "Adding a New Maintainer Account" +msgstr "" + +# 1994c19e7a734b2cad9af0afcd7da31e +#: ../../maintaining/tasks.md:45 +msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" +msgstr "" + +# 390ccdde528146bbbc3d2f62717a647c +#: ../../maintaining/tasks.md:46 +msgid "Add the maintainer's Docker Cloud username." +msgstr "" + +# b0227c37244c4b82848cc2655f134d21 +#: ../../maintaining/tasks.md:47 +msgid "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members" +msgstr "" + +# b0fdbdd14b1444d1b696d8367aa111fb +#: ../../maintaining/tasks.md:48 +msgid "Add the maintainer's GitHub username." +msgstr "" + +# abe2cb04fcb9447496bf3bc9fb230cdc +#: ../../maintaining/tasks.md:50 +msgid "Pushing a Build Manually" +msgstr "" + +# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd +#: ../../maintaining/tasks.md:52 +msgid "" +"If automated builds on Docker Cloud have got you down, do the following to " +"push a build manually:" +msgstr "" + +# 3ebef623fa2f46f49ef639ad17105d4a +#: ../../maintaining/tasks.md:54 +msgid "Clone this repository." +msgstr "" + +# dcf8e9e8c72e40b9aa23c090311d6ea2 +#: ../../maintaining/tasks.md:55 +msgid "Check out the git SHA you want to build and publish." +msgstr "" + +# fe788ad30f694b1f9b013cabfa820343 +#: ../../maintaining/tasks.md:56 +msgid "docker login with your Docker Hub/Cloud credentials." +msgstr "" + +# 649dc474ffaa483eb625ed8061cb0097 +#: ../../maintaining/tasks.md:57 +msgid "Run make retry/release-all." +msgstr "" diff --git a/docs/locale/pt_BR/LC_MESSAGES/using.po b/docs/locale/pt_BR/LC_MESSAGES/using.po new file mode 100644 index 0000000000..0af4ed4cfa --- /dev/null +++ b/docs/locale/pt_BR/LC_MESSAGES/using.po @@ -0,0 +1,1530 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pt_BR\n" +"Plural-Forms: nplurals=2; plural=(n > 1);\n" + +# 22b65331d42e414b9320143d30499447 +#: ../../using/common.md:1 +msgid "Common Features" +msgstr "" + +# dd3cb2a88856437aad5f76b607f80deb +#: ../../using/common.md:3 +msgid "" +"A container launched from any Jupyter Docker Stacks image runs a Jupyter " +"Notebook server by default. The container does so by executing a start-" +"notebook.sh script. This script configures the internal container " +"environment and then runs jupyter notebook, passing it any command line " +"arguments received." +msgstr "" + +# 4bc2911886254b1cafcffcce7d7ef9b3 +#: ../../using/common.md:5 +msgid "" +"This page describes the options supported by the startup script as well as " +"how to bypass it to run alternative commands." +msgstr "" + +# bb55c8d7786e4c1f8e11c1e309931c41 +#: ../../using/common.md:7 +msgid "Notebook Options" +msgstr "" + +# 66f14be1ff1746c1abdccafb894fa2e6 +#: ../../using/common.md:9 +msgid "" +"You can pass Jupyter command line options to the start-notebook.sh script " +"when launching the container. For example, to secure the Notebook server " +"with a custom password hashed using IPython.lib.passwd() instead of the " +"default token, you can run the following:" +msgstr "" + +# 5d73f06cae2c4990a942c76988f19c1f +#: ../../using/common.md:15 +msgid "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" +msgstr "" + +# 9d43ee0e147b43469f56c4895720f682 +#: ../../using/common.md:21 +msgid "Docker Options" +msgstr "" + +# 3f0f5c9d0b254d829e6f07e0a2ca2544 +#: ../../using/common.md:23 +msgid "" +"You may instruct the start-notebook.sh script to customize the container " +"environment before launching the notebook server. You do so by passing " +"arguments to the docker run command." +msgstr "" + +# 4621c78dfaeb43379c5d3437238b2ef8 +#: ../../using/common.md:26 +msgid "" +"-e NB_USER=jovyan - Instructs the startup script to change the default " +"container username from jovyan to the provided value. Causes the script to " +"rename the jovyan user home folder. For this option to take effect, you must" +" run the container with --user root and set the working directory -w " +"/home/$NB_USER. This feature is useful when mounting host volumes with " +"specific home folder." +msgstr "" + +# 9120ad3c28c84f3fbb2433c79a83907a +#: ../../using/common.md:27 +msgid "" +"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID " +"of $NB_USER to the given value. This feature is useful when mounting host " +"volumes with specific owner permissions. For this option to take effect, you" +" must run the container with --user root. (The startup script will su " +"$NB_USER after adjusting the user ID.) You might consider using modern " +"Docker options --user and --group-add instead. See the last bullet below for" +" details." +msgstr "" + +# f2a9954159b546468e50a4d9665dd534 +#: ../../using/common.md:28 +msgid "" +"-e NB_GID=100 - Instructs the startup script to change the primary group " +"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it" +" is defined, otherwise the group is named $NB_USER). This feature is useful" +" when mounting host volumes with specific group permissions. For this option" +" to take effect, you must run the container with --user root. (The startup " +"script will su $NB_USER after adjusting the group ID.) You might consider " +"using modern Docker options --user and --group-add instead. See the last " +"bullet below for details. The user is added to supplemental group users " +"(gid 100) in order to allow write access to the home directory and " +"/opt/conda. If you override the user/group logic, ensure the user stays in " +"group users if you want them to be able to modify files in the image." +msgstr "" + +# 1d362c57a99b47e1b3cb571f23c17e67 +#: ../../using/common.md:29 +msgid "" +"-e NB_GROUP= - The name used for $NB_GID, which defaults to $NB_USER." +" This is only used if $NB_GID is specified and completely optional: there " +"is only cosmetic effect." +msgstr "" + +# de1cd66f1e174d519cfcf764a0286773 +#: ../../using/common.md:30 +msgid "" +"-e NB_UMASK= - Configures Jupyter to use a different umask value from" +" default, i.e. 022. For example, if setting umask to 002, new files will be " +"readable and writable by group members instead of just writable by the " +"owner. Wikipedia has a good article about umask. Feel free to read it in " +"order to choose the value that better fits your needs. Default value should " +"fit most situations. Note that NB_UMASK when set only applies to the Jupyter" +" process itself - you cannot use it to set a umask for additional files " +"created during run-hooks e.g. via pip or conda - if you need to set a umask " +"for these you must set umask for each command." +msgstr "" + +# 325f270ee0484e728c638fb0ca4c9c93 +#: ../../using/common.md:31 +msgid "" +"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home" +" directory owner and group to the current value of $NB_UID and $NB_GID. This" +" change will take effect even if the user home directory is mounted from the" +" host using -v as described below. The change is not applied recursively by " +"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS" +" (e.g., -e CHOWN_HOME_OPTS='-R')." +msgstr "" + +# 85b3d1d9890c46b08bb62370c6ed93a2 +#: ../../using/common.md:32 +msgid "" +"-e CHOWN_EXTRA=\",\" - Instructs the startup " +"script to change the owner and group of each comma-separated container " +"directory to the current value of $NB_UID and $NB_GID. The change is not " +"applied recursively by default. You can change modify the chown behavior by " +"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')." +msgstr "" + +# bb7a47817b734d7ab9d95e4c4f18911f +#: ../../using/common.md:33 +msgid "" +"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user " +"passwordless sudo capability. You do not need this option to allow the user " +"to conda or pip install additional packages. This option is useful, however," +" when you wish to give $NB_USER the ability to install OS packages with apt " +"or modify other root-owned files in the container. For this option to take " +"effect, you must run the container with --user root. (The start-notebook.sh " +"script will su $NB_USER after adding $NB_USER to sudoers.) You should only " +"enable sudo if you trust the user or if the container is running on an " +"isolated host." +msgstr "" + +# d148b1f0275342b0bf231ae5e819590f +#: ../../using/common.md:34 +msgid "" +"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed " +"SSL certificate and configure Jupyter Notebook to use it to accept encrypted" +" HTTPS connections." +msgstr "" + +# aafdc956c76142a0acfe467ffde5ce68 +#: ../../using/common.md:35 +msgid "" +"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab " +"instead of the default jupyter notebook command. Useful in container " +"orchestration environments where setting environment variables is easier " +"than change command line parameters." +msgstr "" + +# 9a4fc69536fa4e8580ed4f5e77d338f0 +#: ../../using/common.md:36 +msgid "" +"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine " +"directory as folder in the container. Useful when you want to preserve " +"notebooks and other work even after the container is destroyed. You must " +"grant the within-container notebook user or group (NB_UID or NB_GID) write " +"access to the host directory (e.g., sudo chown 1000 " +"/some/host/folder/for/work)." +msgstr "" + +# 684334b1f55b42e4a05e194f3a3a3497 +#: ../../using/common.md:37 +msgid "" +"--user 5000 --group-add users - Launches the container with a specific user " +"ID and adds that user to the users group so that it can modify files in the " +"default home directory and /opt/conda. You can use these arguments as " +"alternatives to setting $NB_UID and $NB_GID." +msgstr "" + +# 42df7956876a4592be13f4ce3c9c8f54 +#: ../../using/common.md:39 +msgid "Startup Hooks" +msgstr "" + +# c8d2e31d4d0544a486a070c4cc7d8afd +#: ../../using/common.md:41 +msgid "" +"You can further customize the container environment by adding shell scripts " +"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:" +msgstr "" + +# 473e6aea1cbc4e50b75eec179a476b46 +#: ../../using/common.md:44 +msgid "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" +msgstr "" + +# f9d0cc48b06f4cbfa911ef6169222f6b +#: ../../using/common.md:46 +msgid "" +"/usr/local/bin/before-notebook.d/ - handled after all of the standard " +"options noted above are applied and just before the notebook server launches" +msgstr "" + +# 68e7bf5e72d747f886129a962ae84eef +#: ../../using/common.md:49 +msgid "" +"See the run-hooks function in the jupyter/base-notebook start.sh script for " +"execution details." +msgstr "" + +# 7a9436da93a34647a59ee4cc77be5300 +#: ../../using/common.md:52 +msgid "SSL Certificates" +msgstr "" + +# e69958fe476445eda760433dcc2fac24 +#: ../../using/common.md:54 +msgid "" +"You may mount SSL key and certificate files into a container and configure " +"Jupyter Notebook to use them to accept HTTPS connections. For example, to " +"mount a host folder containing a notebook.key and notebook.crt and use them," +" you might run the following:" +msgstr "" + +# b38385bb5753460397e87480c71d621f +#: ../../using/common.md:64 +msgid "" +"Alternatively, you may mount a single PEM file containing both the key and " +"certificate. For example:" +msgstr "" + +# 7867b25df06444e8b7bd0c87292cafd8 +#: ../../using/common.md:73 +msgid "" +"In either case, Jupyter Notebook expects the key and certificate to be a " +"base64 encoded text file. The certificate file or PEM may contain one or " +"more certificates (e.g., server, intermediate, and root)." +msgstr "" + +# 030c5c35440b45d8b1a82abdb946609f +#: ../../using/common.md:75 +msgid "For additional information about using SSL, see the following:" +msgstr "" + +# a50ac1b5bbc749e8a5c4f9ecbd523d14 +#: ../../using/common.md:77 +msgid "" +"The docker-stacks/examples for information about how to use Let's Encrypt " +"certificates when you run these stacks on a publicly visible domain." +msgstr "" + +# 9cc027cb57c044a782068bf45d3bc22e +#: ../../using/common.md:78 +msgid "" +"The jupyter_notebook_config.py file for how this Docker image generates a " +"self-signed certificate." +msgstr "" + +# dbfcfb88b099481781c8f3b3011a73e9 +#: ../../using/common.md:79 +msgid "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." +msgstr "" + +# f8fcaea33627485799126c6b6e08e7dc +#: ../../using/common.md:81 +msgid "Alternative Commands" +msgstr "" + +# 10a9b432d6dd4a8a804da1976d27127e +#: ../../using/common.md:83 +msgid "start.sh" +msgstr "" + +# 3dca69ef1ed44f08a99c8a3f82645ffa +#: ../../using/common.md:85 +msgid "" +"The start-notebook.sh script actually inherits most of its option handling " +"capability from a more generic start.sh script. The start.sh script supports" +" all of the features described above, but allows you to specify an arbitrary" +" command to execute. For example, to run the text-based ipython console in a" +" container, do the following:" +msgstr "" + +# f9ade4ab67f54867a79b59937239d9a7 +#: ../../using/common.md:91 +msgid "" +"Or, to run JupyterLab instead of the classic notebook, run the following:" +msgstr "" + +# 4575181991e844a1bc113b6c2821d0d8 +#: ../../using/common.md:97 +msgid "" +"This script is particularly useful when you derive a new Dockerfile from " +"this image and install additional Jupyter applications with subcommands like" +" jupyter console, jupyter kernelgateway, etc." +msgstr "" + +# d4d085e167a942709b72de803ee03bc0 +#: ../../using/common.md:99 +msgid "Others" +msgstr "" + +# 34c4fb744a514987b41ad23dba573c46 +#: ../../using/common.md:101 +msgid "" +"You can bypass the provided scripts and specify your an arbitrary start " +"command. If you do, keep in mind that features supported by the start.sh " +"script and its kin will not function (e.g., GRANT_SUDO)." +msgstr "" + +# bcd8d95440b2493a9ffbca0678a14ed9 +#: ../../using/common.md:103 +msgid "Conda Environments" +msgstr "" + +# 9f62047ae18e44e3bad5b3a183a3683a +#: ../../using/common.md:105 +msgid "" +"The default Python 3.x Conda environment resides in /opt/conda. The " +"/opt/conda/bin directory is part of the default jovyan user's $PATH. That " +"directory is also whitelisted for use in sudo commands by the start.sh " +"script." +msgstr "" + +# 6c8c478e872d444b904fecd01e9911da +#: ../../using/common.md:107 +msgid "" +"The jovyan user has full read/write access to the /opt/conda directory. You " +"can use either conda or pip to install new packages without any additional " +"permissions." +msgstr "" + +# cdff04cd2c814d2a993dcf793c1a32a0 +#: ../../using/recipes.md:1 +msgid "Contributed Recipes" +msgstr "" + +# 674d282d2bc64a07b2d1aae14a954453 +#: ../../using/recipes.md:3 +msgid "" +"Users sometimes share interesting ways of using the Jupyter Docker Stacks. " +"We encourage users to contribute these recipes to the documentation in case " +"they prove useful to other members of the community by submitting a pull " +"request to docs/using/recipes.md. The sections below capture this knowledge." +msgstr "" + +# a01a0ec46bc8469290ee140a69d6b0a4 +#: ../../using/recipes.md:5 +msgid "Using pip install or conda install in a Child Docker image" +msgstr "" + +# 95d414d34880400bb6f17842eaacdb47 +#: ../../using/recipes.md:7 +msgid "Create a new Dockerfile like the one shown below." +msgstr "" + +# 1fa3f126a9a6401d9941748e79380f8e +#: ../../using/recipes.md:16 +msgid "Then build a new image." +msgstr "" + +# 1bff41f678f847d98ffa744cf037c502 +#: ../../using/recipes.md:22 +msgid "" +"To use a requirements.txt file, first create your requirements.txt file with" +" the listing of packages desired. Next, create a new Dockerfile like the " +"one shown below." +msgstr "" + +# a11c4c3379f64b4f8028d4b4c7437292 +#: ../../using/recipes.md:35 +msgid "For conda, the Dockerfile is similar:" +msgstr "" + +# 42213789b3a14b02a491455f3bcdfa9a +#: ../../using/recipes.md:47 +msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" +msgstr "" + +# 471f68531d274ce4a7ad2a9f4274d8a9 +#: ../../using/recipes.md:49 +msgid "Add a Python 2.x environment" +msgstr "" + +# c721d45a7e9e4ce99799d587a7aa0921 +#: ../../using/recipes.md:51 +msgid "" +"Python 2.x was removed from all images on August 10th, 2017, starting in tag" +" cc9feab481f7. You can add a Python 2.x environment by defining your own " +"Dockerfile inheriting from one of the images like so:" +msgstr "" + +# e07ac0abd67c4bb2a746953b44cd2ba8 +#: ../../using/recipes.md:73 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440" +msgstr "" + +# 88ae461b17e140a1ae71a9c175b4bd0d +#: ../../using/recipes.md:75 +msgid "Run JupyterLab" +msgstr "" + +# dbf08b368b5346ec8f6549737e561e5f +#: ../../using/recipes.md:77 +msgid "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." +msgstr "" + +# 866e89573c5d4a70abd44bf374ed2e62 +#: ../../using/recipes.md:79 +msgid "" +"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 " +"jupyter/datascience-notebook start.sh jupyter lab" +msgstr "" + +# 1531d01600af476b8401421c9305cdf3 +#: ../../using/recipes.md:81 +msgid "Let's Encrypt a Notebook server" +msgstr "" + +# ac1d8a654ce64ec3b318d9c341602e1a +#: ../../using/recipes.md:83 +msgid "" +"See the README for the simple automation here https://github.com/jupyter" +"/docker-stacks/tree/master/examples/make-deploy which includes steps for " +"requesting and renewing a Let's Encrypt certificate." +msgstr "" + +# 17ac8453774a4b028df89f2bdb3feec1 +#: ../../using/recipes.md:85 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78" +msgstr "" + +# 020d1144ff094e49ba690fd3292bad1a +#: ../../using/recipes.md:87 +msgid "Slideshows with Jupyter and RISE" +msgstr "" + +# b84e3e74e66349a695be5f2eb177757b +#: ../../using/recipes.md:89 +msgid "" +"RISE allows via extension to create live slideshows of your notebooks, with " +"no conversion, adding javascript Reveal.js:" +msgstr "" + +# 14fd425e7dad41c9b00fee87d7d2225e +#: ../../using/recipes.md:95 +msgid "Credit: Paolo D. based on docker-stacks/issues/43" +msgstr "" + +# 3e38842bbf0244f5897f995d7744d4ed +#: ../../using/recipes.md:97 +msgid "xgboost" +msgstr "" + +# daf9711129e84131ad1f676e646f9e03 +#: ../../using/recipes.md:99 +msgid "" +"You need to install conda's gcc for Python xgboost to work properly. " +"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0." +msgstr "" + +# faf7639219434c4d902b0e9bd6e626c2 +#: ../../using/recipes.md:109 +msgid "Running behind a nginx proxy" +msgstr "" + +# 912ad155cb4a45069d9e8ec8b1b87cb0 +#: ../../using/recipes.md:111 +msgid "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for" +" instance:" +msgstr "" + +# 7adc9717c9f84756963824bb3b851eda +#: ../../using/recipes.md:113 +msgid "" +"you would prefer to access the notebook at a server URL with a path " +"(https://example.com/jupyter) rather than a port (https://example.com:8888)" +msgstr "" + +# 1ed3d2d40ad948b19f6d1b5777c13f5f +#: ../../using/recipes.md:114 +msgid "" +"you may have many different services in addition to Jupyter running on the " +"same server, and want to nginx to help improve server performance in manage " +"the connections" +msgstr "" + +# 276ccfb626504c1fbe8d645f1c82a24f +#: ../../using/recipes.md:116 +msgid "" +"Here is a quick example NGINX configuration to get started. You'll need a " +"server, a .crt and .key file for your server, and docker & docker-compose " +"installed. Then just download the files at that gist and run docker-compose" +" up -d to test it out. Customize the nginx.conf file to set the desired " +"paths and add other services." +msgstr "" + +# ba9a795db881452d8a815f3bf2f3aa7a +#: ../../using/recipes.md:118 +msgid "Host volume mounts and notebook errors" +msgstr "" + +# 3cecb98fa6e54f99a09a04b81a4bc04e +#: ../../using/recipes.md:120 +msgid "" +"If you are mounting a host directory as /home/jovyan/work in your container " +"and you receive permission errors or connection errors when you create a " +"notebook, be sure that the jovyan user (UID=1000 by default) has read/write " +"access to the directory on the host. Alternatively, specify the UID of the " +"jovyan user on container startup using the -e NB_UID option described in the" +" Common Features, Docker Options section" +msgstr "" + +# b71f0c2e0f184959a9a6f0765b9f0b4e +#: ../../using/recipes.md:122 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199" +msgstr "" + +# 29b6203639a444d38051b7dd23195ad5 +#: ../../using/recipes.md:124 +msgid "Manpage installation" +msgstr "" + +# a4261a1c819e48ef848fb16bacd237dd +#: ../../using/recipes.md:126 +msgid "" +"Most containers, including our Ubuntu base image, ship without manpages " +"installed to save space. You can use the following dockerfile to inherit " +"from one of our images to enable manpages:" +msgstr "" + +# df6c0841b76247a893a7494d446d63ad +#: ../../using/recipes.md:151 +msgid "" +"Adding the documentation on top of an existing singleuser image wastes a lot" +" of space and requires reinstalling every system package, which can take " +"additional time and bandwidth; the datascience-notebook image has been shown" +" to grow by almost 3GB when adding manapages in this way. Enabling manpages " +"in the base Ubuntu layer prevents this container bloat:" +msgstr "" + +# b41452481f5d421fa005b0e1a33bf9b4 +#: ../../using/recipes.md:173 +msgid "" +"Be sure to check the current base image in base-notebook before building." +msgstr "" + +# 7b0274764c614b46b0a2e663231e59b7 +#: ../../using/recipes.md:175 +msgid "JupyterHub" +msgstr "" + +# ccf49b18478443ecbd9fd7fc9c171cd9 +#: ../../using/recipes.md:177 +msgid "We also have contributed recipes for using JupyterHub." +msgstr "" + +# e5835af60f9c4bfeb8e6995d703f730e +#: ../../using/recipes.md:179 +msgid "Use JupyterHub's dockerspawner" +msgstr "" + +# 9305102339904086861ef2246beb8f08 +#: ../../using/recipes.md:181 +msgid "" +"In most cases for use with DockerSpawner, given any image that already has a" +" notebook stack set up, you would only need to add:" +msgstr "" + +# 5d92054033604627ae5b3161c3d0b903 +#: ../../using/recipes.md:183 +msgid "install the jupyterhub-singleuser script (for the right Python)" +msgstr "" + +# fcf37a1789f84906bde9085583cff95b +#: ../../using/recipes.md:184 +msgid "change the command to launch the single-user server" +msgstr "" + +# e6f1488b2ffb4beaa2414ca545f10261 +#: ../../using/recipes.md:186 +msgid "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be" +" enough for most cases." +msgstr "" + +# bbd864e6695a4cca862d9fa909b51dc0 +#: ../../using/recipes.md:188 +msgid "" +"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-" +"stacks/issues/124 and docker-stacks/pull/185" +msgstr "" + +# 260577d0e15f4102bbad7486357528d4 +#: ../../using/recipes.md:190 +msgid "Containers with a specific version of JupyterHub" +msgstr "" + +# 041f84f19f0e4d4c8b050a2ccc2cb812 +#: ../../using/recipes.md:192 +msgid "" +"To use a specific version of JupyterHub, the version of jupyterhub in your " +"image should match the version in the Hub itself." +msgstr "" + +# 41410dcc4e264932b64e96e6857b1bd3 +#: ../../using/recipes.md:199 +msgid "Credit: MinRK" +msgstr "" + +# 68fe2ae525474d91af1d8647378f078b +#: ../../using/recipes.md:202 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177" +msgstr "" + +# 3b6b7a3b35aa42a8a70a5c9e91af21d2 +#: ../../using/recipes.md:204 +msgid "Spark" +msgstr "" + +# 8d1092f2b1a64da292134b240b621f48 +#: ../../using/recipes.md:206 +msgid "" +"A few suggestions have been made regarding using Docker Stacks with spark." +msgstr "" + +# 54e47498667747d1a7f576895d140c6f +#: ../../using/recipes.md:208 +msgid "Using PySpark with AWS S3" +msgstr "" + +# 127111e623114603b4c841b66ce8f16f +#: ../../using/recipes.md:210 +msgid "Using Spark session for hadoop 2.7.3" +msgstr "" + +# 5454399deea24bb2a166ddd1fd168752 +#: ../../using/recipes.md:230 +msgid "Using Spark context for hadoop 2.6.0" +msgstr "" + +# af0c5beb70664b74b6798a869023b3ca +#: ../../using/recipes.md:252 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127" +msgstr "" + +# 56531d33de8c46bb853db7ecef65d1ef +#: ../../using/recipes.md:254 +msgid "Using Local Spark JARs" +msgstr "" + +# 783af638cf454b6ea8bfd04df9da967f +#: ../../using/recipes.md:270 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154" +msgstr "" + +# 80df4b671dc64d9bad9bd2915524fe02 +#: ../../using/recipes.md:272 +msgid "Using spark-packages.org" +msgstr "" + +# 14c79ea3fbf446fc92ab63c36e874f96 +#: ../../using/recipes.md:274 +msgid "" +"If you'd like to use packages from spark-packages.org, see " +"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how " +"to specify the package identifier in the environment before creating a " +"SparkContext." +msgstr "" + +# 5a1cab88fa6c477a99f4352670b6cf76 +#: ../../using/recipes.md:276 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43" +msgstr "" + +# 753a64e86395492481c9541dcb91f0ed +#: ../../using/recipes.md:278 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +msgstr "" + +# 53fbe7a910d84359af93acf195711ffd +#: ../../using/recipes.md:342 +msgid "Credit: britishbadger from docker-stacks/issues/369" +msgstr "" + +# c82c3fc2484d48d5889dd8e3e79723b2 +#: ../../using/recipes.md:344 +msgid "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with " +"no token)" +msgstr "" + +# 53c63d298efa42cab5d39c3b242d44e0 +#: ../../using/recipes.md:346 +msgid "(Adapted from issue 728)" +msgstr "" + +# cb4bd116d7334212b7fa5a78602e370d +#: ../../using/recipes.md:348 +msgid "" +"The default security is very good. There are use cases, encouraged by " +"containers, where the jupyter container and the system it runs within, lie " +"inside the security boundary. In these use cases it is convenient to launch " +"the server without a password or token. In this case, you should use the " +"start.sh script to launch the server with no token:" +msgstr "" + +# 59cd4c1e695f42c09ea911048769f8b7 +#: ../../using/recipes.md:354 +msgid "For jupyterlab:" +msgstr "" + +# 49d382c7a9c14ddda58b2e88521dc3bc +#: ../../using/recipes.md:360 +msgid "For jupyter classic:" +msgstr "" + +# 297f3ad3d8504a75a0fd5659fa73b67c +#: ../../using/recipes.md:365 +msgid "" +"Enable nbextension spellchecker for markdown (or any other nbextension)" +msgstr "" + +# e2b10f15c91e4db9b7898a1a191526c7 +#: ../../using/recipes.md:367 +msgid "NB: this works for classic notebooks only" +msgstr "" + +# 158be3dba029417b832640f01cd22f75 +#: ../../using/recipes.md:380 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675" +msgstr "" + +# ade5800ecee24c9eb4f16af9585951fc +#: ../../using/running.md:1 +msgid "Running a Container" +msgstr "" + +# da480368616a4ffa976061bdc0128763 +# 1b0a0481a9454392a32c005d7513e453 +#: ../../using/running.md:3 ../../using/selecting.md:7 +msgid "Using one of the Jupyter Docker Stacks requires two choices:" +msgstr "" + +# d94683d29b6341a98420c4e6adebc4bb +# 436b43aa9da944d281cf51ea731d286a +#: ../../using/running.md:5 ../../using/selecting.md:9 +msgid "Which Docker image you wish to use" +msgstr "" + +# de5bb072aa194beebbf587038b36bdcf +# fca43aa36e854a9ab4d2b2816c015847 +#: ../../using/running.md:6 ../../using/selecting.md:10 +msgid "How you wish to start Docker containers from that image" +msgstr "" + +# 19634063eb14436daa48af3b1ee3fcc5 +#: ../../using/running.md:8 +msgid "This section provides details about the second." +msgstr "" + +# b855cc98da54497fa98956b68d00e840 +#: ../../using/running.md:10 +msgid "Using the Docker CLI" +msgstr "" + +# 555174be66b049e2ad53de52d8e37aa0 +#: ../../using/running.md:12 +msgid "" +"You can launch a local Docker container from the Jupyter Docker Stacks using" +" the Docker command line interface. There are numerous ways to configure " +"containers using the CLI. The following are some common patterns." +msgstr "" + +# d433157f1f834a66b66143513ffe8c9d +#: ../../using/running.md:14 +msgid "" +"Example 1 This command pulls the jupyter/scipy-notebook image tagged " +"2c80cf3537ca from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 8888. The server logs appear in the terminal and " +"include a URL to the notebook server." +msgstr "" + +# 3a56c8c4932644e6b938b5401fb98d26 +#: ../../using/running.md:36 +msgid "" +"Pressing Ctrl-C shuts down the notebook server but leaves the container " +"intact on disk for later restart or permanent deletion using commands like " +"the following:" +msgstr "" + +# e3f24ae3050d452aa42f3a92ba36f61c +#: ../../using/running.md:55 +msgid "" +"Example 2 This command pulls the jupyter/r-notebook image tagged " +"e5c5a7d3e52d from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 10000. The server logs appear in the terminal and " +"include a URL to the notebook server, but with the internal container port " +"(8888) instead of the the correct host port (10000)." +msgstr "" + +# d54172836b0349cb8e8ccbcb6c33ec45 +#: ../../using/running.md:77 +msgid "" +"Pressing Ctrl-C shuts down the notebook server and immediately destroys the " +"Docker container. Files written to ~/work in the container remain touched. " +"Any other changes made in the container are lost." +msgstr "" + +# 0d90bfa0543f4669a0b2bb4b62e2e7dc +#: ../../using/running.md:79 +msgid "" +"Example 3 This command pulls the jupyter/all-spark-notebook image currently " +"tagged latest from Docker Hub if an image tagged latest is not already " +"present on the local host. It then starts a container named notebook running" +" a JupyterLab server and exposes the server on a randomly selected port." +msgstr "" + +# 04e49785faff4511b8576e9d997bea67 +#: ../../using/running.md:85 +msgid "" +"The assigned port and notebook server token are visible using other Docker " +"commands." +msgstr "" + +# f88af44236f948ccbda342b1c93364d3 +#: ../../using/running.md:99 +msgid "" +"Together, the URL to visit on the host machine to access the server in this " +"case is " +"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00." +msgstr "" + +# ed09c347d7aa4dd79e505562f4f5efdd +#: ../../using/running.md:101 +msgid "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." +msgstr "" + +# 7fdc11c0394e4af88bb3c3178814d184 +#: ../../using/running.md:113 +msgid "Using Binder" +msgstr "" + +# 69b162f507f14323b3dbf8758e2964b2 +#: ../../using/running.md:115 +msgid "" +"Binder is a service that allows you to create and share custom computing " +"environments for projects in version control. You can use any of the Jupyter" +" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the" +" docker-stacks example and Using a Dockerfile sections in the Binder " +"documentation for instructions." +msgstr "" + +# f148f5335f354e549f00dce0cc630475 +#: ../../using/running.md:117 +msgid "Using JupyterHub" +msgstr "" + +# a23469fb52db4edfb3e98c1dc3115b50 +#: ../../using/running.md:119 +msgid "" +"You can configure JupyterHub to launcher Docker containers from the Jupyter " +"Docker Stacks images. If you've been following the Zero to JupyterHub with " +"Kubernetes guide, see the Use an existing Docker image section for details. " +"If you have a custom JupyterHub deployment, see the Picking or building a " +"Docker image instructions for the dockerspawner instead." +msgstr "" + +# bb8d103e20df4ebab2321ae4eee584e7 +#: ../../using/running.md:121 +msgid "Using Other Tools and Services" +msgstr "" + +# c6ef8c5aac54431d931df9f5d5f890d5 +#: ../../using/running.md:123 +msgid "" +"You can use the Jupyter Docker Stacks with any Docker-compatible technology " +"(e.g., Docker Compose, docker-py, your favorite cloud container service). " +"See the documentation of the tool, library, or service for details about how" +" to reference, configure, and launch containers from these images." +msgstr "" + +# d34ba542e6ed43a7b490cfa65b67d9c3 +#: ../../using/selecting.md:1 +msgid "Selecting an Image" +msgstr "" + +# 70b39f1dbdb242599b33cd78bbe6a850 +# cb08cf9b24364322a943a40bea1fd39f +#: ../../using/selecting.md:3 ../../using/selecting.md:14 +msgid "Core Stacks" +msgstr "" + +# 7a8f664007004185a07b672d25205ca2 +# 5040afcacc8d4cdeb5bc9b0ed6a06c88 +#: ../../using/selecting.md:4 ../../using/selecting.md:123 +msgid "Image Relationships" +msgstr "" + +# e364abca4ff948f5a6dba4d5685f9fe8 +# ae86feb2ae9c4ed081379460d4a559fb +#: ../../using/selecting.md:5 ../../using/selecting.md:141 +msgid "Community Stacks" +msgstr "" + +# 27b83c7429d142b89e0e425b662e94a9 +#: ../../using/selecting.md:12 +msgid "This section provides details about the first." +msgstr "" + +# b24fe11f42e84aaf8d2378535737148e +#: ../../using/selecting.md:16 +msgid "" +"The Jupyter team maintains a set of Docker image definitions in the " +"https://github.com/jupyter/docker-stacks GitHub repository. The following " +"sections describe these images including their contents, relationships, and " +"versioning strategy." +msgstr "" + +# 6562071d34574731baa6241fc067690c +#: ../../using/selecting.md:18 +msgid "jupyter/base-notebook" +msgstr "" + +# 79c95b7cb9df4670a0fab5737942396f +# 2d8e2926bd6f4db69959f5f0456c4682 +# 6d074c8de6fd4895b715a3525ccb8bb4 +# 7337ce8d03e5474887cd6affc21ec03b +# 2fb0a6afd5b24c33820ccaed19dd886d +# 1ad0f64aec2c4439937fa4d02ee0fe49 +# f955c9a3be324d2db1f47a643b9d51a3 +# 667016f994f84648853707ce13241d45 +#: ../../using/selecting.md:20 ../../using/selecting.md:37 +#: ../../using/selecting.md:49 ../../using/selecting.md:63 +#: ../../using/selecting.md:76 ../../using/selecting.md:87 +#: ../../using/selecting.md:100 ../../using/selecting.md:112 +msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags" +msgstr "" + +# 864aa76e1043469fa96b27f26dcad7d1 +#: ../../using/selecting.md:24 +msgid "" +"jupyter/base-notebook is a small image supporting the options common across " +"all core stacks. It is the basis for all other stacks." +msgstr "" + +# d869d6c4081e483180f51de5f5e225a7 +#: ../../using/selecting.md:26 +msgid "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" +msgstr "" + +# d6384943a3394b9d9a5a505e2387d392 +#: ../../using/selecting.md:27 +msgid "Miniconda Python 3.x in /opt/conda" +msgstr "" + +# 031a321f6173495daef86225cd234a72 +#: ../../using/selecting.md:28 +msgid "No preinstalled scientific computing packages" +msgstr "" + +# e37862b78262475182c34461d2fae08e +#: ../../using/selecting.md:29 +msgid "" +"Unprivileged user jovyan (uid=1000, configurable, see options) in group " +"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths" +msgstr "" + +# cdd04f4dbb864e82b8b993ccb1670687 +#: ../../using/selecting.md:30 +msgid "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" +msgstr "" + +# 0e3cf3b3a6e540be861ef295f1808099 +#: ../../using/selecting.md:31 +msgid "" +"A start-singleuser.sh script useful for launching containers in JupyterHub" +msgstr "" + +# 3b561d51339f422d801a408007ca16f3 +#: ../../using/selecting.md:32 +msgid "" +"A start.sh script useful for running alternative commands in the container " +"(e.g. ipython, jupyter kernelgateway, jupyter lab)" +msgstr "" + +# 9e8346716bc148fb8df45bce44fa7c38 +#: ../../using/selecting.md:33 +msgid "Options for a self-signed HTTPS certificate and passwordless sudo" +msgstr "" + +# ee56473bbb334a9b96db5870f6be611c +#: ../../using/selecting.md:35 +msgid "jupyter/minimal-notebook" +msgstr "" + +# eec9e5e3162343eba481b73cc223fa49 +#: ../../using/selecting.md:41 +msgid "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." +msgstr "" + +# cf19dcbf0d084508924f166d2b0fa7e3 +#: ../../using/selecting.md:43 +msgid "Everything in jupyter/base-notebook" +msgstr "" + +# 52d17abfd2f14628a9937f1b7584582d +#: ../../using/selecting.md:44 +msgid "Pandoc and TeX Live for notebook document conversion" +msgstr "" + +# b81070edc9c849c184be4687ce17b786 +#: ../../using/selecting.md:45 +msgid "git, emacs, jed, nano, tzdata, and unzip" +msgstr "" + +# aa65fcb5d17649bb88ded23f0880e147 +#: ../../using/selecting.md:47 +msgid "jupyter/r-notebook" +msgstr "" + +# 54b4b695a8ed493bb79993e62dd164c2 +#: ../../using/selecting.md:53 +msgid "jupyter/r-notebook includes popular packages from the R ecosystem." +msgstr "" + +# d83a0f40bfc34554a0c362f02c656e55 +# c27e75f042064ae0a64447053b46785e +#: ../../using/selecting.md:55 ../../using/selecting.md:69 +msgid "Everything in jupyter/minimal-notebook and its ancestor images" +msgstr "" + +# 99e3f1d20553480c81dda15a66369f52 +#: ../../using/selecting.md:56 +msgid "The R interpreter and base environment" +msgstr "" + +# 34bc2c80ad014b019fb54fc1fad024c4 +# 8c5a996a6b0c4309810071f5194f532a +#: ../../using/selecting.md:57 ../../using/selecting.md:119 +msgid "IRKernel to support R code in Jupyter notebooks" +msgstr "" + +# a24d121e485e4bd9bbe4df9883a7c148 +#: ../../using/selecting.md:58 +msgid "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, " +"stringr, lubridate, and broom from conda-forge" +msgstr "" + +# d49e405f45dd40a69e64b1636f69381d +#: ../../using/selecting.md:59 +msgid "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13," +" caret, rcurl, and randomforest packages from conda-forge" +msgstr "" + +# 9cfe9452daa04dfc982c2d99948a37eb +#: ../../using/selecting.md:61 +msgid "jupyter/scipy-notebook" +msgstr "" + +# 47f831c00a78451bb75de1467d90d34c +#: ../../using/selecting.md:67 +msgid "" +"jupyter/scipy-notebook includes popular packages from the scientific Python " +"ecosystem." +msgstr "" + +# da192888520b4b2ca9ae8ca5162aba6c +#: ../../using/selecting.md:70 +msgid "" +"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, " +"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, " +"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages" +msgstr "" + +# be048a3494074da99c0f5b98454feda8 +#: ../../using/selecting.md:71 +msgid "ipywidgets for interactive visualizations in Python notebooks" +msgstr "" + +# c3e92433ff5f4702beeaea78d6ee6fd7 +#: ../../using/selecting.md:72 +msgid "Facets for visualizing machine learning datasets" +msgstr "" + +# ff01e76ad1544fb48e024a617ae932b5 +#: ../../using/selecting.md:74 +msgid "jupyter/tensorflow-notebook" +msgstr "" + +# bf2f117cf3a047aa8be8cd73f4080455 +#: ../../using/selecting.md:80 +msgid "" +"jupyter/tensorflow-notebook includes popular Python deep learning libraries." +msgstr "" + +# 1fccef5b590549ffb4ea6933eaf12674 +# 1140d31915eb42fc89725521ec90c1dc +#: ../../using/selecting.md:82 ../../using/selecting.md:106 +msgid "Everything in jupyter/scipy-notebook and its ancestor images" +msgstr "" + +# 099eb36a6961440b8bea7901b226a96d +#: ../../using/selecting.md:83 +msgid "tensorflow and keras machine learning libraries" +msgstr "" + +# 13413eabaac34b94b4bc5ae28e445dda +#: ../../using/selecting.md:85 +msgid "jupyter/datascience-notebook" +msgstr "" + +# 23244942c9ef4eb8aba10cd558bf5fe9 +#: ../../using/selecting.md:91 +msgid "" +"jupyter/datascience-notebook includes libraries for data analysis from the " +"Julia, Python, and R communities." +msgstr "" + +# 7e65863f6a0840729876d3669158c4ce +#: ../../using/selecting.md:93 +msgid "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and " +"their ancestor images" +msgstr "" + +# 6246f4a0d2454714860e4ffa80aef958 +#: ../../using/selecting.md:94 +msgid "The Julia compiler and base environment" +msgstr "" + +# 143e63b9b0a9418a8c93870f6186808e +#: ../../using/selecting.md:95 +msgid "IJulia to support Julia code in Jupyter notebooks" +msgstr "" + +# 7a170fe5f6a949cc939d2f40200b3336 +#: ../../using/selecting.md:96 +msgid "HDF5, Gadfly, and RDatasets packages" +msgstr "" + +# 4b741debc1e84661ab63b8bf0d9c3bbe +#: ../../using/selecting.md:98 +msgid "jupyter/pyspark-notebook" +msgstr "" + +# 815f62ec44f54dbfaa5a052d15580b94 +#: ../../using/selecting.md:104 +msgid "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." +msgstr "" + +# 0cb03ee6cd9d488597be17be045f3b74 +#: ../../using/selecting.md:107 +msgid "Apache Spark with Hadoop binaries" +msgstr "" + +# 977ee95d9f664fe2a62505e0a78b1447 +#: ../../using/selecting.md:108 +msgid "Mesos client libraries" +msgstr "" + +# 43c0814f5a024a598dd26a4af0212cea +#: ../../using/selecting.md:110 +msgid "jupyter/all-spark-notebook" +msgstr "" + +# 0c1536b3ff6d40a885e9cdd881dc19bd +#: ../../using/selecting.md:116 +msgid "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache " +"Spark, optionally on Mesos." +msgstr "" + +# ecf9548ffc5e4e0eb4bbdf6cb458cf32 +#: ../../using/selecting.md:118 +msgid "Everything in jupyter/pyspark-notebook and its ancestor images" +msgstr "" + +# 5f6081607cab47739c306516cf84a814 +#: ../../using/selecting.md:120 +msgid "" +"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" +msgstr "" + +# a4b50e47f8684dfbbe71e0c3353199dd +#: ../../using/selecting.md:121 +msgid "ggplot2, sparklyr, and rcurl packages" +msgstr "" + +# ebbdf9189d96433e9323aae035f37ec2 +#: ../../using/selecting.md:125 +msgid "" +"The following diagram depicts the build dependency tree of the core images. " +"(i.e., the FROM statements in their Dockerfiles). Any given image inherits " +"the complete content of all ancestor images pointing to it." +msgstr "" + +# df2da8e55aa740a485fd638aa7397b8a +#: ../../using/selecting.md:129 +msgid "Builds" +msgstr "" + +# 56066ef1cd834061b3c3aea7567221c7 +#: ../../using/selecting.md:131 +msgid "" +"Pull requests to the jupyter/docker-stacks repository trigger builds of all " +"images on Travis CI. These images are for testing purposes only and are not " +"saved for use. When pull requests merge to master, all images rebuild on " +"Docker Cloud and become available to docker pull from Docker Hub." +msgstr "" + +# f4781cd0f2c040458a15b80846026405 +#: ../../using/selecting.md:133 +msgid "Versioning" +msgstr "" + +# 28addf6682f24cbdb1b6cd1836a6dc74 +#: ../../using/selecting.md:135 +msgid "" +"The latest tag in each Docker Hub repository tracks the master branch HEAD " +"reference on GitHub. latest is a moving target, by definition, and will have" +" backward-incompatible changes regularly." +msgstr "" + +# 92c07d80753b4fda9406b3b2694684e7 +#: ../../using/selecting.md:137 +msgid "" +"Every image on Docker Hub also receives a 12-character tag which corresponds" +" with the git commit SHA that triggered the image build. You can inspect the" +" state of the jupyter/docker-stacks repository for that commit to review the" +" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from" +" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)." +msgstr "" + +# 5bdfd71620394fa4812120220718ffeb +#: ../../using/selecting.md:139 +msgid "" +"You must refer to git-SHA image tags when stability and reproducibility are " +"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, " +"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only " +"use latest when a one-off container instance is acceptable (e.g., you want " +"to briefly try a new library in a notebook)." +msgstr "" + +# 90cc227d51734f8586d42982f3b7a559 +#: ../../using/selecting.md:143 +msgid "" +"The core stacks are just a tiny sample of what's possible when combining " +"Jupyter with other technologies. We encourage members of the Jupyter " +"community to create their own stacks based on the core images and link them " +"below." +msgstr "" + +# f1c9edb79eae4a5f929fdc1e0e2d4366 +#: ../../using/selecting.md:145 +msgid "This list only has 2 examples. You can be the next!" +msgstr "" + +# 7346986f864848708411fa0788d3b4e4 +#: ../../using/selecting.md:147 +msgid "" +"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter" +" Notebooks. The image includes more than 200 Jupyter Notebooks with example " +"C# code and can readily be tried online via mybinder.org. Click here to " +"launch ." +msgstr "" + +# a2e061cf04bf4e96a4d40c03790d64bc +#: ../../using/selecting.md:149 +msgid "" +"education-notebook is a community Jupyter Docker Stack image. The image " +"includes nbgrader and RISE on top of the datascience-notebook image. Click " +"here to launch it on ." +msgstr "" + +# c3720b9d103947499b34ebd19567733f +#: ../../using/selecting.md:151 +msgid "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." +msgstr "" + +# b9f784eaaa0a4072929bc51254fa322e +#: ../../using/specifics.md:1 +msgid "Image Specifics" +msgstr "" + +# dfb2958ae819459383ad8c75ba65dd39 +#: ../../using/specifics.md:3 +msgid "" +"This page provides details about features specific to one or more images." +msgstr "" + +# 9cfa68a10a3c4eb8b63c435e43bf77fc +#: ../../using/specifics.md:5 +msgid "Apache Spark" +msgstr "" + +# 536591b439514687b086cf6a4c6f7a93 +#: ../../using/specifics.md:7 +msgid "" +"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support " +"the use of Apache Spark in Python, R, and Scala notebooks. The following " +"sections provide some examples of how to get started using them." +msgstr "" + +# 21d870dca44845948d9ab959f8ccc105 +#: ../../using/specifics.md:9 +msgid "Using Spark Local Mode" +msgstr "" + +# bda9eb0bb22b4e8e8662fcd037d9d585 +#: ../../using/specifics.md:11 +msgid "" +"Spark local mode is useful for experimentation on small data when you do not" +" have a Spark cluster available." +msgstr "" + +# 91033be3c31b48d4a1a6a235491bd897 +# 6cc19049cacb4403989934496ecc4375 +#: ../../using/specifics.md:13 ../../using/specifics.md:71 +msgid "In a Python Notebook" +msgstr "" + +# 556a0ebdcab54a87b01f1b8bed45628e +# 823b89e12a514c54b10255bcc2081397 +#: ../../using/specifics.md:24 ../../using/specifics.md:98 +msgid "In a R Notebook" +msgstr "" + +# a42af3a3c0a44602b15d8d7ed52d267b +# cb0340653342464892f57379cf775ea9 +#: ../../using/specifics.md:36 ../../using/specifics.md:119 +msgid "In a Spylon Kernel Scala Notebook" +msgstr "" + +# f6efc67ea4d14900a978e0d581e6448a +#: ../../using/specifics.md:38 +msgid "" +"Spylon kernel instantiates a SparkContext for you in variable sc after you " +"configure Spark options in a %%init_spark magic cell." +msgstr "" + +# 48c05ebdfde54ea6b8794b47171a6c10 +# 66315cf3b7554105bfeaf6a3a5b43b73 +#: ../../using/specifics.md:52 ../../using/specifics.md:134 +msgid "In an Apache Toree Scala Notebook" +msgstr "" + +# 5d8060e95aa941e58a64d0465dbacafa +#: ../../using/specifics.md:54 +msgid "" +"Apache Toree instantiates a local SparkContext for you in variable sc when " +"the kernel starts." +msgstr "" + +# 1a30fe3a85fa44b1860efb1e8bf123e3 +#: ../../using/specifics.md:61 +msgid "Connecting to a Spark Cluster on Mesos" +msgstr "" + +# 74263d337820458d851a4b869d14f1cf +#: ../../using/specifics.md:63 +msgid "" +"This configuration allows your compute cluster to scale with your data." +msgstr "" + +# c7ca76d01c6e4f10ad8f793b65dc41db +#: ../../using/specifics.md:65 +msgid "Deploy Spark on Mesos." +msgstr "" + +# 296f9c1d6f2a4950a1147913198bc1bc +#: ../../using/specifics.md:66 +msgid "" +"Configure each slave with the --no-switch_user flag or create the $NB_USER " +"account on every slave node." +msgstr "" + +# 2d988e27cde44fa09feaed27ce3b7a06 +# 6045e72f079c4fc2ab9e3ce622968bc8 +#: ../../using/specifics.md:67 ../../using/specifics.md:163 +msgid "" +"Run the Docker container with --net=host in a location that is network " +"addressable by all of your Spark workers. (This is a Spark networking " +"requirement.)" +msgstr "" + +# f20142628b0f40379f87031abd6461b2 +# b00bbd0a10d4480db69f870cdf5fe094 +#: ../../using/specifics.md:68 ../../using/specifics.md:164 +msgid "" +"NOTE: When using --net=host, you must also use the flags --pid=host -e " +"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 " +"for details." +msgstr "" + +# 46c5b891e7ce4fa78d3c0eeff0e22635 +#: ../../using/specifics.md:69 +msgid "Follow the language specific instructions below." +msgstr "" + +# 90c742c66172412c862fcf09a2661bf5 +#: ../../using/specifics.md:136 +msgid "" +"The Apache Toree kernel automatically creates a SparkContext when it starts " +"based on configuration information from its command line arguments and " +"environment variables. You can pass information about your Mesos cluster via" +" the SPARK_OPTS environment variable when you spawn a container." +msgstr "" + +# 7c2b15ef25ba4cd29ff222b808a8fd68 +#: ../../using/specifics.md:138 +msgid "" +"For instance, to pass information about a Mesos master, Spark binary " +"location in HDFS, and an executor options, you could start the container " +"like so:" +msgstr "" + +# 94f9511094e044f08129c273ce3efaf0 +#: ../../using/specifics.md:146 +msgid "" +"Note that this is the same information expressed in a notebook in the Python" +" case above. Once the kernel spec has your cluster information, you can test" +" your cluster in an Apache Toree notebook like so:" +msgstr "" + +# e0c67007d0cc4c9da0fb73d5ed25356d +#: ../../using/specifics.md:157 +msgid "Connecting to a Spark Cluster in Standalone Mode" +msgstr "" + +# 6c6f7d3049814b25a3acf211e2587ec2 +#: ../../using/specifics.md:159 +msgid "" +"Connection to Spark Cluster on Standalone Mode requires the following set of" +" steps:" +msgstr "" + +# 4634540d7990421fb60e85b6241dd816 +#: ../../using/specifics.md:161 +msgid "" +"Verify that the docker image (check the Dockerfile) and the Spark Cluster " +"which is being deployed, run the same version of Spark." +msgstr "" + +# d6b4329933e24b69879a4621b26bf454 +#: ../../using/specifics.md:162 +msgid "Deploy Spark in Standalone Mode." +msgstr "" + +# 3dfcc2e12ca34c92ac8ebf96e4a37066 +#: ../../using/specifics.md:165 +msgid "" +"The language specific instructions are almost same as mentioned above for " +"Mesos, only the master url would now be something like " +"spark://10.10.10.10:7077" +msgstr "" + +# 9e271f07799e4cb0a4b79df224a5639f +#: ../../using/specifics.md:167 +msgid "Tensorflow" +msgstr "" + +# 2a525d328e6f419f98d2ed3b99978e25 +#: ../../using/specifics.md:169 +msgid "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." +msgstr "" + +# 4440ceaa200f4029b5cbaf9c895a8e5c +#: ../../using/specifics.md:171 +msgid "Single Machine Mode" +msgstr "" + +# d82de0694427429fa44d9988c1db4851 +#: ../../using/specifics.md:185 +msgid "Distributed Mode" +msgstr "" diff --git a/docs/locale/zh/LC_MESSAGES/contributing.po b/docs/locale/zh/LC_MESSAGES/contributing.po new file mode 100644 index 0000000000..d3c88a670a --- /dev/null +++ b/docs/locale/zh/LC_MESSAGES/contributing.po @@ -0,0 +1,635 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Micky Chan , 2019 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Last-Translator: Micky Chan , 2019\n" +"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: zh\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +# 9527c87037fb4592a05d144d80f69f89 +#: ../../contributing/features.md:1 +msgid "New Features" +msgstr "新功能" + +# 81de205103144b289398603fa4aee789 +#: ../../contributing/features.md:3 +msgid "" +"Thank you for contributing to the Jupyter Docker Stacks! We review pull " +"requests of new features (e.g., new packages, new scripts, new flags) to " +"balance the value of the images to the Jupyter community with the cost of " +"maintaining the images over time." +msgstr "感谢您为Jupyter Docker Stacks做出贡献! 我们审查新功能的拉取请求" + +# b35331d86206420aa8235d20ef037215 +#: ../../contributing/features.md:5 +msgid "Suggesting a New Feature" +msgstr "建议一个新功能" + +# 6c6b00518c1f4dc88049b82f213a36cc +#: ../../contributing/features.md:7 +msgid "" +"Please follow the process below to suggest a new feature for inclusion in " +"one of the core stacks:" +msgstr "" + +# a9cd9d0730cc4159aa227e970ae2d9d0 +#: ../../contributing/features.md:9 +msgid "Open a GitHub issue describing the feature you'd like to contribute." +msgstr "" + +# 8433ea2c70b94556b9a62c35cb88a4c8 +#: ../../contributing/features.md:10 +msgid "" +"Discuss with the maintainers whether the addition makes sense in one of the " +"core stacks, as a recipe in the documentation, as a community stack, or as " +"something else entirely." +msgstr "" + +# a995c15adfb7424e9852693b90569d7a +#: ../../contributing/features.md:12 +msgid "Selection Criteria" +msgstr "选择标准" + +# 981cef217f4e4225984c5c7989f592f8 +#: ../../contributing/features.md:14 +msgid "" +"Roughly speaking, we evaluate new features based on the following criteria:" +msgstr "" + +# 32194c09119e428a871acb859d696500 +#: ../../contributing/features.md:16 +msgid "" +"Usefulness to Jupyter users: Is the feature generally applicable across " +"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?" +msgstr "" + +# 7b5acf7ef5854ac4b2c55b1a51464796 +#: ../../contributing/features.md:17 +msgid "" +"Fit with the image purpose: Does the feature match the theme of the stack in" +" which it will be added? Would it fit better in a new, community stack?" +msgstr "" + +# 55d1f51c3b264dcfb252771c83d8ca36 +#: ../../contributing/features.md:18 +msgid "" +"Complexity of build / runtime configuration: How many lines of code does the" +" feature require in one of the Dockerfiles or startup scripts? Does it " +"require new scripts entirely? Do users need to adjust how they use the " +"images?" +msgstr "" + +# 2a332f3b95064b43a1833166fd84f53c +#: ../../contributing/features.md:19 +msgid "" +"Impact on image metrics: How many bytes does the feature and its " +"dependencies add to the image(s)? How many minutes do they add to the build " +"time?" +msgstr "" + +# 30966a8cde0844bd85f6114c65f79ec4 +#: ../../contributing/features.md:20 +msgid "" +"Ability to support the addition: Can existing maintainers answer user " +"questions and address future build issues? Are the contributors interested " +"in helping with long-term maintenance? Can we write tests to ensure the " +"feature continues to work over time?" +msgstr "" + +# 6085a8c0829e411588a37777bfe5e0f4 +#: ../../contributing/features.md:22 +msgid "Submitting a Pull Request" +msgstr "" + +# fa5dc8dbaedb483b888622cc9d1e94ae +#: ../../contributing/features.md:24 +msgid "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" +msgstr "" + +# 23ae2ae62bdb4a35bc42d9efc7759944 +#: ../../contributing/features.md:26 +msgid "" +"Implement the feature in a local clone of the jupyter/docker-stacks project." +msgstr "" + +# ef476261493c48d998fb384d651b4012 +#: ../../contributing/features.md:27 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 6bd20fd181f44e39a4913154db0c7221 +# 4277e486510d49a08448d209a5cdad69 +# f8c596a67a4f43c1a1c82a0f38a846f7 +#: ../../contributing/features.md:31 ../../contributing/packages.md:13 +#: ../../contributing/tests.md:20 +msgid "Submit a pull request (PR) with your changes." +msgstr "" + +# a7aa4a8d9d3d44eda2f1cf757e569c4e +# d8f1d1f00b2a4e9690b4e0da736ac662 +# e4f93545f2284342a2b3ad1f52eaf26c +#: ../../contributing/features.md:32 ../../contributing/packages.md:14 +#: ../../contributing/tests.md:21 +msgid "" +"Watch for Travis to report a build success or failure for your PR on GitHub." +msgstr "" + +# f80657a299424b8685d452d70479bae6 +#: ../../contributing/features.md:33 +msgid "Discuss changes with the maintainers and address any build issues." +msgstr "" + +# 57ead3e81b9b4ebaa7a3491818f60089 +#: ../../contributing/issues.md:1 +msgid "Project Issues" +msgstr "" + +# f27080bf0c8d43a08f283b3c5e28ddc7 +#: ../../contributing/issues.md:3 +msgid "" +"We appreciate your taking the time to report an issue you encountered using " +"the Jupyter Docker Stacks. Please review the following guidelines when " +"reporting your problem." +msgstr "" + +# 3713984479614d4aa9237328bc2e233b +#: ../../contributing/issues.md:7 +msgid "" +"If you believe you’ve found a security vulnerability in any of the Jupyter " +"projects included in Jupyter Docker Stacks images, please report it to " +"security@ipython.org, not in the issue trackers on GitHub. If you prefer to " +"encrypt your security reports, you can use this PGP public key." +msgstr "" + +# 0c7fad6ee9304bbe80baf1737d0f478c +#: ../../contributing/issues.md:13 +msgid "" +"If you think your problem is unique to the Jupyter Docker Stacks images, " +"please search the jupyter/docker-stacks issue tracker to see if someone else" +" has already reported the same problem. If not, please open a new issue and " +"provide all of the information requested in the issue template." +msgstr "" + +# 70860cacf75b40a687363712f3bf00ce +#: ../../contributing/issues.md:19 +msgid "" +"If the issue you're seeing is with one of the open source libraries included" +" in the Docker images and is reproducible outside the images, please file a " +"bug with the appropriate open source project." +msgstr "" + +# 76822159e56f40f3bb38ea93e054238c +#: ../../contributing/issues.md:22 +msgid "" +"If you have a general question about how to use the Jupyter Docker Stacks in" +" your environment, in conjunction with other tools, with customizations, and" +" so on, please post your question on the Jupyter Discourse site." +msgstr "" + +# 3815aec9c791444cbdf26a71e28a1f7c +#: ../../contributing/packages.md:1 +msgid "Package Updates" +msgstr "" + +# 0bc1f6af65c74cc5a812a14b9c5a055f +#: ../../contributing/packages.md:3 +msgid "" +"We actively seek pull requests which update packages already included in the" +" project Dockerfiles. This is a great way for first-time contributors to " +"participate in developing the Jupyter Docker Stacks." +msgstr "" + +# ff8faef49758489fb97ddaba60763a0e +#: ../../contributing/packages.md:5 +msgid "Please follow the process below to update a package version:" +msgstr "" + +# e3878a1a1a444bb592fe32f468693ed7 +#: ../../contributing/packages.md:7 +msgid "" +"Locate the Dockerfile containing the library you wish to update (e.g., base-" +"notebook/Dockerfile, scipy-notebook/Dockerfile)" +msgstr "" + +# d5aac81ecab24592860296ab74936724 +#: ../../contributing/packages.md:8 +msgid "" +"Adjust the version number for the package. We prefer to pin the major and " +"minor version number of packages so as to minimize rebuild side-effects when" +" users submit pull requests (PRs). For example, you'll find the Jupyter " +"Notebook package, notebook, installed using conda with notebook=5.4.*." +msgstr "" + +# 0eed3a80d95146bab769d4456addcce4 +#: ../../contributing/packages.md:9 +msgid "" +"Please build the image locally before submitting a pull request. Building " +"the image locally shortens the debugging cycle by taking some load off " +"Travis CI, which graciously provides free build services for open source " +"projects like this one. If you use make, call:" +msgstr "" + +# 1be104e942024f2b98eb10e0006b9de3 +#: ../../contributing/packages.md:15 +msgid "" +"Discuss changes with the maintainers and address any build issues. Version " +"conflicts are the most common problem. You may need to upgrade additional " +"packages to fix build failures." +msgstr "" + +# adf5db8b690d466a8d339c756a5a153c +#: ../../contributing/recipes.md:1 +msgid "New Recipes" +msgstr "" + +# 7d306f8fe4a641e4a48b61111c16b8e8 +#: ../../contributing/recipes.md:3 +msgid "" +"We welcome contributions of recipes, short examples of using, configuring, " +"or extending the Docker Stacks, for inclusion in the documentation site. " +"Follow the process below to add a new recipe:" +msgstr "" + +# 5b84ed1b594845ec81f39b87e7c5d82b +#: ../../contributing/recipes.md:5 +msgid "Open the docs/using/recipes.md source file." +msgstr "" + +# 52f2b459bff447fe82c60ea02c4e751c +#: ../../contributing/recipes.md:6 +msgid "" +"Add a second-level Markdown heading naming your recipe at the bottom of the " +"file (e.g., `## Add the RISE extension``)" +msgstr "" + +# 56b4b4356d3e45f5bbe6eb14f9540628 +#: ../../contributing/recipes.md:7 +msgid "" +"Write the body of your recipe under the heading, including whatever command " +"line, Dockerfile, links, etc. you need." +msgstr "" + +# 6a3115ec07cf42a28c755a607658f855 +# f4f9a3d6544b4e4087e97124098459eb +#: ../../contributing/recipes.md:8 ../../contributing/stacks.md:111 +msgid "" +"Submit a pull request (PR) with your changes. Maintainers will respond and " +"work with you to address any formatting or content issues." +msgstr "" + +# 0b8332c390304a1ab29a4b2b030e7997 +#: ../../contributing/stacks.md:1 +msgid "Community Stacks" +msgstr "" + +# 69ee7d697c7240b78ea8c7873fc1528b +#: ../../contributing/stacks.md:3 +msgid "" +"We love to see the community create and share new Jupyter Docker images. " +"We've put together a cookiecutter project and the documentation below to " +"help you get started defining, building, and sharing your Jupyter " +"environments in Docker. Following these steps will:" +msgstr "" + +# 0f392d5680ba4ea2812ff450f8e19d44 +#: ../../contributing/stacks.md:5 +msgid "" +"Setup a project on GitHub containing a Dockerfile based on either the " +"jupyter/base-notebook or jupyter/minimal-notebook image." +msgstr "" + +# c05df9d2cf8c4505b0951f0ea88f1daf +#: ../../contributing/stacks.md:6 +msgid "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." +msgstr "" + +# 077482de9feb4fa2b1e5e477fd5591f1 +#: ../../contributing/stacks.md:7 +msgid "" +"Configure Docker Cloud to build and host your images for others to use." +msgstr "" + +# e2fe70e1ea6e4322a8dfa4380f8e54bb +#: ../../contributing/stacks.md:8 +msgid "" +"Update the list of community stacks in this documentation to include your " +"image." +msgstr "" + +# 3af1a3dc1eae4a7d96a883b911fc5894 +#: ../../contributing/stacks.md:10 +msgid "" +"This approach mirrors how we build and share the core stack images. Feel " +"free to follow it or pave your own path using alternative services and build" +" tools." +msgstr "" + +# 0107f213096c41c8b1cb367b84fee30d +#: ../../contributing/stacks.md:12 +msgid "Creating a Project" +msgstr "" + +# cb35d196dc42402f9b338e56fcd3faa6 +#: ../../contributing/stacks.md:14 +msgid "First, install cookiecutter using pip or conda:" +msgstr "" + +# 09066f77e38c42889844dafb226df4bd +#: ../../contributing/stacks.md:20 +msgid "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." +msgstr "" + +# 26f05981d3fe49abb07bba85a4a3890f +#: ../../contributing/stacks.md:26 +msgid "" +"Enter a name for your new stack image. This will serve as both the git " +"repository name and the part of the Docker image name after the slash." +msgstr "" + +# c6aba910076b49ca97dcb902f13d2a4d +#: ../../contributing/stacks.md:33 +msgid "" +"Enter the user or organization name under which this stack will reside on " +"Docker Cloud / Hub. You must have access to manage this Docker Cloud org in " +"order to push images here and setup automated builds." +msgstr "" + +# 176a346034074822b7634c6c86dace42 +#: ../../contributing/stacks.md:41 +msgid "" +"Select an image from the jupyter/docker-stacks project that will serve as " +"the base for your new image." +msgstr "" + +# 3611e7452640414d9d0535292abd113d +#: ../../contributing/stacks.md:48 +msgid "Enter a longer description of the stack for your README." +msgstr "" + +# 782321361a3b4116a2d3dafa7cc1424f +#: ../../contributing/stacks.md:54 +msgid "Initialize your project as a Git repository and push it to GitHub." +msgstr "" + +# b699fe5155774c93938427a241d0f239 +#: ../../contributing/stacks.md:66 +msgid "Configuring Travis" +msgstr "" + +# 6440a7c3a9444dda88445913807d1a48 +#: ../../contributing/stacks.md:68 +msgid "" +"Next, link your GitHub project to Travis CI to build your Docker image " +"whenever you or someone else submits a pull request." +msgstr "" + +# c0613debece54f82a922700157994c5b +#: ../../contributing/stacks.md:70 +msgid "" +"Visit https://docs.travis-ci.com/user/getting-started/#To-get-started-with-" +"Travis-CI and follow the instructions to add the Travis CI application to " +"your GitHub account." +msgstr "" + +# 4cf36f34a47b410a982be3237af720cd +#: ../../contributing/stacks.md:71 +msgid "Visit https://travis-ci.org." +msgstr "" + +# fdd694f5ebf443ce9d2d220d5945c299 +#: ../../contributing/stacks.md:72 +msgid "Click the + symbol at the top of the left sidebar." +msgstr "" + +# 05acff6addad4f919fe21c27329b1e51 +#: ../../contributing/stacks.md:74 +msgid "" +"Locate your project repository either in your primary user account or in one" +" of the organizations to which you belong." +msgstr "" + +# a1917b1360434fb18a3522e0a9806a11 +#: ../../contributing/stacks.md:75 +msgid "Click the toggle to enable builds for the project repository." +msgstr "" + +# 7dcbafc96c4a4ef88d7bc34e31a0af04 +#: ../../contributing/stacks.md:76 +msgid "Click the Settings button for that repository." +msgstr "" + +# dd006e53f5cc4c1ea1501d62119f526e +#: ../../contributing/stacks.md:78 +msgid "" +"Enable Build only if .travis.yml is present and Build pushed pull requests." +msgstr "" + +# 0a5e54cd5f294a52983c2ec73559f810 +#: ../../contributing/stacks.md:80 +msgid "Disable Build pushed branches." +msgstr "" + +# 2ddf5289794648a3b7d1f604ce744331 +#: ../../contributing/stacks.md:82 +msgid "Configuring Docker Cloud" +msgstr "" + +# 5108ce3f722a430eb29e1a5928a86fcf +#: ../../contributing/stacks.md:84 +msgid "" +"Now, configure Docker Cloud to build your stack image and push it to Docker " +"Hub repository whenever you merge a GitHub pull request to the master branch" +" of your project." +msgstr "" + +# 7ab258ec2f1e4942a983996a6c5e6fa5 +#: ../../contributing/stacks.md:86 +msgid "Visit https://cloud.docker.com/ and login." +msgstr "" + +# 3677166ebbc04b2aafc4f117e33f6bf5 +#: ../../contributing/stacks.md:87 +msgid "" +"Select the account or organization matching the one you entered when " +"prompted with stack_org by the cookiecutter." +msgstr "" + +# 0997628fd41449c5b0598e7e1bf1f005 +#: ../../contributing/stacks.md:89 +msgid "Scroll to the bottom of the page and click Create repository." +msgstr "" + +# 8504105c95594c288fdd9066006757b0 +#: ../../contributing/stacks.md:90 +msgid "" +"Enter the name of the image matching the one you entered when prompted with " +"stack_name by the cookiecutter." +msgstr "" + +# c92796a106c846f585c88fb5a015fa6d +#: ../../contributing/stacks.md:92 +msgid "Enter a description for your image." +msgstr "" + +# fba832c82f3042499563598365fedfd5 +#: ../../contributing/stacks.md:93 +msgid "" +"Click GitHub under the Build Settings and follow the prompts to connect your" +" account if it is not already connected." +msgstr "" + +# bff3581410014975943ca77637142f14 +#: ../../contributing/stacks.md:94 +msgid "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." +msgstr "" + +# 72cbc93bfe354e279e9384e7c95c801b +#: ../../contributing/stacks.md:96 +msgid "Click the Create and Build button." +msgstr "" + +# bbb495328efd4fe7b339b7a7ffe908b0 +#: ../../contributing/stacks.md:98 +msgid "Defining Your Image" +msgstr "" + +# 60052c2d1afc4a57baa59c1bf22d321c +#: ../../contributing/stacks.md:100 +msgid "" +"Make edits the Dockerfile in your project to add third-party libraries and " +"configure Jupyter applications. Refer to the Dockerfiles for the core stacks" +" (e.g., jupyter/datascience-notebook) to get a feel for what's possible and " +"best practices." +msgstr "" + +# 0855b53115ae4b6780cc82c9389224cb +#: ../../contributing/stacks.md:102 +msgid "" +"Submit pull requests to your project repository on GitHub. Ensure your image" +" builds properly on Travis before merging to master. Refer to Docker Cloud " +"for builds of your master branch that you can docker pull." +msgstr "" + +# de4bcc6e0ac1468ea761c038661ca19f +#: ../../contributing/stacks.md:104 +msgid "Sharing Your Image" +msgstr "" + +# a67495f9ae984a368364a698084f060e +#: ../../contributing/stacks.md:106 +msgid "" +"Finally, if you'd like to add a link to your project to this documentation " +"site, please do the following:" +msgstr "" + +# 7357ed96047e42e6ae9e4bf123a00bed +#: ../../contributing/stacks.md:108 +msgid "Clone ths jupyter/docker-stacks GitHub repository." +msgstr "" + +# ee9284fe69244dcd8d44b25b8dc8b3a2 +#: ../../contributing/stacks.md:109 +msgid "" +"Open the docs/using/selecting.md source file and locate the Community Stacks" +" section." +msgstr "" + +# aa0e41b99c354b5b88336489084e2006 +#: ../../contributing/stacks.md:110 +msgid "" +"Add a bullet with a link to your project and a short description of what " +"your Docker image contains." +msgstr "" + +# 0f652c5259d544b595e847365dfe843a +#: ../../contributing/tests.md:1 +msgid "Image Tests" +msgstr "" + +# 569da0112572470b9bc5f045bcfb49d0 +#: ../../contributing/tests.md:3 +msgid "" +"We greatly appreciate pull requests that extend the automated tests that vet" +" the basic functionality of the Docker images." +msgstr "" + +# 67b27592447e47af8b0b00eeb745fc70 +#: ../../contributing/tests.md:5 +msgid "How the Tests Work" +msgstr "" + +# e2c3d76accff489eb2a6eab7b55ae3be +#: ../../contributing/tests.md:7 +msgid "" +"Travis executes make build-test-all against every pull request submitted to " +"the jupyter/docker-stacks repository. The make command builds every docker " +"image. After building each image, the make command executes pytest to run " +"both image-specific tests like those in base-notebook/test/ and common tests" +" defined in test/. Both kinds of tests make use of global pytest fixtures " +"defined in the conftest.py file at the root of the projects." +msgstr "" + +# 15207b72b26741f0a6a77949a4d9d0f4 +#: ../../contributing/tests.md:9 +msgid "Contributing New Tests" +msgstr "" + +# 5470865e6d144e51a428221e49e448fb +#: ../../contributing/tests.md:11 +msgid "Please follow the process below to add new tests:" +msgstr "" + +# 36aedaa2624c4e4493af145bc5f246e0 +#: ../../contributing/tests.md:13 +msgid "" +"If the test should run against every image built, add your test code to one " +"of the modules in test/ or create a new module." +msgstr "" + +# dccbb0425be7438db7ade2f4892c6c25 +#: ../../contributing/tests.md:14 +msgid "" +"If your test should run against a single image, add your test code to one of" +" the modules in some-notebook/test/ or create a new module." +msgstr "" + +# 33ab248b51d24fa0b29923489bf6dfbf +#: ../../contributing/tests.md:15 +msgid "" +"Build one or more images you intend to test and run the tests locally. If " +"you use make, call:" +msgstr "" + +# 0453d92037cb4e47a025bc9021bdc7db +#: ../../contributing/tests.md:22 +msgid "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." +msgstr "" diff --git a/docs/locale/zh/LC_MESSAGES/index.po b/docs/locale/zh/LC_MESSAGES/index.po new file mode 100644 index 0000000000..d802b88983 --- /dev/null +++ b/docs/locale/zh/LC_MESSAGES/index.po @@ -0,0 +1,140 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Micky Chan , 2019 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Last-Translator: Micky Chan , 2019\n" +"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: zh\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +# 85291a2c92d440a089cf156fba58b86a +#: ../../index.rst:32 ../../index.rst:32 +msgid "User Guide" +msgstr "用户指南" + +# e4a3fd32059d4486b6b0f3a6fb5065b5 +#: ../../index.rst:42 ../../index.rst:42 +msgid "Contributor Guide" +msgstr "贡献者指南" + +# 45de48c8617d4ebe83b7ff7141295836 +#: ../../index.rst:53 ../../index.rst:53 +msgid "Maintainer Guide" +msgstr "维护者指南" + +# aa99c4562d8d4cb3abfea375470e8af3 +#: ../../index.rst:59 ../../index.rst:59 +msgid "Getting Help" +msgstr "获取帮助" + +# 76df09037a6147c8a85be8ef14c15532 +#: ../../index.rst:2 +msgid "Jupyter Docker Stacks" +msgstr "Jupyter Docker Stacks" + +# b3fb253184e64174b26a2da73f221cc1 +#: ../../index.rst:4 +msgid "" +"Jupyter Docker Stacks are a set of ready-to-run Docker images containing " +"Jupyter applications and interactive computing tools. You can use a stack " +"image to do any of the following (and more):" +msgstr "" +"Jupyter Docker Stacks是一组Docker镜像包含Jupyter应用程序和交互式计算工具。您可以使用Stack镜像执行以下任何操作" + +# 8cd55fb113a049e7be445b21084df7ea +#: ../../index.rst:6 +msgid "Start a personal Jupyter Notebook server in a local Docker container" +msgstr "在本地Docker容器中启动个人Jupyter Notebook服务器" + +# 285fa13bed8547b4af0cfc480adf4861 +#: ../../index.rst:7 +msgid "Run JupyterLab servers for a team using JupyterHub" +msgstr "使用JupyterHub为团队运行JupyterLab服务器" + +# a49d31cedd4946ea98d7a4c720340d84 +#: ../../index.rst:8 +msgid "Write your own project Dockerfile" +msgstr "编写自己的Dockerfile" + +# 0aff0df2e46a44b4bc8070545e83c42c +#: ../../index.rst:11 +msgid "Quick Start" +msgstr "快速开始" + +# 3262accd283140058db73005072be200 +#: ../../index.rst:13 +msgid "" +"You can try a `recent build of the jupyter/base-notebook image on " +"mybinder.org `_ by simply clicking the preceding " +"link. Otherwise, the two examples below may help you get started if you " +"`have Docker installed `_, know " +":doc:`which Docker image ` you want to use, and want to " +"launch a single Jupyter Notebook server in a container." +msgstr "" + +# 9e4094e8de264e20bca0af8f6cf888b7 +#: ../../index.rst:15 +msgid "" +"The other pages in this documentation describe additional uses and features " +"in detail." +msgstr "" + +# 8b75310f2eaa4aac95d9387e0a4db9e8 +#: ../../index.rst:17 +msgid "" +"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image " +"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the " +"local host. It then starts a container running a Jupyter Notebook server and" +" exposes the server on host port 8888. The server logs appear in the " +"terminal. Visiting ``http://:8888/?token=`` in a browser " +"loads the Jupyter Notebook dashboard page, where ``hostname`` is the name of" +" the computer running docker and ``token`` is the secret token printed in " +"the console. The container remains intact for restart after the notebook " +"server exits.::" +msgstr "" + +# 9e0229c99f404aceb7e517387ae88365 +#: ../../index.rst:21 +msgid "" +"**Example 2:** This command performs the same operations as **Example 1**, " +"but it exposes the server on host port 10000 instead of port 8888. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console.::" +msgstr "" + +# 02c25d3f0abe48348100dd878c243a75 +#: ../../index.rst:25 +msgid "" +"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image" +" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the" +" local host. It then starts an *ephemeral* container running a Jupyter " +"Notebook server and exposes the server on host port 10000. The command " +"mounts the current working directory on the host as ``/home/jovyan/work`` in" +" the container. The server logs appear in the terminal. Visiting " +"``http://:10000/?token=`` in a browser loads JupyterLab, " +"where ``hostname`` is the name of the computer running docker and ``token`` " +"is the secret token printed in the console. Docker destroys the container " +"after notebook server exit, but any files written to ``~/work`` in the " +"container remain intact on the host.::" +msgstr "" + +# 1bc0c7d54cd343d689362047c0b00122 +#: ../../index.rst:30 +msgid "Table of Contents" +msgstr "" diff --git a/docs/locale/zh/LC_MESSAGES/maintaining.po b/docs/locale/zh/LC_MESSAGES/maintaining.po new file mode 100644 index 0000000000..067121ff0a --- /dev/null +++ b/docs/locale/zh/LC_MESSAGES/maintaining.po @@ -0,0 +1,277 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: zh\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +# cefae71d9a804ab69c7e9f0a53eb7475 +#: ../../maintaining/tasks.md:1 +msgid "Maintainer Playbook" +msgstr "" + +# af6a24b053794e55bddfe6e2e21ae74f +#: ../../maintaining/tasks.md:3 +msgid "Merging Pull Requests" +msgstr "" + +# c34b1d3b543346689adbca91331ac048 +#: ../../maintaining/tasks.md:5 +msgid "" +"To build new images on Docker Cloud and publish them to the Docker Hub " +"registry, do the following:" +msgstr "" + +# 1597bb99448f41b994d1c7073b9c8721 +#: ../../maintaining/tasks.md:7 +msgid "Make sure Travis is green for a PR." +msgstr "" + +# 401ed2733771440e8ef089f54cf2984d +#: ../../maintaining/tasks.md:8 +msgid "Merge the PR." +msgstr "" + +# 6d0bf2e7538640a0989e56df3c9d1106 +#: ../../maintaining/tasks.md:9 +msgid "" +"Monitor the Docker Cloud build status for each of the stacks, starting with " +"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the " +"stack hierarchy diagram for the current, complete build order." +msgstr "" + +# 428124fa830d4c74a618d7b3c696599c +#: ../../maintaining/tasks.md:10 +msgid "" +"Manually click the retry button next to any build that fails to resume that " +"build and any dependent builds." +msgstr "" + +# c4034a02dab8435f8d76c2d32321a262 +#: ../../maintaining/tasks.md:11 +msgid "" +"Try to avoid merging another PR to master until all outstanding builds " +"complete. There's no way at present to propagate the git SHA to build " +"through the Docker Cloud build trigger API. Every build trigger works off of" +" master HEAD." +msgstr "" + +# 62ddd25e15064cea950f9f13a663dcdb +#: ../../maintaining/tasks.md:13 +msgid "Updating the Ubuntu Base Image" +msgstr "" + +# 091b1ce707f44bc6ae9742cf55b92ebf +#: ../../maintaining/tasks.md:15 +msgid "" +"When there's a security fix in the Ubuntu base image or after some time " +"passes, it's a good idea to update the pinned SHA in the jupyter/base-" +"notebook Dockerfile. Submit it as a regular PR and go through the build " +"process. Expect the build to take a while to complete: every image layer " +"will rebuild." +msgstr "" + +# d834495e774a4fee952324e4cc5ab514 +#: ../../maintaining/tasks.md:17 +msgid "Adding a New Core Image to Docker Cloud" +msgstr "" + +# b765140c2d1446849b747351532d6290 +#: ../../maintaining/tasks.md:19 +msgid "" +"When there's a new stack definition, do the following before merging the PR " +"with the new stack:" +msgstr "" + +# b7b25a83cd3246bd886926722c30ac1a +#: ../../maintaining/tasks.md:21 +msgid "" +"Ensure the PR includes an update to the stack overview diagram in the " +"documentation. The image links to the blockdiag source used to create it." +msgstr "" + +# 50edc8e02aa9497d81dc312eafe5d2bf +#: ../../maintaining/tasks.md:22 +msgid "" +"Ensure the PR updates the Makefile which is used to build the stacks in " +"order on Travis CI." +msgstr "" + +# fabcb32a80a04a639aebd8b55d38119e +#: ../../maintaining/tasks.md:23 +msgid "" +"Create a new repository in the jupyter org on Docker Cloud named after the " +"stack folder in the git repo." +msgstr "" + +# 1811dcec60e3433d94514eaeebecb44b +#: ../../maintaining/tasks.md:24 +msgid "Grant the stacks team permission to write to the repo." +msgstr "" + +# afa7b1fcb0224380a111fe94f7781d60 +#: ../../maintaining/tasks.md:25 +msgid "Click Builds and then Configure Automated Builds for the repository." +msgstr "" + +# 35b969b9f7a442d99f54a73494033d90 +#: ../../maintaining/tasks.md:26 +msgid "Select jupyter/docker-stacks as the source repository." +msgstr "" + +# fe715af4446d409cb4d5ee81255bd86e +#: ../../maintaining/tasks.md:27 +msgid "" +"Choose Build on Docker Cloud's infrastructure using a Small node unless you " +"have reason to believe a bigger host is required." +msgstr "" + +# dc41895431b64657b5e24a8c96779ca6 +#: ../../maintaining/tasks.md:28 +msgid "" +"Update the Build Context in the default build rule to be /." +msgstr "" + +# e4d220bf1cb54781bc03f16a17ddafb8 +#: ../../maintaining/tasks.md:29 +msgid "" +"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., " +"like jupyter/base-notebook)." +msgstr "" + +# c5a459d038714ff78d4f156ee227d9ca +#: ../../maintaining/tasks.md:30 +msgid "" +"If the new stack depends on the build of another stack in the hierarchy:" +msgstr "" + +# 611376c2ec6942479f60129177d312cc +#: ../../maintaining/tasks.md:31 +msgid "Hit Save and then click Configure Automated Builds." +msgstr "" + +# 81cc56c63891432d89d4df3001f1bcde +#: ../../maintaining/tasks.md:32 +msgid "At the very bottom, add a build trigger named Stack hierarchy trigger." +msgstr "" + +# 9e55682a966a422c846a3463c7a30cfe +#: ../../maintaining/tasks.md:33 +msgid "Copy the build trigger URL." +msgstr "" + +# a9d853a1d45b4ead965813822a96c934 +#: ../../maintaining/tasks.md:34 +msgid "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." +msgstr "" + +# 327d4522c3884247871aa406bbe19402 +#: ../../maintaining/tasks.md:35 +msgid "" +"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma" +" separated list of URLs, creating that environment variable if it does not " +"already exist." +msgstr "" + +# 1aa0e4b95ab847e0be8ac9647433c991 +# 7dfff62380a041968ee6e739b1ca271f +#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40 +msgid "Hit Save." +msgstr "" + +# 8315ed043efb40238227f8be0ad61b52 +#: ../../maintaining/tasks.md:37 +msgid "If the new stack should trigger other dependent builds:" +msgstr "" + +# 6e0e15d05a544476b91794d10b8732ff +#: ../../maintaining/tasks.md:38 +msgid "Add an environment variable named NEXT_BUILD_TRIGGERS." +msgstr "" + +# 9dc2029e6360433ab7181187f7040d48 +#: ../../maintaining/tasks.md:39 +msgid "" +"Copy the build trigger URLs from the dependent builds into the " +"NEXT_BUILD_TRIGGERS comma separated list of URLs." +msgstr "" + +# 89165b279d9142e9b8e5d7a923fca2be +#: ../../maintaining/tasks.md:41 +msgid "" +"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order " +"matches that in the stack hierarchy diagram." +msgstr "" + +# 51c8151943794bc8b1d51d65ccd84736 +#: ../../maintaining/tasks.md:43 +msgid "Adding a New Maintainer Account" +msgstr "" + +# 1994c19e7a734b2cad9af0afcd7da31e +#: ../../maintaining/tasks.md:45 +msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" +msgstr "" + +# 390ccdde528146bbbc3d2f62717a647c +#: ../../maintaining/tasks.md:46 +msgid "Add the maintainer's Docker Cloud username." +msgstr "" + +# b0227c37244c4b82848cc2655f134d21 +#: ../../maintaining/tasks.md:47 +msgid "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members" +msgstr "" + +# b0fdbdd14b1444d1b696d8367aa111fb +#: ../../maintaining/tasks.md:48 +msgid "Add the maintainer's GitHub username." +msgstr "" + +# abe2cb04fcb9447496bf3bc9fb230cdc +#: ../../maintaining/tasks.md:50 +msgid "Pushing a Build Manually" +msgstr "" + +# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd +#: ../../maintaining/tasks.md:52 +msgid "" +"If automated builds on Docker Cloud have got you down, do the following to " +"push a build manually:" +msgstr "" + +# 3ebef623fa2f46f49ef639ad17105d4a +#: ../../maintaining/tasks.md:54 +msgid "Clone this repository." +msgstr "" + +# dcf8e9e8c72e40b9aa23c090311d6ea2 +#: ../../maintaining/tasks.md:55 +msgid "Check out the git SHA you want to build and publish." +msgstr "" + +# fe788ad30f694b1f9b013cabfa820343 +#: ../../maintaining/tasks.md:56 +msgid "docker login with your Docker Hub/Cloud credentials." +msgstr "" + +# 649dc474ffaa483eb625ed8061cb0097 +#: ../../maintaining/tasks.md:57 +msgid "Run make retry/release-all." +msgstr "" diff --git a/docs/locale/zh/LC_MESSAGES/using.po b/docs/locale/zh/LC_MESSAGES/using.po new file mode 100644 index 0000000000..be125b7e0e --- /dev/null +++ b/docs/locale/zh/LC_MESSAGES/using.po @@ -0,0 +1,1530 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2018- Project Jupyter +# This file is distributed under the same license as the docker-stacks package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: docker-stacks latest\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2019-04-21 17:25-0400\n" +"PO-Revision-Date: 2019-04-22 13:45+0000\n" +"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: zh\n" +"Plural-Forms: nplurals=1; plural=0;\n" + +# 22b65331d42e414b9320143d30499447 +#: ../../using/common.md:1 +msgid "Common Features" +msgstr "" + +# dd3cb2a88856437aad5f76b607f80deb +#: ../../using/common.md:3 +msgid "" +"A container launched from any Jupyter Docker Stacks image runs a Jupyter " +"Notebook server by default. The container does so by executing a start-" +"notebook.sh script. This script configures the internal container " +"environment and then runs jupyter notebook, passing it any command line " +"arguments received." +msgstr "" + +# 4bc2911886254b1cafcffcce7d7ef9b3 +#: ../../using/common.md:5 +msgid "" +"This page describes the options supported by the startup script as well as " +"how to bypass it to run alternative commands." +msgstr "" + +# bb55c8d7786e4c1f8e11c1e309931c41 +#: ../../using/common.md:7 +msgid "Notebook Options" +msgstr "" + +# 66f14be1ff1746c1abdccafb894fa2e6 +#: ../../using/common.md:9 +msgid "" +"You can pass Jupyter command line options to the start-notebook.sh script " +"when launching the container. For example, to secure the Notebook server " +"with a custom password hashed using IPython.lib.passwd() instead of the " +"default token, you can run the following:" +msgstr "" + +# 5d73f06cae2c4990a942c76988f19c1f +#: ../../using/common.md:15 +msgid "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" +msgstr "" + +# 9d43ee0e147b43469f56c4895720f682 +#: ../../using/common.md:21 +msgid "Docker Options" +msgstr "" + +# 3f0f5c9d0b254d829e6f07e0a2ca2544 +#: ../../using/common.md:23 +msgid "" +"You may instruct the start-notebook.sh script to customize the container " +"environment before launching the notebook server. You do so by passing " +"arguments to the docker run command." +msgstr "" + +# 4621c78dfaeb43379c5d3437238b2ef8 +#: ../../using/common.md:26 +msgid "" +"-e NB_USER=jovyan - Instructs the startup script to change the default " +"container username from jovyan to the provided value. Causes the script to " +"rename the jovyan user home folder. For this option to take effect, you must" +" run the container with --user root and set the working directory -w " +"/home/$NB_USER. This feature is useful when mounting host volumes with " +"specific home folder." +msgstr "" + +# 9120ad3c28c84f3fbb2433c79a83907a +#: ../../using/common.md:27 +msgid "" +"-e NB_UID=1000 - Instructs the startup script to switch the numeric user ID " +"of $NB_USER to the given value. This feature is useful when mounting host " +"volumes with specific owner permissions. For this option to take effect, you" +" must run the container with --user root. (The startup script will su " +"$NB_USER after adjusting the user ID.) You might consider using modern " +"Docker options --user and --group-add instead. See the last bullet below for" +" details." +msgstr "" + +# f2a9954159b546468e50a4d9665dd534 +#: ../../using/common.md:28 +msgid "" +"-e NB_GID=100 - Instructs the startup script to change the primary group " +"of$NB_USER to $NB_GID (the new group is added with a name of $NB_GROUP if it" +" is defined, otherwise the group is named $NB_USER). This feature is useful" +" when mounting host volumes with specific group permissions. For this option" +" to take effect, you must run the container with --user root. (The startup " +"script will su $NB_USER after adjusting the group ID.) You might consider " +"using modern Docker options --user and --group-add instead. See the last " +"bullet below for details. The user is added to supplemental group users " +"(gid 100) in order to allow write access to the home directory and " +"/opt/conda. If you override the user/group logic, ensure the user stays in " +"group users if you want them to be able to modify files in the image." +msgstr "" + +# 1d362c57a99b47e1b3cb571f23c17e67 +#: ../../using/common.md:29 +msgid "" +"-e NB_GROUP= - The name used for $NB_GID, which defaults to $NB_USER." +" This is only used if $NB_GID is specified and completely optional: there " +"is only cosmetic effect." +msgstr "" + +# de1cd66f1e174d519cfcf764a0286773 +#: ../../using/common.md:30 +msgid "" +"-e NB_UMASK= - Configures Jupyter to use a different umask value from" +" default, i.e. 022. For example, if setting umask to 002, new files will be " +"readable and writable by group members instead of just writable by the " +"owner. Wikipedia has a good article about umask. Feel free to read it in " +"order to choose the value that better fits your needs. Default value should " +"fit most situations. Note that NB_UMASK when set only applies to the Jupyter" +" process itself - you cannot use it to set a umask for additional files " +"created during run-hooks e.g. via pip or conda - if you need to set a umask " +"for these you must set umask for each command." +msgstr "" + +# 325f270ee0484e728c638fb0ca4c9c93 +#: ../../using/common.md:31 +msgid "" +"-e CHOWN_HOME=yes - Instructs the startup script to change the $NB_USER home" +" directory owner and group to the current value of $NB_UID and $NB_GID. This" +" change will take effect even if the user home directory is mounted from the" +" host using -v as described below. The change is not applied recursively by " +"default. You can change modify the chown behavior by setting CHOWN_HOME_OPTS" +" (e.g., -e CHOWN_HOME_OPTS='-R')." +msgstr "" + +# 85b3d1d9890c46b08bb62370c6ed93a2 +#: ../../using/common.md:32 +msgid "" +"-e CHOWN_EXTRA=\",\" - Instructs the startup " +"script to change the owner and group of each comma-separated container " +"directory to the current value of $NB_UID and $NB_GID. The change is not " +"applied recursively by default. You can change modify the chown behavior by " +"setting CHOWN_EXTRA_OPTS (e.g., -e CHOWN_EXTRA_OPTS='-R')." +msgstr "" + +# bb7a47817b734d7ab9d95e4c4f18911f +#: ../../using/common.md:33 +msgid "" +"-e GRANT_SUDO=yes - Instructs the startup script to grant the NB_USER user " +"passwordless sudo capability. You do not need this option to allow the user " +"to conda or pip install additional packages. This option is useful, however," +" when you wish to give $NB_USER the ability to install OS packages with apt " +"or modify other root-owned files in the container. For this option to take " +"effect, you must run the container with --user root. (The start-notebook.sh " +"script will su $NB_USER after adding $NB_USER to sudoers.) You should only " +"enable sudo if you trust the user or if the container is running on an " +"isolated host." +msgstr "" + +# d148b1f0275342b0bf231ae5e819590f +#: ../../using/common.md:34 +msgid "" +"-e GEN_CERT=yes - Instructs the startup script to generates a self-signed " +"SSL certificate and configure Jupyter Notebook to use it to accept encrypted" +" HTTPS connections." +msgstr "" + +# aafdc956c76142a0acfe467ffde5ce68 +#: ../../using/common.md:35 +msgid "" +"-e JUPYTER_ENABLE_LAB=yes - Instructs the startup script to run jupyter lab " +"instead of the default jupyter notebook command. Useful in container " +"orchestration environments where setting environment variables is easier " +"than change command line parameters." +msgstr "" + +# 9a4fc69536fa4e8580ed4f5e77d338f0 +#: ../../using/common.md:36 +msgid "" +"-v /some/host/folder/for/work:/home/jovyan/work - Mounts a host machine " +"directory as folder in the container. Useful when you want to preserve " +"notebooks and other work even after the container is destroyed. You must " +"grant the within-container notebook user or group (NB_UID or NB_GID) write " +"access to the host directory (e.g., sudo chown 1000 " +"/some/host/folder/for/work)." +msgstr "" + +# 684334b1f55b42e4a05e194f3a3a3497 +#: ../../using/common.md:37 +msgid "" +"--user 5000 --group-add users - Launches the container with a specific user " +"ID and adds that user to the users group so that it can modify files in the " +"default home directory and /opt/conda. You can use these arguments as " +"alternatives to setting $NB_UID and $NB_GID." +msgstr "" + +# 42df7956876a4592be13f4ce3c9c8f54 +#: ../../using/common.md:39 +msgid "Startup Hooks" +msgstr "" + +# c8d2e31d4d0544a486a070c4cc7d8afd +#: ../../using/common.md:41 +msgid "" +"You can further customize the container environment by adding shell scripts " +"(*.sh) to be sourced or executables (chmod +x) to be run to the paths below:" +msgstr "" + +# 473e6aea1cbc4e50b75eec179a476b46 +#: ../../using/common.md:44 +msgid "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" +msgstr "" + +# f9d0cc48b06f4cbfa911ef6169222f6b +#: ../../using/common.md:46 +msgid "" +"/usr/local/bin/before-notebook.d/ - handled after all of the standard " +"options noted above are applied and just before the notebook server launches" +msgstr "" + +# 68e7bf5e72d747f886129a962ae84eef +#: ../../using/common.md:49 +msgid "" +"See the run-hooks function in the jupyter/base-notebook start.sh script for " +"execution details." +msgstr "" + +# 7a9436da93a34647a59ee4cc77be5300 +#: ../../using/common.md:52 +msgid "SSL Certificates" +msgstr "" + +# e69958fe476445eda760433dcc2fac24 +#: ../../using/common.md:54 +msgid "" +"You may mount SSL key and certificate files into a container and configure " +"Jupyter Notebook to use them to accept HTTPS connections. For example, to " +"mount a host folder containing a notebook.key and notebook.crt and use them," +" you might run the following:" +msgstr "" + +# b38385bb5753460397e87480c71d621f +#: ../../using/common.md:64 +msgid "" +"Alternatively, you may mount a single PEM file containing both the key and " +"certificate. For example:" +msgstr "" + +# 7867b25df06444e8b7bd0c87292cafd8 +#: ../../using/common.md:73 +msgid "" +"In either case, Jupyter Notebook expects the key and certificate to be a " +"base64 encoded text file. The certificate file or PEM may contain one or " +"more certificates (e.g., server, intermediate, and root)." +msgstr "" + +# 030c5c35440b45d8b1a82abdb946609f +#: ../../using/common.md:75 +msgid "For additional information about using SSL, see the following:" +msgstr "" + +# a50ac1b5bbc749e8a5c4f9ecbd523d14 +#: ../../using/common.md:77 +msgid "" +"The docker-stacks/examples for information about how to use Let's Encrypt " +"certificates when you run these stacks on a publicly visible domain." +msgstr "" + +# 9cc027cb57c044a782068bf45d3bc22e +#: ../../using/common.md:78 +msgid "" +"The jupyter_notebook_config.py file for how this Docker image generates a " +"self-signed certificate." +msgstr "" + +# dbfcfb88b099481781c8f3b3011a73e9 +#: ../../using/common.md:79 +msgid "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." +msgstr "" + +# f8fcaea33627485799126c6b6e08e7dc +#: ../../using/common.md:81 +msgid "Alternative Commands" +msgstr "" + +# 10a9b432d6dd4a8a804da1976d27127e +#: ../../using/common.md:83 +msgid "start.sh" +msgstr "" + +# 3dca69ef1ed44f08a99c8a3f82645ffa +#: ../../using/common.md:85 +msgid "" +"The start-notebook.sh script actually inherits most of its option handling " +"capability from a more generic start.sh script. The start.sh script supports" +" all of the features described above, but allows you to specify an arbitrary" +" command to execute. For example, to run the text-based ipython console in a" +" container, do the following:" +msgstr "" + +# f9ade4ab67f54867a79b59937239d9a7 +#: ../../using/common.md:91 +msgid "" +"Or, to run JupyterLab instead of the classic notebook, run the following:" +msgstr "" + +# 4575181991e844a1bc113b6c2821d0d8 +#: ../../using/common.md:97 +msgid "" +"This script is particularly useful when you derive a new Dockerfile from " +"this image and install additional Jupyter applications with subcommands like" +" jupyter console, jupyter kernelgateway, etc." +msgstr "" + +# d4d085e167a942709b72de803ee03bc0 +#: ../../using/common.md:99 +msgid "Others" +msgstr "" + +# 34c4fb744a514987b41ad23dba573c46 +#: ../../using/common.md:101 +msgid "" +"You can bypass the provided scripts and specify your an arbitrary start " +"command. If you do, keep in mind that features supported by the start.sh " +"script and its kin will not function (e.g., GRANT_SUDO)." +msgstr "" + +# bcd8d95440b2493a9ffbca0678a14ed9 +#: ../../using/common.md:103 +msgid "Conda Environments" +msgstr "" + +# 9f62047ae18e44e3bad5b3a183a3683a +#: ../../using/common.md:105 +msgid "" +"The default Python 3.x Conda environment resides in /opt/conda. The " +"/opt/conda/bin directory is part of the default jovyan user's $PATH. That " +"directory is also whitelisted for use in sudo commands by the start.sh " +"script." +msgstr "" + +# 6c8c478e872d444b904fecd01e9911da +#: ../../using/common.md:107 +msgid "" +"The jovyan user has full read/write access to the /opt/conda directory. You " +"can use either conda or pip to install new packages without any additional " +"permissions." +msgstr "" + +# cdff04cd2c814d2a993dcf793c1a32a0 +#: ../../using/recipes.md:1 +msgid "Contributed Recipes" +msgstr "" + +# 674d282d2bc64a07b2d1aae14a954453 +#: ../../using/recipes.md:3 +msgid "" +"Users sometimes share interesting ways of using the Jupyter Docker Stacks. " +"We encourage users to contribute these recipes to the documentation in case " +"they prove useful to other members of the community by submitting a pull " +"request to docs/using/recipes.md. The sections below capture this knowledge." +msgstr "" + +# a01a0ec46bc8469290ee140a69d6b0a4 +#: ../../using/recipes.md:5 +msgid "Using pip install or conda install in a Child Docker image" +msgstr "" + +# 95d414d34880400bb6f17842eaacdb47 +#: ../../using/recipes.md:7 +msgid "Create a new Dockerfile like the one shown below." +msgstr "" + +# 1fa3f126a9a6401d9941748e79380f8e +#: ../../using/recipes.md:16 +msgid "Then build a new image." +msgstr "" + +# 1bff41f678f847d98ffa744cf037c502 +#: ../../using/recipes.md:22 +msgid "" +"To use a requirements.txt file, first create your requirements.txt file with" +" the listing of packages desired. Next, create a new Dockerfile like the " +"one shown below." +msgstr "" + +# a11c4c3379f64b4f8028d4b4c7437292 +#: ../../using/recipes.md:35 +msgid "For conda, the Dockerfile is similar:" +msgstr "" + +# 42213789b3a14b02a491455f3bcdfa9a +#: ../../using/recipes.md:47 +msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" +msgstr "" + +# 471f68531d274ce4a7ad2a9f4274d8a9 +#: ../../using/recipes.md:49 +msgid "Add a Python 2.x environment" +msgstr "" + +# c721d45a7e9e4ce99799d587a7aa0921 +#: ../../using/recipes.md:51 +msgid "" +"Python 2.x was removed from all images on August 10th, 2017, starting in tag" +" cc9feab481f7. You can add a Python 2.x environment by defining your own " +"Dockerfile inheriting from one of the images like so:" +msgstr "" + +# e07ac0abd67c4bb2a746953b44cd2ba8 +#: ../../using/recipes.md:73 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440" +msgstr "" + +# 88ae461b17e140a1ae71a9c175b4bd0d +#: ../../using/recipes.md:75 +msgid "Run JupyterLab" +msgstr "" + +# dbf08b368b5346ec8f6549737e561e5f +#: ../../using/recipes.md:77 +msgid "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." +msgstr "" + +# 866e89573c5d4a70abd44bf374ed2e62 +#: ../../using/recipes.md:79 +msgid "" +"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 " +"jupyter/datascience-notebook start.sh jupyter lab" +msgstr "" + +# 1531d01600af476b8401421c9305cdf3 +#: ../../using/recipes.md:81 +msgid "Let's Encrypt a Notebook server" +msgstr "" + +# ac1d8a654ce64ec3b318d9c341602e1a +#: ../../using/recipes.md:83 +msgid "" +"See the README for the simple automation here https://github.com/jupyter" +"/docker-stacks/tree/master/examples/make-deploy which includes steps for " +"requesting and renewing a Let's Encrypt certificate." +msgstr "" + +# 17ac8453774a4b028df89f2bdb3feec1 +#: ../../using/recipes.md:85 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78" +msgstr "" + +# 020d1144ff094e49ba690fd3292bad1a +#: ../../using/recipes.md:87 +msgid "Slideshows with Jupyter and RISE" +msgstr "" + +# b84e3e74e66349a695be5f2eb177757b +#: ../../using/recipes.md:89 +msgid "" +"RISE allows via extension to create live slideshows of your notebooks, with " +"no conversion, adding javascript Reveal.js:" +msgstr "" + +# 14fd425e7dad41c9b00fee87d7d2225e +#: ../../using/recipes.md:95 +msgid "Credit: Paolo D. based on docker-stacks/issues/43" +msgstr "" + +# 3e38842bbf0244f5897f995d7744d4ed +#: ../../using/recipes.md:97 +msgid "xgboost" +msgstr "" + +# daf9711129e84131ad1f676e646f9e03 +#: ../../using/recipes.md:99 +msgid "" +"You need to install conda's gcc for Python xgboost to work properly. " +"Otherwise, you'll get an exception about libgomp.so.1 missing GOMP_4.0." +msgstr "" + +# faf7639219434c4d902b0e9bd6e626c2 +#: ../../using/recipes.md:109 +msgid "Running behind a nginx proxy" +msgstr "" + +# 912ad155cb4a45069d9e8ec8b1b87cb0 +#: ../../using/recipes.md:111 +msgid "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for" +" instance:" +msgstr "" + +# 7adc9717c9f84756963824bb3b851eda +#: ../../using/recipes.md:113 +msgid "" +"you would prefer to access the notebook at a server URL with a path " +"(https://example.com/jupyter) rather than a port (https://example.com:8888)" +msgstr "" + +# 1ed3d2d40ad948b19f6d1b5777c13f5f +#: ../../using/recipes.md:114 +msgid "" +"you may have many different services in addition to Jupyter running on the " +"same server, and want to nginx to help improve server performance in manage " +"the connections" +msgstr "" + +# 276ccfb626504c1fbe8d645f1c82a24f +#: ../../using/recipes.md:116 +msgid "" +"Here is a quick example NGINX configuration to get started. You'll need a " +"server, a .crt and .key file for your server, and docker & docker-compose " +"installed. Then just download the files at that gist and run docker-compose" +" up -d to test it out. Customize the nginx.conf file to set the desired " +"paths and add other services." +msgstr "" + +# ba9a795db881452d8a815f3bf2f3aa7a +#: ../../using/recipes.md:118 +msgid "Host volume mounts and notebook errors" +msgstr "" + +# 3cecb98fa6e54f99a09a04b81a4bc04e +#: ../../using/recipes.md:120 +msgid "" +"If you are mounting a host directory as /home/jovyan/work in your container " +"and you receive permission errors or connection errors when you create a " +"notebook, be sure that the jovyan user (UID=1000 by default) has read/write " +"access to the directory on the host. Alternatively, specify the UID of the " +"jovyan user on container startup using the -e NB_UID option described in the" +" Common Features, Docker Options section" +msgstr "" + +# b71f0c2e0f184959a9a6f0765b9f0b4e +#: ../../using/recipes.md:122 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199" +msgstr "" + +# 29b6203639a444d38051b7dd23195ad5 +#: ../../using/recipes.md:124 +msgid "Manpage installation" +msgstr "" + +# a4261a1c819e48ef848fb16bacd237dd +#: ../../using/recipes.md:126 +msgid "" +"Most containers, including our Ubuntu base image, ship without manpages " +"installed to save space. You can use the following dockerfile to inherit " +"from one of our images to enable manpages:" +msgstr "" + +# df6c0841b76247a893a7494d446d63ad +#: ../../using/recipes.md:151 +msgid "" +"Adding the documentation on top of an existing singleuser image wastes a lot" +" of space and requires reinstalling every system package, which can take " +"additional time and bandwidth; the datascience-notebook image has been shown" +" to grow by almost 3GB when adding manapages in this way. Enabling manpages " +"in the base Ubuntu layer prevents this container bloat:" +msgstr "" + +# b41452481f5d421fa005b0e1a33bf9b4 +#: ../../using/recipes.md:173 +msgid "" +"Be sure to check the current base image in base-notebook before building." +msgstr "" + +# 7b0274764c614b46b0a2e663231e59b7 +#: ../../using/recipes.md:175 +msgid "JupyterHub" +msgstr "" + +# ccf49b18478443ecbd9fd7fc9c171cd9 +#: ../../using/recipes.md:177 +msgid "We also have contributed recipes for using JupyterHub." +msgstr "" + +# e5835af60f9c4bfeb8e6995d703f730e +#: ../../using/recipes.md:179 +msgid "Use JupyterHub's dockerspawner" +msgstr "" + +# 9305102339904086861ef2246beb8f08 +#: ../../using/recipes.md:181 +msgid "" +"In most cases for use with DockerSpawner, given any image that already has a" +" notebook stack set up, you would only need to add:" +msgstr "" + +# 5d92054033604627ae5b3161c3d0b903 +#: ../../using/recipes.md:183 +msgid "install the jupyterhub-singleuser script (for the right Python)" +msgstr "" + +# fcf37a1789f84906bde9085583cff95b +#: ../../using/recipes.md:184 +msgid "change the command to launch the single-user server" +msgstr "" + +# e6f1488b2ffb4beaa2414ca545f10261 +#: ../../using/recipes.md:186 +msgid "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be" +" enough for most cases." +msgstr "" + +# bbd864e6695a4cca862d9fa909b51dc0 +#: ../../using/recipes.md:188 +msgid "" +"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-" +"stacks/issues/124 and docker-stacks/pull/185" +msgstr "" + +# 260577d0e15f4102bbad7486357528d4 +#: ../../using/recipes.md:190 +msgid "Containers with a specific version of JupyterHub" +msgstr "" + +# 041f84f19f0e4d4c8b050a2ccc2cb812 +#: ../../using/recipes.md:192 +msgid "" +"To use a specific version of JupyterHub, the version of jupyterhub in your " +"image should match the version in the Hub itself." +msgstr "" + +# 41410dcc4e264932b64e96e6857b1bd3 +#: ../../using/recipes.md:199 +msgid "Credit: MinRK" +msgstr "" + +# 68fe2ae525474d91af1d8647378f078b +#: ../../using/recipes.md:202 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177" +msgstr "" + +# 3b6b7a3b35aa42a8a70a5c9e91af21d2 +#: ../../using/recipes.md:204 +msgid "Spark" +msgstr "" + +# 8d1092f2b1a64da292134b240b621f48 +#: ../../using/recipes.md:206 +msgid "" +"A few suggestions have been made regarding using Docker Stacks with spark." +msgstr "" + +# 54e47498667747d1a7f576895d140c6f +#: ../../using/recipes.md:208 +msgid "Using PySpark with AWS S3" +msgstr "" + +# 127111e623114603b4c841b66ce8f16f +#: ../../using/recipes.md:210 +msgid "Using Spark session for hadoop 2.7.3" +msgstr "" + +# 5454399deea24bb2a166ddd1fd168752 +#: ../../using/recipes.md:230 +msgid "Using Spark context for hadoop 2.6.0" +msgstr "" + +# af0c5beb70664b74b6798a869023b3ca +#: ../../using/recipes.md:252 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127" +msgstr "" + +# 56531d33de8c46bb853db7ecef65d1ef +#: ../../using/recipes.md:254 +msgid "Using Local Spark JARs" +msgstr "" + +# 783af638cf454b6ea8bfd04df9da967f +#: ../../using/recipes.md:270 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154" +msgstr "" + +# 80df4b671dc64d9bad9bd2915524fe02 +#: ../../using/recipes.md:272 +msgid "Using spark-packages.org" +msgstr "" + +# 14c79ea3fbf446fc92ab63c36e874f96 +#: ../../using/recipes.md:274 +msgid "" +"If you'd like to use packages from spark-packages.org, see " +"https://gist.github.com/parente/c95fdaba5a9a066efaab for an example of how " +"to specify the package identifier in the environment before creating a " +"SparkContext." +msgstr "" + +# 5a1cab88fa6c477a99f4352670b6cf76 +#: ../../using/recipes.md:276 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43" +msgstr "" + +# 753a64e86395492481c9541dcb91f0ed +#: ../../using/recipes.md:278 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +msgstr "" + +# 53fbe7a910d84359af93acf195711ffd +#: ../../using/recipes.md:342 +msgid "Credit: britishbadger from docker-stacks/issues/369" +msgstr "" + +# c82c3fc2484d48d5889dd8e3e79723b2 +#: ../../using/recipes.md:344 +msgid "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with " +"no token)" +msgstr "" + +# 53c63d298efa42cab5d39c3b242d44e0 +#: ../../using/recipes.md:346 +msgid "(Adapted from issue 728)" +msgstr "" + +# cb4bd116d7334212b7fa5a78602e370d +#: ../../using/recipes.md:348 +msgid "" +"The default security is very good. There are use cases, encouraged by " +"containers, where the jupyter container and the system it runs within, lie " +"inside the security boundary. In these use cases it is convenient to launch " +"the server without a password or token. In this case, you should use the " +"start.sh script to launch the server with no token:" +msgstr "" + +# 59cd4c1e695f42c09ea911048769f8b7 +#: ../../using/recipes.md:354 +msgid "For jupyterlab:" +msgstr "" + +# 49d382c7a9c14ddda58b2e88521dc3bc +#: ../../using/recipes.md:360 +msgid "For jupyter classic:" +msgstr "" + +# 297f3ad3d8504a75a0fd5659fa73b67c +#: ../../using/recipes.md:365 +msgid "" +"Enable nbextension spellchecker for markdown (or any other nbextension)" +msgstr "" + +# e2b10f15c91e4db9b7898a1a191526c7 +#: ../../using/recipes.md:367 +msgid "NB: this works for classic notebooks only" +msgstr "" + +# 158be3dba029417b832640f01cd22f75 +#: ../../using/recipes.md:380 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675" +msgstr "" + +# ade5800ecee24c9eb4f16af9585951fc +#: ../../using/running.md:1 +msgid "Running a Container" +msgstr "" + +# da480368616a4ffa976061bdc0128763 +# 1b0a0481a9454392a32c005d7513e453 +#: ../../using/running.md:3 ../../using/selecting.md:7 +msgid "Using one of the Jupyter Docker Stacks requires two choices:" +msgstr "" + +# d94683d29b6341a98420c4e6adebc4bb +# 436b43aa9da944d281cf51ea731d286a +#: ../../using/running.md:5 ../../using/selecting.md:9 +msgid "Which Docker image you wish to use" +msgstr "" + +# de5bb072aa194beebbf587038b36bdcf +# fca43aa36e854a9ab4d2b2816c015847 +#: ../../using/running.md:6 ../../using/selecting.md:10 +msgid "How you wish to start Docker containers from that image" +msgstr "" + +# 19634063eb14436daa48af3b1ee3fcc5 +#: ../../using/running.md:8 +msgid "This section provides details about the second." +msgstr "" + +# b855cc98da54497fa98956b68d00e840 +#: ../../using/running.md:10 +msgid "Using the Docker CLI" +msgstr "" + +# 555174be66b049e2ad53de52d8e37aa0 +#: ../../using/running.md:12 +msgid "" +"You can launch a local Docker container from the Jupyter Docker Stacks using" +" the Docker command line interface. There are numerous ways to configure " +"containers using the CLI. The following are some common patterns." +msgstr "" + +# d433157f1f834a66b66143513ffe8c9d +#: ../../using/running.md:14 +msgid "" +"Example 1 This command pulls the jupyter/scipy-notebook image tagged " +"2c80cf3537ca from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 8888. The server logs appear in the terminal and " +"include a URL to the notebook server." +msgstr "" + +# 3a56c8c4932644e6b938b5401fb98d26 +#: ../../using/running.md:36 +msgid "" +"Pressing Ctrl-C shuts down the notebook server but leaves the container " +"intact on disk for later restart or permanent deletion using commands like " +"the following:" +msgstr "" + +# e3f24ae3050d452aa42f3a92ba36f61c +#: ../../using/running.md:55 +msgid "" +"Example 2 This command pulls the jupyter/r-notebook image tagged " +"e5c5a7d3e52d from Docker Hub if it is not already present on the local host." +" It then starts a container running a Jupyter Notebook server and exposes " +"the server on host port 10000. The server logs appear in the terminal and " +"include a URL to the notebook server, but with the internal container port " +"(8888) instead of the the correct host port (10000)." +msgstr "" + +# d54172836b0349cb8e8ccbcb6c33ec45 +#: ../../using/running.md:77 +msgid "" +"Pressing Ctrl-C shuts down the notebook server and immediately destroys the " +"Docker container. Files written to ~/work in the container remain touched. " +"Any other changes made in the container are lost." +msgstr "" + +# 0d90bfa0543f4669a0b2bb4b62e2e7dc +#: ../../using/running.md:79 +msgid "" +"Example 3 This command pulls the jupyter/all-spark-notebook image currently " +"tagged latest from Docker Hub if an image tagged latest is not already " +"present on the local host. It then starts a container named notebook running" +" a JupyterLab server and exposes the server on a randomly selected port." +msgstr "" + +# 04e49785faff4511b8576e9d997bea67 +#: ../../using/running.md:85 +msgid "" +"The assigned port and notebook server token are visible using other Docker " +"commands." +msgstr "" + +# f88af44236f948ccbda342b1c93364d3 +#: ../../using/running.md:99 +msgid "" +"Together, the URL to visit on the host machine to access the server in this " +"case is " +"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00." +msgstr "" + +# ed09c347d7aa4dd79e505562f4f5efdd +#: ../../using/running.md:101 +msgid "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." +msgstr "" + +# 7fdc11c0394e4af88bb3c3178814d184 +#: ../../using/running.md:113 +msgid "Using Binder" +msgstr "" + +# 69b162f507f14323b3dbf8758e2964b2 +#: ../../using/running.md:115 +msgid "" +"Binder is a service that allows you to create and share custom computing " +"environments for projects in version control. You can use any of the Jupyter" +" Docker Stacks images as a basis for a Binder-compatible Dockerfile. See the" +" docker-stacks example and Using a Dockerfile sections in the Binder " +"documentation for instructions." +msgstr "" + +# f148f5335f354e549f00dce0cc630475 +#: ../../using/running.md:117 +msgid "Using JupyterHub" +msgstr "" + +# a23469fb52db4edfb3e98c1dc3115b50 +#: ../../using/running.md:119 +msgid "" +"You can configure JupyterHub to launcher Docker containers from the Jupyter " +"Docker Stacks images. If you've been following the Zero to JupyterHub with " +"Kubernetes guide, see the Use an existing Docker image section for details. " +"If you have a custom JupyterHub deployment, see the Picking or building a " +"Docker image instructions for the dockerspawner instead." +msgstr "" + +# bb8d103e20df4ebab2321ae4eee584e7 +#: ../../using/running.md:121 +msgid "Using Other Tools and Services" +msgstr "" + +# c6ef8c5aac54431d931df9f5d5f890d5 +#: ../../using/running.md:123 +msgid "" +"You can use the Jupyter Docker Stacks with any Docker-compatible technology " +"(e.g., Docker Compose, docker-py, your favorite cloud container service). " +"See the documentation of the tool, library, or service for details about how" +" to reference, configure, and launch containers from these images." +msgstr "" + +# d34ba542e6ed43a7b490cfa65b67d9c3 +#: ../../using/selecting.md:1 +msgid "Selecting an Image" +msgstr "" + +# 70b39f1dbdb242599b33cd78bbe6a850 +# cb08cf9b24364322a943a40bea1fd39f +#: ../../using/selecting.md:3 ../../using/selecting.md:14 +msgid "Core Stacks" +msgstr "" + +# 7a8f664007004185a07b672d25205ca2 +# 5040afcacc8d4cdeb5bc9b0ed6a06c88 +#: ../../using/selecting.md:4 ../../using/selecting.md:123 +msgid "Image Relationships" +msgstr "" + +# e364abca4ff948f5a6dba4d5685f9fe8 +# ae86feb2ae9c4ed081379460d4a559fb +#: ../../using/selecting.md:5 ../../using/selecting.md:141 +msgid "Community Stacks" +msgstr "" + +# 27b83c7429d142b89e0e425b662e94a9 +#: ../../using/selecting.md:12 +msgid "This section provides details about the first." +msgstr "" + +# b24fe11f42e84aaf8d2378535737148e +#: ../../using/selecting.md:16 +msgid "" +"The Jupyter team maintains a set of Docker image definitions in the " +"https://github.com/jupyter/docker-stacks GitHub repository. The following " +"sections describe these images including their contents, relationships, and " +"versioning strategy." +msgstr "" + +# 6562071d34574731baa6241fc067690c +#: ../../using/selecting.md:18 +msgid "jupyter/base-notebook" +msgstr "" + +# 79c95b7cb9df4670a0fab5737942396f +# 2d8e2926bd6f4db69959f5f0456c4682 +# 6d074c8de6fd4895b715a3525ccb8bb4 +# 7337ce8d03e5474887cd6affc21ec03b +# 2fb0a6afd5b24c33820ccaed19dd886d +# 1ad0f64aec2c4439937fa4d02ee0fe49 +# f955c9a3be324d2db1f47a643b9d51a3 +# 667016f994f84648853707ce13241d45 +#: ../../using/selecting.md:20 ../../using/selecting.md:37 +#: ../../using/selecting.md:49 ../../using/selecting.md:63 +#: ../../using/selecting.md:76 ../../using/selecting.md:87 +#: ../../using/selecting.md:100 ../../using/selecting.md:112 +msgid "Source on GitHub | Dockerfile commit history | Docker Hub image tags" +msgstr "" + +# 864aa76e1043469fa96b27f26dcad7d1 +#: ../../using/selecting.md:24 +msgid "" +"jupyter/base-notebook is a small image supporting the options common across " +"all core stacks. It is the basis for all other stacks." +msgstr "" + +# d869d6c4081e483180f51de5f5e225a7 +#: ../../using/selecting.md:26 +msgid "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" +msgstr "" + +# d6384943a3394b9d9a5a505e2387d392 +#: ../../using/selecting.md:27 +msgid "Miniconda Python 3.x in /opt/conda" +msgstr "" + +# 031a321f6173495daef86225cd234a72 +#: ../../using/selecting.md:28 +msgid "No preinstalled scientific computing packages" +msgstr "" + +# e37862b78262475182c34461d2fae08e +#: ../../using/selecting.md:29 +msgid "" +"Unprivileged user jovyan (uid=1000, configurable, see options) in group " +"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths" +msgstr "" + +# cdd04f4dbb864e82b8b993ccb1670687 +#: ../../using/selecting.md:30 +msgid "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" +msgstr "" + +# 0e3cf3b3a6e540be861ef295f1808099 +#: ../../using/selecting.md:31 +msgid "" +"A start-singleuser.sh script useful for launching containers in JupyterHub" +msgstr "" + +# 3b561d51339f422d801a408007ca16f3 +#: ../../using/selecting.md:32 +msgid "" +"A start.sh script useful for running alternative commands in the container " +"(e.g. ipython, jupyter kernelgateway, jupyter lab)" +msgstr "" + +# 9e8346716bc148fb8df45bce44fa7c38 +#: ../../using/selecting.md:33 +msgid "Options for a self-signed HTTPS certificate and passwordless sudo" +msgstr "" + +# ee56473bbb334a9b96db5870f6be611c +#: ../../using/selecting.md:35 +msgid "jupyter/minimal-notebook" +msgstr "" + +# eec9e5e3162343eba481b73cc223fa49 +#: ../../using/selecting.md:41 +msgid "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." +msgstr "" + +# cf19dcbf0d084508924f166d2b0fa7e3 +#: ../../using/selecting.md:43 +msgid "Everything in jupyter/base-notebook" +msgstr "" + +# 52d17abfd2f14628a9937f1b7584582d +#: ../../using/selecting.md:44 +msgid "Pandoc and TeX Live for notebook document conversion" +msgstr "" + +# b81070edc9c849c184be4687ce17b786 +#: ../../using/selecting.md:45 +msgid "git, emacs, jed, nano, tzdata, and unzip" +msgstr "" + +# aa65fcb5d17649bb88ded23f0880e147 +#: ../../using/selecting.md:47 +msgid "jupyter/r-notebook" +msgstr "" + +# 54b4b695a8ed493bb79993e62dd164c2 +#: ../../using/selecting.md:53 +msgid "jupyter/r-notebook includes popular packages from the R ecosystem." +msgstr "" + +# d83a0f40bfc34554a0c362f02c656e55 +# c27e75f042064ae0a64447053b46785e +#: ../../using/selecting.md:55 ../../using/selecting.md:69 +msgid "Everything in jupyter/minimal-notebook and its ancestor images" +msgstr "" + +# 99e3f1d20553480c81dda15a66369f52 +#: ../../using/selecting.md:56 +msgid "The R interpreter and base environment" +msgstr "" + +# 34bc2c80ad014b019fb54fc1fad024c4 +# 8c5a996a6b0c4309810071f5194f532a +#: ../../using/selecting.md:57 ../../using/selecting.md:119 +msgid "IRKernel to support R code in Jupyter notebooks" +msgstr "" + +# a24d121e485e4bd9bbe4df9883a7c148 +#: ../../using/selecting.md:58 +msgid "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, " +"stringr, lubridate, and broom from conda-forge" +msgstr "" + +# d49e405f45dd40a69e64b1636f69381d +#: ../../using/selecting.md:59 +msgid "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13," +" caret, rcurl, and randomforest packages from conda-forge" +msgstr "" + +# 9cfe9452daa04dfc982c2d99948a37eb +#: ../../using/selecting.md:61 +msgid "jupyter/scipy-notebook" +msgstr "" + +# 47f831c00a78451bb75de1467d90d34c +#: ../../using/selecting.md:67 +msgid "" +"jupyter/scipy-notebook includes popular packages from the scientific Python " +"ecosystem." +msgstr "" + +# da192888520b4b2ca9ae8ca5162aba6c +#: ../../using/selecting.md:70 +msgid "" +"pandas, numexpr, matplotlib, scipy, seaborn, scikit-learn, scikit-image, " +"sympy, cython, patsy, statsmodel, cloudpickle, dill, numba, bokeh, " +"sqlalchemy, hdf5, vincent, beautifulsoup, protobuf, and xlrd packages" +msgstr "" + +# be048a3494074da99c0f5b98454feda8 +#: ../../using/selecting.md:71 +msgid "ipywidgets for interactive visualizations in Python notebooks" +msgstr "" + +# c3e92433ff5f4702beeaea78d6ee6fd7 +#: ../../using/selecting.md:72 +msgid "Facets for visualizing machine learning datasets" +msgstr "" + +# ff01e76ad1544fb48e024a617ae932b5 +#: ../../using/selecting.md:74 +msgid "jupyter/tensorflow-notebook" +msgstr "" + +# bf2f117cf3a047aa8be8cd73f4080455 +#: ../../using/selecting.md:80 +msgid "" +"jupyter/tensorflow-notebook includes popular Python deep learning libraries." +msgstr "" + +# 1fccef5b590549ffb4ea6933eaf12674 +# 1140d31915eb42fc89725521ec90c1dc +#: ../../using/selecting.md:82 ../../using/selecting.md:106 +msgid "Everything in jupyter/scipy-notebook and its ancestor images" +msgstr "" + +# 099eb36a6961440b8bea7901b226a96d +#: ../../using/selecting.md:83 +msgid "tensorflow and keras machine learning libraries" +msgstr "" + +# 13413eabaac34b94b4bc5ae28e445dda +#: ../../using/selecting.md:85 +msgid "jupyter/datascience-notebook" +msgstr "" + +# 23244942c9ef4eb8aba10cd558bf5fe9 +#: ../../using/selecting.md:91 +msgid "" +"jupyter/datascience-notebook includes libraries for data analysis from the " +"Julia, Python, and R communities." +msgstr "" + +# 7e65863f6a0840729876d3669158c4ce +#: ../../using/selecting.md:93 +msgid "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and " +"their ancestor images" +msgstr "" + +# 6246f4a0d2454714860e4ffa80aef958 +#: ../../using/selecting.md:94 +msgid "The Julia compiler and base environment" +msgstr "" + +# 143e63b9b0a9418a8c93870f6186808e +#: ../../using/selecting.md:95 +msgid "IJulia to support Julia code in Jupyter notebooks" +msgstr "" + +# 7a170fe5f6a949cc939d2f40200b3336 +#: ../../using/selecting.md:96 +msgid "HDF5, Gadfly, and RDatasets packages" +msgstr "" + +# 4b741debc1e84661ab63b8bf0d9c3bbe +#: ../../using/selecting.md:98 +msgid "jupyter/pyspark-notebook" +msgstr "" + +# 815f62ec44f54dbfaa5a052d15580b94 +#: ../../using/selecting.md:104 +msgid "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." +msgstr "" + +# 0cb03ee6cd9d488597be17be045f3b74 +#: ../../using/selecting.md:107 +msgid "Apache Spark with Hadoop binaries" +msgstr "" + +# 977ee95d9f664fe2a62505e0a78b1447 +#: ../../using/selecting.md:108 +msgid "Mesos client libraries" +msgstr "" + +# 43c0814f5a024a598dd26a4af0212cea +#: ../../using/selecting.md:110 +msgid "jupyter/all-spark-notebook" +msgstr "" + +# 0c1536b3ff6d40a885e9cdd881dc19bd +#: ../../using/selecting.md:116 +msgid "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache " +"Spark, optionally on Mesos." +msgstr "" + +# ecf9548ffc5e4e0eb4bbdf6cb458cf32 +#: ../../using/selecting.md:118 +msgid "Everything in jupyter/pyspark-notebook and its ancestor images" +msgstr "" + +# 5f6081607cab47739c306516cf84a814 +#: ../../using/selecting.md:120 +msgid "" +"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" +msgstr "" + +# a4b50e47f8684dfbbe71e0c3353199dd +#: ../../using/selecting.md:121 +msgid "ggplot2, sparklyr, and rcurl packages" +msgstr "" + +# ebbdf9189d96433e9323aae035f37ec2 +#: ../../using/selecting.md:125 +msgid "" +"The following diagram depicts the build dependency tree of the core images. " +"(i.e., the FROM statements in their Dockerfiles). Any given image inherits " +"the complete content of all ancestor images pointing to it." +msgstr "" + +# df2da8e55aa740a485fd638aa7397b8a +#: ../../using/selecting.md:129 +msgid "Builds" +msgstr "" + +# 56066ef1cd834061b3c3aea7567221c7 +#: ../../using/selecting.md:131 +msgid "" +"Pull requests to the jupyter/docker-stacks repository trigger builds of all " +"images on Travis CI. These images are for testing purposes only and are not " +"saved for use. When pull requests merge to master, all images rebuild on " +"Docker Cloud and become available to docker pull from Docker Hub." +msgstr "" + +# f4781cd0f2c040458a15b80846026405 +#: ../../using/selecting.md:133 +msgid "Versioning" +msgstr "" + +# 28addf6682f24cbdb1b6cd1836a6dc74 +#: ../../using/selecting.md:135 +msgid "" +"The latest tag in each Docker Hub repository tracks the master branch HEAD " +"reference on GitHub. latest is a moving target, by definition, and will have" +" backward-incompatible changes regularly." +msgstr "" + +# 92c07d80753b4fda9406b3b2694684e7 +#: ../../using/selecting.md:137 +msgid "" +"Every image on Docker Hub also receives a 12-character tag which corresponds" +" with the git commit SHA that triggered the image build. You can inspect the" +" state of the jupyter/docker-stacks repository for that commit to review the" +" definition of the image (e.g., images with tag 7c45ec67c8e7 were built from" +" https://github.com/jupyter/docker-stacks/tree/7c45ec67c8e7)." +msgstr "" + +# 5bdfd71620394fa4812120220718ffeb +#: ../../using/selecting.md:139 +msgid "" +"You must refer to git-SHA image tags when stability and reproducibility are " +"important in your work. (e.g. FROM jupyter/scipy-notebook:7c45ec67c8e7, " +"docker run -it --rm jupyter/scipy-notebook:7c45ec67c8e7). You should only " +"use latest when a one-off container instance is acceptable (e.g., you want " +"to briefly try a new library in a notebook)." +msgstr "" + +# 90cc227d51734f8586d42982f3b7a559 +#: ../../using/selecting.md:143 +msgid "" +"The core stacks are just a tiny sample of what's possible when combining " +"Jupyter with other technologies. We encourage members of the Jupyter " +"community to create their own stacks based on the core images and link them " +"below." +msgstr "" + +# f1c9edb79eae4a5f929fdc1e0e2d4366 +#: ../../using/selecting.md:145 +msgid "This list only has 2 examples. You can be the next!" +msgstr "" + +# 7346986f864848708411fa0788d3b4e4 +#: ../../using/selecting.md:147 +msgid "" +"csharp-notebook is a community Jupyter Docker Stack image. Try C# in Jupyter" +" Notebooks. The image includes more than 200 Jupyter Notebooks with example " +"C# code and can readily be tried online via mybinder.org. Click here to " +"launch ." +msgstr "" + +# a2e061cf04bf4e96a4d40c03790d64bc +#: ../../using/selecting.md:149 +msgid "" +"education-notebook is a community Jupyter Docker Stack image. The image " +"includes nbgrader and RISE on top of the datascience-notebook image. Click " +"here to launch it on ." +msgstr "" + +# c3720b9d103947499b34ebd19567733f +#: ../../using/selecting.md:151 +msgid "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." +msgstr "" + +# b9f784eaaa0a4072929bc51254fa322e +#: ../../using/specifics.md:1 +msgid "Image Specifics" +msgstr "" + +# dfb2958ae819459383ad8c75ba65dd39 +#: ../../using/specifics.md:3 +msgid "" +"This page provides details about features specific to one or more images." +msgstr "" + +# 9cfa68a10a3c4eb8b63c435e43bf77fc +#: ../../using/specifics.md:5 +msgid "Apache Spark" +msgstr "" + +# 536591b439514687b086cf6a4c6f7a93 +#: ../../using/specifics.md:7 +msgid "" +"The jupyter/pyspark-notebook and jupyter/all-spark-notebook images support " +"the use of Apache Spark in Python, R, and Scala notebooks. The following " +"sections provide some examples of how to get started using them." +msgstr "" + +# 21d870dca44845948d9ab959f8ccc105 +#: ../../using/specifics.md:9 +msgid "Using Spark Local Mode" +msgstr "" + +# bda9eb0bb22b4e8e8662fcd037d9d585 +#: ../../using/specifics.md:11 +msgid "" +"Spark local mode is useful for experimentation on small data when you do not" +" have a Spark cluster available." +msgstr "" + +# 91033be3c31b48d4a1a6a235491bd897 +# 6cc19049cacb4403989934496ecc4375 +#: ../../using/specifics.md:13 ../../using/specifics.md:71 +msgid "In a Python Notebook" +msgstr "" + +# 556a0ebdcab54a87b01f1b8bed45628e +# 823b89e12a514c54b10255bcc2081397 +#: ../../using/specifics.md:24 ../../using/specifics.md:98 +msgid "In a R Notebook" +msgstr "" + +# a42af3a3c0a44602b15d8d7ed52d267b +# cb0340653342464892f57379cf775ea9 +#: ../../using/specifics.md:36 ../../using/specifics.md:119 +msgid "In a Spylon Kernel Scala Notebook" +msgstr "" + +# f6efc67ea4d14900a978e0d581e6448a +#: ../../using/specifics.md:38 +msgid "" +"Spylon kernel instantiates a SparkContext for you in variable sc after you " +"configure Spark options in a %%init_spark magic cell." +msgstr "" + +# 48c05ebdfde54ea6b8794b47171a6c10 +# 66315cf3b7554105bfeaf6a3a5b43b73 +#: ../../using/specifics.md:52 ../../using/specifics.md:134 +msgid "In an Apache Toree Scala Notebook" +msgstr "" + +# 5d8060e95aa941e58a64d0465dbacafa +#: ../../using/specifics.md:54 +msgid "" +"Apache Toree instantiates a local SparkContext for you in variable sc when " +"the kernel starts." +msgstr "" + +# 1a30fe3a85fa44b1860efb1e8bf123e3 +#: ../../using/specifics.md:61 +msgid "Connecting to a Spark Cluster on Mesos" +msgstr "" + +# 74263d337820458d851a4b869d14f1cf +#: ../../using/specifics.md:63 +msgid "" +"This configuration allows your compute cluster to scale with your data." +msgstr "" + +# c7ca76d01c6e4f10ad8f793b65dc41db +#: ../../using/specifics.md:65 +msgid "Deploy Spark on Mesos." +msgstr "" + +# 296f9c1d6f2a4950a1147913198bc1bc +#: ../../using/specifics.md:66 +msgid "" +"Configure each slave with the --no-switch_user flag or create the $NB_USER " +"account on every slave node." +msgstr "" + +# 2d988e27cde44fa09feaed27ce3b7a06 +# 6045e72f079c4fc2ab9e3ce622968bc8 +#: ../../using/specifics.md:67 ../../using/specifics.md:163 +msgid "" +"Run the Docker container with --net=host in a location that is network " +"addressable by all of your Spark workers. (This is a Spark networking " +"requirement.)" +msgstr "" + +# f20142628b0f40379f87031abd6461b2 +# b00bbd0a10d4480db69f870cdf5fe094 +#: ../../using/specifics.md:68 ../../using/specifics.md:164 +msgid "" +"NOTE: When using --net=host, you must also use the flags --pid=host -e " +"TINI_SUBREAPER=true. See https://github.com/jupyter/docker-stacks/issues/64 " +"for details." +msgstr "" + +# 46c5b891e7ce4fa78d3c0eeff0e22635 +#: ../../using/specifics.md:69 +msgid "Follow the language specific instructions below." +msgstr "" + +# 90c742c66172412c862fcf09a2661bf5 +#: ../../using/specifics.md:136 +msgid "" +"The Apache Toree kernel automatically creates a SparkContext when it starts " +"based on configuration information from its command line arguments and " +"environment variables. You can pass information about your Mesos cluster via" +" the SPARK_OPTS environment variable when you spawn a container." +msgstr "" + +# 7c2b15ef25ba4cd29ff222b808a8fd68 +#: ../../using/specifics.md:138 +msgid "" +"For instance, to pass information about a Mesos master, Spark binary " +"location in HDFS, and an executor options, you could start the container " +"like so:" +msgstr "" + +# 94f9511094e044f08129c273ce3efaf0 +#: ../../using/specifics.md:146 +msgid "" +"Note that this is the same information expressed in a notebook in the Python" +" case above. Once the kernel spec has your cluster information, you can test" +" your cluster in an Apache Toree notebook like so:" +msgstr "" + +# e0c67007d0cc4c9da0fb73d5ed25356d +#: ../../using/specifics.md:157 +msgid "Connecting to a Spark Cluster in Standalone Mode" +msgstr "" + +# 6c6f7d3049814b25a3acf211e2587ec2 +#: ../../using/specifics.md:159 +msgid "" +"Connection to Spark Cluster on Standalone Mode requires the following set of" +" steps:" +msgstr "" + +# 4634540d7990421fb60e85b6241dd816 +#: ../../using/specifics.md:161 +msgid "" +"Verify that the docker image (check the Dockerfile) and the Spark Cluster " +"which is being deployed, run the same version of Spark." +msgstr "" + +# d6b4329933e24b69879a4621b26bf454 +#: ../../using/specifics.md:162 +msgid "Deploy Spark in Standalone Mode." +msgstr "" + +# 3dfcc2e12ca34c92ac8ebf96e4a37066 +#: ../../using/specifics.md:165 +msgid "" +"The language specific instructions are almost same as mentioned above for " +"Mesos, only the master url would now be something like " +"spark://10.10.10.10:7077" +msgstr "" + +# 9e271f07799e4cb0a4b79df224a5639f +#: ../../using/specifics.md:167 +msgid "Tensorflow" +msgstr "" + +# 2a525d328e6f419f98d2ed3b99978e25 +#: ../../using/specifics.md:169 +msgid "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." +msgstr "" + +# 4440ceaa200f4029b5cbaf9c895a8e5c +#: ../../using/specifics.md:171 +msgid "Single Machine Mode" +msgstr "" + +# d82de0694427429fa44d9988c1db4851 +#: ../../using/specifics.md:185 +msgid "Distributed Mode" +msgstr "" diff --git a/docs/maintaining/tasks.md b/docs/maintaining/tasks.md index f43b831c42..faf1f4f3d2 100644 --- a/docs/maintaining/tasks.md +++ b/docs/maintaining/tasks.md @@ -55,3 +55,28 @@ If automated builds on Docker Cloud have got you down, do the following to push 2. Check out the git SHA you want to build and publish. 3. `docker login` with your Docker Hub/Cloud credentials. 4. Run `make retry/release-all`. + +## Enabling a New Doc Language Translation + +First enable translation on Transifex: + +1. Visit https://www.transifex.com/project-jupyter/jupyter-docker-stacks-1/languages/ +2. Click *Edit Languages* in the top right. +3. Select the language from the dropdown. +4. Click *Apply*. + +Then setup a subproject on ReadTheDocs for the language: + +1. Visit https://readthedocs.org/dashboard/import/manual/ +2. Enter *jupyter-docker-stacks-* for the project name. +3. Enter https://github.com/jupyter/docker-stacks for the URL. +4. Check *Edit advanced project options*. +5. Click *Next*. +6. Select the *Language* from the dropdown on the next screen. +7. Click *Finish*. + +Finally link the new language subproject to the top level doc project: + +1. Visit https://readthedocs.org/dashboard/jupyter-docker-stacks/translations/ +2. Select the subproject you created from the *Project* dropdown. +3. Click *Add*. diff --git a/docs/using/common.md b/docs/using/common.md index ff44c9cf45..5e10bc1748 100644 --- a/docs/using/common.md +++ b/docs/using/common.md @@ -75,7 +75,7 @@ In either case, Jupyter Notebook expects the key and certificate to be a base64 For additional information about using SSL, see the following: * The [docker-stacks/examples](https://github.com/jupyter/docker-stacks/tree/master/examples) for information about how to use [Let's Encrypt](https://letsencrypt.org/) certificates when you run these stacks on a publicly visible domain. -* The [jupyter_notebook_config.py](jupyter_notebook_config.py) file for how this Docker image generates a self-signed certificate. +* The [jupyter_notebook_config.py](https://github.com/jupyter/docker-stacks/blob/master/base-notebook/jupyter_notebook_config.py) file for how this Docker image generates a self-signed certificate. * The [Jupyter Notebook documentation](https://jupyter-notebook.readthedocs.io/en/latest/public_server.html#securing-a-notebook-server) for best practices about securing a public notebook server in general. ## Alternative Commands @@ -98,7 +98,7 @@ This script is particularly useful when you derive a new Dockerfile from this im ### Others -You can bypass the provided scripts and specify your an arbitrary start command. If you do, keep in mind that features supported by the `start.sh` script and its kin will not function (e.g., `GRANT_SUDO`). +You can bypass the provided scripts and specify an arbitrary start command. If you do, keep in mind that features supported by the `start.sh` script and its kin will not function (e.g., `GRANT_SUDO`). ## Conda Environments diff --git a/docs/using/recipes.md b/docs/using/recipes.md index 2e3c3b65df..3bb07b158f 100644 --- a/docs/using/recipes.md +++ b/docs/using/recipes.md @@ -1,6 +1,6 @@ # Contributed Recipes -Users sometimes share interesting ways of using the Jupyter Docker Stacks. We encourage users to [contribute these recipes](../contributing/recipes.html) to the documentation in case they prove useful to other members of the community by submitting a pull request to `docs/using/recipes.md`. The sections below capture this knowledge. +Users sometimes share interesting ways of using the Jupyter Docker Stacks. We encourage users to [contribute these recipes](../contributing/recipes.md) to the documentation in case they prove useful to other members of the community by submitting a pull request to `docs/using/recipes.md`. The sections below capture this knowledge. ## Using `pip install` or `conda install` in a Child Docker image diff --git a/docs/using/selecting.md b/docs/using/selecting.md index e91cfc9c4f..644c23bf58 100644 --- a/docs/using/selecting.md +++ b/docs/using/selecting.md @@ -21,7 +21,7 @@ The Jupyter team maintains a set of Docker image definitions in the [https://git | [Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/base-notebook/Dockerfile) | [Docker Hub image tags](https://hub.docker.com/r/jupyter/base-notebook/tags/) -`jupyter/base-notebook` is a small image supporting the [options common across all core stacks](common.html). It is the basis for all other stacks. +`jupyter/base-notebook` is a small image supporting the [options common across all core stacks](common.md). It is the basis for all other stacks. * Minimally-functional Jupyter Notebook server (e.g., no [pandoc](https://pandoc.org/) for saving notebooks as PDFs) * [Miniconda](https://conda.io/miniconda.html) Python 3.x in `/opt/conda` @@ -148,4 +148,4 @@ The core stacks are just a tiny sample of what's possible when combining Jupyter * [education-notebook is a community Jupyter Docker Stack image](https://github.com/umsi-mads/education-notebook). The image includes nbgrader and RISE on top of the datascience-notebook image. Click here to launch it on [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/umsi-mads/education-notebook/master). -See the [contributing guide](../contributing/stacks.html) for information about how to create your own Jupyter Docker Stack. +See the [contributing guide](../contributing/stacks.md) for information about how to create your own Jupyter Docker Stack. diff --git a/docs/using/specifics.md b/docs/using/specifics.md index 7d9ea5bb39..1050c4cd62 100644 --- a/docs/using/specifics.md +++ b/docs/using/specifics.md @@ -13,12 +13,10 @@ Spark local mode is useful for experimentation on small data when you do not hav #### In a Python Notebook ```python -import pyspark -sc = pyspark.SparkContext('local[*]') - +from pyspark.sql import SparkSession +spark = SparkSession.builder.appName("SimpleApp").getOrCreate() # do something to prove it works -rdd = sc.parallelize(range(1000)) -rdd.takeSample(False, 5) +spark.sql('SELECT "Test" as c1').show() ``` #### In a R Notebook diff --git a/pyspark-notebook/Dockerfile b/pyspark-notebook/Dockerfile index 8ebd1cbf74..7b5b751722 100644 --- a/pyspark-notebook/Dockerfile +++ b/pyspark-notebook/Dockerfile @@ -8,7 +8,7 @@ LABEL maintainer="Jupyter Project " USER root # Spark dependencies -ENV APACHE_SPARK_VERSION 2.4.1 +ENV APACHE_SPARK_VERSION 2.4.2 ENV HADOOP_VERSION 2.7 RUN apt-get -y update && \ @@ -17,7 +17,7 @@ RUN apt-get -y update && \ RUN cd /tmp && \ wget -q http://mirrors.ukfast.co.uk/sites/ftp.apache.org/spark/spark-${APACHE_SPARK_VERSION}/spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION}.tgz && \ - echo "360A7B57290537C5EB3570C70D0D0B9580C4F9DB8D0FA9746C3BBB6544BBB8F629901582968955ACEB5649CB9D66C2D524971E4E3EF34C35D96F02FF6DBA4D72 *spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION}.tgz" | sha512sum -c - && \ + echo "16E3F803214923E3FD7D04B64D79E4B810E6E4A2723961443D09982FC104BA1A08DF029CE573633DCA7056340FA26B771EAFBDD3B5CEA14C1F01081D84575F02 *spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION}.tgz" | sha512sum -c - && \ tar xzf spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION}.tgz -C /usr/local --owner root --group root --no-same-owner && \ rm spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION}.tgz RUN cd /usr/local && ln -s spark-${APACHE_SPARK_VERSION}-bin-hadoop${HADOOP_VERSION} spark diff --git a/requirements-dev.txt b/requirements-dev.txt index 0eb06d6411..9a268afc04 100644 --- a/requirements-dev.txt +++ b/requirements-dev.txt @@ -1,5 +1,7 @@ docker pytest -recommonmark==0.4.0 +recommonmark==0.5.0 requests sphinx>=1.6 +sphinx-intl +transifex-client diff --git a/tensorflow-notebook/Dockerfile b/tensorflow-notebook/Dockerfile index de6fe9cd00..1848da0998 100644 --- a/tensorflow-notebook/Dockerfile +++ b/tensorflow-notebook/Dockerfile @@ -7,7 +7,7 @@ LABEL maintainer="Jupyter Project " # Install Tensorflow RUN conda install --quiet --yes \ - 'tensorflow=1.12*' \ + 'tensorflow=1.13*' \ 'keras=2.2*' && \ conda clean --all -f -y && \ fix-permissions $CONDA_DIR && \