diff --git a/docs/.tx/config b/docs/.tx/config new file mode 100644 index 00000000..4915396d --- /dev/null +++ b/docs/.tx/config @@ -0,0 +1,27 @@ +[main] +host = https://www.transifex.com + +[jupyter-docker-stacks-1.using] +file_filter = locale//LC_MESSAGES/using.po +source_file = _build/gettext/using.pot +source_lang = en +type = PO + +[jupyter-docker-stacks-1.maintaining] +file_filter = locale//LC_MESSAGES/maintaining.po +source_file = _build/gettext/maintaining.pot +source_lang = en +type = PO + +[jupyter-docker-stacks-1.index] +file_filter = locale//LC_MESSAGES/index.po +source_file = _build/gettext/index.pot +source_lang = en +type = PO + +[jupyter-docker-stacks-1.contributing] +file_filter = locale//LC_MESSAGES/contributing.po +source_file = _build/gettext/contributing.pot +source_lang = en +type = PO + diff --git a/docs/conf.py b/docs/conf.py index 3d528a0d..5ecdc278 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -52,7 +52,7 @@ master_doc = 'index' # 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 @@ texinfo_documents = [ '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/locale/en/LC_MESSAGES/contributing.po b/docs/locale/en/LC_MESSAGES/contributing.po new file mode 100644 index 00000000..3367c07c --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/contributing.po @@ -0,0 +1,776 @@ +# 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: 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" + +# 9527c87037fb4592a05d144d80f69f89 +#: ../../contributing/features.md:1 +msgid "New Features" +msgstr "New Features" + +# 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 "" +"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." + +# b35331d86206420aa8235d20ef037215 +#: ../../contributing/features.md:5 +msgid "Suggesting a New Feature" +msgstr "Suggesting a New Feature" + +# 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 "" +"Please follow the process below to suggest a new feature for inclusion in " +"one of the core stacks:" + +# a9cd9d0730cc4159aa227e970ae2d9d0 +#: ../../contributing/features.md:9 +msgid "Open a GitHub issue describing the feature you'd like to contribute." +msgstr "Open a GitHub issue describing the feature you'd like to contribute." + +# 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 "" +"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." + +# a995c15adfb7424e9852693b90569d7a +#: ../../contributing/features.md:12 +msgid "Selection Criteria" +msgstr "Selection Criteria" + +# 981cef217f4e4225984c5c7989f592f8 +#: ../../contributing/features.md:14 +msgid "" +"Roughly speaking, we evaluate new features based on the following criteria:" +msgstr "" +"Roughly speaking, we evaluate new features based on the following criteria:" + +# 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 "" +"Usefulness to Jupyter users: Is the feature generally applicable across " +"domains? Does it work with Jupyter Notebook, JupyterLab, JupyterHub, etc.?" + +# 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 "" +"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?" + +# 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 "" +"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?" + +# 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 "" +"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?" + +# 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 "" +"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?" + +# 6085a8c0829e411588a37777bfe5e0f4 +#: ../../contributing/features.md:22 +msgid "Submitting a Pull Request" +msgstr "Submitting a Pull Request" + +# fa5dc8dbaedb483b888622cc9d1e94ae +#: ../../contributing/features.md:24 +msgid "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" +msgstr "" +"If there's agreement that the feature belongs in one or more of the core " +"stacks:" + +# 23ae2ae62bdb4a35bc42d9efc7759944 +#: ../../contributing/features.md:26 +msgid "" +"Implement the feature in a local clone of the jupyter/docker-stacks project." +msgstr "" +"Implement the feature in a local clone of the jupyter/docker-stacks project." + +# 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 "" +"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:" + +# 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 "Submit a pull request (PR) with your changes." + +# 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 "" +"Watch for Travis to report a build success or failure for your PR on GitHub." + +# f80657a299424b8685d452d70479bae6 +#: ../../contributing/features.md:33 +msgid "Discuss changes with the maintainers and address any build issues." +msgstr "Discuss changes with the maintainers and address any build issues." + +# 57ead3e81b9b4ebaa7a3491818f60089 +#: ../../contributing/issues.md:1 +msgid "Project Issues" +msgstr "Project Issues" + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"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." + +# 3815aec9c791444cbdf26a71e28a1f7c +#: ../../contributing/packages.md:1 +msgid "Package Updates" +msgstr "Package Updates" + +# 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 "" +"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." + +# ff8faef49758489fb97ddaba60763a0e +#: ../../contributing/packages.md:5 +msgid "Please follow the process below to update a package version:" +msgstr "Please follow the process below to update a package version:" + +# 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 "" +"Locate the Dockerfile containing the library you wish to update (e.g., base-" +"notebook/Dockerfile, scipy-notebook/Dockerfile)" + +# 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 "" +"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.*." + +# 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 "" +"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:" + +# 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 "" +"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." + +# adf5db8b690d466a8d339c756a5a153c +#: ../../contributing/recipes.md:1 +msgid "New Recipes" +msgstr "New Recipes" + +# 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 "" +"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:" + +# 5b84ed1b594845ec81f39b87e7c5d82b +#: ../../contributing/recipes.md:5 +msgid "Open the docs/using/recipes.md source file." +msgstr "Open the docs/using/recipes.md source file." + +# 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 "" +"Add a second-level Markdown heading naming your recipe at the bottom of the " +"file (e.g., `## Add the RISE extension``)" + +# 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 "" +"Write the body of your recipe under the heading, including whatever command " +"line, Dockerfile, links, etc. you need." + +# 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 "" +"Submit a pull request (PR) with your changes. Maintainers will respond and " +"work with you to address any formatting or content issues." + +# 0b8332c390304a1ab29a4b2b030e7997 +#: ../../contributing/stacks.md:1 +msgid "Community Stacks" +msgstr "Community Stacks" + +# 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 "" +"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:" + +# 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 "" +"Setup a project on GitHub containing a Dockerfile based on either the " +"jupyter/base-notebook or jupyter/minimal-notebook image." + +# c05df9d2cf8c4505b0951f0ea88f1daf +#: ../../contributing/stacks.md:6 +msgid "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." +msgstr "" +"Configure Travis CI to build and test your image when users submit pull " +"requests to your repository." + +# 077482de9feb4fa2b1e5e477fd5591f1 +#: ../../contributing/stacks.md:7 +msgid "" +"Configure Docker Cloud to build and host your images for others to use." +msgstr "" +"Configure Docker Cloud to build and host your images for others to use." + +# e2fe70e1ea6e4322a8dfa4380f8e54bb +#: ../../contributing/stacks.md:8 +msgid "" +"Update the list of community stacks in this documentation to include your " +"image." +msgstr "" +"Update the list of community stacks in this documentation to include your " +"image." + +# 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 "" +"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." + +# 0107f213096c41c8b1cb367b84fee30d +#: ../../contributing/stacks.md:12 +msgid "Creating a Project" +msgstr "Creating a Project" + +# cb35d196dc42402f9b338e56fcd3faa6 +#: ../../contributing/stacks.md:14 +msgid "First, install cookiecutter using pip or conda:" +msgstr "First, install cookiecutter using pip or conda:" + +# 09066f77e38c42889844dafb226df4bd +#: ../../contributing/stacks.md:20 +msgid "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." +msgstr "" +"Run the cookiecutter command pointing to the jupyter/cookiecutter-docker-" +"stacks project on GitHub." + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"Select an image from the jupyter/docker-stacks project that will serve as " +"the base for your new image." + +# 3611e7452640414d9d0535292abd113d +#: ../../contributing/stacks.md:48 +msgid "Enter a longer description of the stack for your README." +msgstr "Enter a longer description of the stack for your README." + +# 782321361a3b4116a2d3dafa7cc1424f +#: ../../contributing/stacks.md:54 +msgid "Initialize your project as a Git repository and push it to GitHub." +msgstr "Initialize your project as a Git repository and push it to GitHub." + +# b699fe5155774c93938427a241d0f239 +#: ../../contributing/stacks.md:66 +msgid "Configuring Travis" +msgstr "Configuring Travis" + +# 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 "" +"Next, link your GitHub project to Travis CI to build your Docker image " +"whenever you or someone else submits a pull request." + +# 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 "" +"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." + +# 4cf36f34a47b410a982be3237af720cd +#: ../../contributing/stacks.md:71 +msgid "Visit https://travis-ci.org." +msgstr "Visit https://travis-ci.org." + +# fdd694f5ebf443ce9d2d220d5945c299 +#: ../../contributing/stacks.md:72 +msgid "Click the + symbol at the top of the left sidebar." +msgstr "Click the + symbol at the top of the left sidebar." + +# 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 "" +"Locate your project repository either in your primary user account or in one" +" of the organizations to which you belong." + +# a1917b1360434fb18a3522e0a9806a11 +#: ../../contributing/stacks.md:75 +msgid "Click the toggle to enable builds for the project repository." +msgstr "Click the toggle to enable builds for the project repository." + +# 7dcbafc96c4a4ef88d7bc34e31a0af04 +#: ../../contributing/stacks.md:76 +msgid "Click the Settings button for that repository." +msgstr "Click the Settings button for that repository." + +# dd006e53f5cc4c1ea1501d62119f526e +#: ../../contributing/stacks.md:78 +msgid "" +"Enable Build only if .travis.yml is present and Build pushed pull requests." +msgstr "" +"Enable Build only if .travis.yml is present and Build pushed pull requests." + +# 0a5e54cd5f294a52983c2ec73559f810 +#: ../../contributing/stacks.md:80 +msgid "Disable Build pushed branches." +msgstr "Disable Build pushed branches." + +# 2ddf5289794648a3b7d1f604ce744331 +#: ../../contributing/stacks.md:82 +msgid "Configuring Docker Cloud" +msgstr "Configuring Docker Cloud" + +# 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 "" +"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." + +# 7ab258ec2f1e4942a983996a6c5e6fa5 +#: ../../contributing/stacks.md:86 +msgid "Visit https://cloud.docker.com/ and login." +msgstr "Visit https://cloud.docker.com/ and login." + +# 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 "" +"Select the account or organization matching the one you entered when " +"prompted with stack_org by the cookiecutter." + +# 0997628fd41449c5b0598e7e1bf1f005 +#: ../../contributing/stacks.md:89 +msgid "Scroll to the bottom of the page and click Create repository." +msgstr "Scroll to the bottom of the page and click Create repository." + +# 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 "" +"Enter the name of the image matching the one you entered when prompted with " +"stack_name by the cookiecutter." + +# c92796a106c846f585c88fb5a015fa6d +#: ../../contributing/stacks.md:92 +msgid "Enter a description for your image." +msgstr "Enter a description for your image." + +# 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 "" +"Click GitHub under the Build Settings and follow the prompts to connect your" +" account if it is not already connected." + +# bff3581410014975943ca77637142f14 +#: ../../contributing/stacks.md:94 +msgid "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." +msgstr "" +"Select the GitHub organization and repository containing your image " +"definition from the dropdowns." + +# 72cbc93bfe354e279e9384e7c95c801b +#: ../../contributing/stacks.md:96 +msgid "Click the Create and Build button." +msgstr "Click the Create and Build button." + +# bbb495328efd4fe7b339b7a7ffe908b0 +#: ../../contributing/stacks.md:98 +msgid "Defining Your Image" +msgstr "Defining Your Image" + +# 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 "" +"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." + +# 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 "" +"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." + +# de4bcc6e0ac1468ea761c038661ca19f +#: ../../contributing/stacks.md:104 +msgid "Sharing Your Image" +msgstr "Sharing Your Image" + +# 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 "" +"Finally, if you'd like to add a link to your project to this documentation " +"site, please do the following:" + +# 7357ed96047e42e6ae9e4bf123a00bed +#: ../../contributing/stacks.md:108 +msgid "Clone ths jupyter/docker-stacks GitHub repository." +msgstr "Clone ths jupyter/docker-stacks GitHub repository." + +# ee9284fe69244dcd8d44b25b8dc8b3a2 +#: ../../contributing/stacks.md:109 +msgid "" +"Open the docs/using/selecting.md source file and locate the Community Stacks" +" section." +msgstr "" +"Open the docs/using/selecting.md source file and locate the Community Stacks" +" section." + +# 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 "" +"Add a bullet with a link to your project and a short description of what " +"your Docker image contains." + +# 0f652c5259d544b595e847365dfe843a +#: ../../contributing/tests.md:1 +msgid "Image Tests" +msgstr "Image Tests" + +# 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 "" +"We greatly appreciate pull requests that extend the automated tests that vet" +" the basic functionality of the Docker images." + +# 67b27592447e47af8b0b00eeb745fc70 +#: ../../contributing/tests.md:5 +msgid "How the Tests Work" +msgstr "How the Tests Work" + +# 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 "" +"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." + +# 15207b72b26741f0a6a77949a4d9d0f4 +#: ../../contributing/tests.md:9 +msgid "Contributing New Tests" +msgstr "Contributing New Tests" + +# 5470865e6d144e51a428221e49e448fb +#: ../../contributing/tests.md:11 +msgid "Please follow the process below to add new tests:" +msgstr "Please follow the process below to add new tests:" + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"Build one or more images you intend to test and run the tests locally. If " +"you use make, call:" + +# 0453d92037cb4e47a025bc9021bdc7db +#: ../../contributing/tests.md:22 +msgid "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." +msgstr "" +"Discuss changes with the maintainers and address any issues running the " +"tests on Travis." diff --git a/docs/locale/en/LC_MESSAGES/index.po b/docs/locale/en/LC_MESSAGES/index.po new file mode 100644 index 00000000..e9dd00c7 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/index.po @@ -0,0 +1,171 @@ +# 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: 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" + +# 85291a2c92d440a089cf156fba58b86a +#: ../../index.rst:32 ../../index.rst:32 +msgid "User Guide" +msgstr "User Guide" + +# e4a3fd32059d4486b6b0f3a6fb5065b5 +#: ../../index.rst:42 ../../index.rst:42 +msgid "Contributor Guide" +msgstr "Contributor Guide" + +# 45de48c8617d4ebe83b7ff7141295836 +#: ../../index.rst:53 ../../index.rst:53 +msgid "Maintainer Guide" +msgstr "Maintainer Guide" + +# aa99c4562d8d4cb3abfea375470e8af3 +#: ../../index.rst:59 ../../index.rst:59 +msgid "Getting Help" +msgstr "Getting Help" + +# 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 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):" + +# 8cd55fb113a049e7be445b21084df7ea +#: ../../index.rst:6 +msgid "Start a personal Jupyter Notebook server in a local Docker container" +msgstr "Start a personal Jupyter Notebook server in a local Docker container" + +# 285fa13bed8547b4af0cfc480adf4861 +#: ../../index.rst:7 +msgid "Run JupyterLab servers for a team using JupyterHub" +msgstr "Run JupyterLab servers for a team using JupyterHub" + +# a49d31cedd4946ea98d7a4c720340d84 +#: ../../index.rst:8 +msgid "Write your own project Dockerfile" +msgstr "Write your own project Dockerfile" + +# 0aff0df2e46a44b4bc8070545e83c42c +#: ../../index.rst:11 +msgid "Quick Start" +msgstr "Quick Start" + +# 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 "" +"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." + +# 9e4094e8de264e20bca0af8f6cf888b7 +#: ../../index.rst:15 +msgid "" +"The other pages in this documentation describe additional uses and features " +"in detail." +msgstr "" +"The other pages in this documentation describe additional uses and features " +"in detail." + +# 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 "" +"**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.::" + +# 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 "" +"**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.::" + +# 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 "" +"**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.::" + +# 1bc0c7d54cd343d689362047c0b00122 +#: ../../index.rst:30 +msgid "Table of Contents" +msgstr "Table of Contents" diff --git a/docs/locale/en/LC_MESSAGES/maintaining.po b/docs/locale/en/LC_MESSAGES/maintaining.po new file mode 100644 index 00000000..f6a2c389 --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/maintaining.po @@ -0,0 +1,320 @@ +# 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: 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" + +# cefae71d9a804ab69c7e9f0a53eb7475 +#: ../../maintaining/tasks.md:1 +msgid "Maintainer Playbook" +msgstr "Maintainer Playbook" + +# af6a24b053794e55bddfe6e2e21ae74f +#: ../../maintaining/tasks.md:3 +msgid "Merging Pull Requests" +msgstr "Merging Pull Requests" + +# 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 "" +"To build new images on Docker Cloud and publish them to the Docker Hub " +"registry, do the following:" + +# 1597bb99448f41b994d1c7073b9c8721 +#: ../../maintaining/tasks.md:7 +msgid "Make sure Travis is green for a PR." +msgstr "Make sure Travis is green for a PR." + +# 401ed2733771440e8ef089f54cf2984d +#: ../../maintaining/tasks.md:8 +msgid "Merge the PR." +msgstr "Merge the PR." + +# 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 "" +"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." + +# 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 "" +"Manually click the retry button next to any build that fails to resume that " +"build and any dependent builds." + +# 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 "" +"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." + +# 62ddd25e15064cea950f9f13a663dcdb +#: ../../maintaining/tasks.md:13 +msgid "Updating the Ubuntu Base Image" +msgstr "Updating the Ubuntu Base Image" + +# 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 "" +"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." + +# d834495e774a4fee952324e4cc5ab514 +#: ../../maintaining/tasks.md:17 +msgid "Adding a New Core Image to Docker Cloud" +msgstr "Adding a New Core Image to Docker Cloud" + +# 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 "" +"When there's a new stack definition, do the following before merging the PR " +"with the new stack:" + +# 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 "" +"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." + +# 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 "" +"Ensure the PR updates the Makefile which is used to build the stacks in " +"order on Travis CI." + +# 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 "" +"Create a new repository in the jupyter org on Docker Cloud named after the " +"stack folder in the git repo." + +# 1811dcec60e3433d94514eaeebecb44b +#: ../../maintaining/tasks.md:24 +msgid "Grant the stacks team permission to write to the repo." +msgstr "Grant the stacks team permission to write to the repo." + +# afa7b1fcb0224380a111fe94f7781d60 +#: ../../maintaining/tasks.md:25 +msgid "Click Builds and then Configure Automated Builds for the repository." +msgstr "Click Builds and then Configure Automated Builds for the repository." + +# 35b969b9f7a442d99f54a73494033d90 +#: ../../maintaining/tasks.md:26 +msgid "Select jupyter/docker-stacks as the source repository." +msgstr "Select jupyter/docker-stacks as the source repository." + +# 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 "" +"Choose Build on Docker Cloud's infrastructure using a Small node unless you " +"have reason to believe a bigger host is required." + +# dc41895431b64657b5e24a8c96779ca6 +#: ../../maintaining/tasks.md:28 +msgid "" +"Update the Build Context in the default build rule to be /." +msgstr "" +"Update the Build Context in the default build rule to be /." + +# 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 "" +"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., " +"like jupyter/base-notebook)." + +# c5a459d038714ff78d4f156ee227d9ca +#: ../../maintaining/tasks.md:30 +msgid "" +"If the new stack depends on the build of another stack in the hierarchy:" +msgstr "" +"If the new stack depends on the build of another stack in the hierarchy:" + +# 611376c2ec6942479f60129177d312cc +#: ../../maintaining/tasks.md:31 +msgid "Hit Save and then click Configure Automated Builds." +msgstr "Hit Save and then click Configure Automated Builds." + +# 81cc56c63891432d89d4df3001f1bcde +#: ../../maintaining/tasks.md:32 +msgid "At the very bottom, add a build trigger named Stack hierarchy trigger." +msgstr "" +"At the very bottom, add a build trigger named Stack hierarchy trigger." + +# 9e55682a966a422c846a3463c7a30cfe +#: ../../maintaining/tasks.md:33 +msgid "Copy the build trigger URL." +msgstr "Copy the build trigger URL." + +# a9d853a1d45b4ead965813822a96c934 +#: ../../maintaining/tasks.md:34 +msgid "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." +msgstr "" +"Visit the parent repository Builds page and click Configure Automated " +"Builds." + +# 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 "" +"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." + +# 1aa0e4b95ab847e0be8ac9647433c991 +# 7dfff62380a041968ee6e739b1ca271f +#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40 +msgid "Hit Save." +msgstr "Hit Save." + +# 8315ed043efb40238227f8be0ad61b52 +#: ../../maintaining/tasks.md:37 +msgid "If the new stack should trigger other dependent builds:" +msgstr "If the new stack should trigger other dependent builds:" + +# 6e0e15d05a544476b91794d10b8732ff +#: ../../maintaining/tasks.md:38 +msgid "Add an environment variable named NEXT_BUILD_TRIGGERS." +msgstr "Add an environment variable named NEXT_BUILD_TRIGGERS." + +# 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 "" +"Copy the build trigger URLs from the dependent builds into the " +"NEXT_BUILD_TRIGGERS comma separated list of URLs." + +# 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 "" +"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order " +"matches that in the stack hierarchy diagram." + +# 51c8151943794bc8b1d51d65ccd84736 +#: ../../maintaining/tasks.md:43 +msgid "Adding a New Maintainer Account" +msgstr "Adding a New Maintainer Account" + +# 1994c19e7a734b2cad9af0afcd7da31e +#: ../../maintaining/tasks.md:45 +msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" +msgstr "Visit https://cloud.docker.com/app/jupyter/team/stacks/users" + +# 390ccdde528146bbbc3d2f62717a647c +#: ../../maintaining/tasks.md:46 +msgid "Add the maintainer's Docker Cloud username." +msgstr "Add the maintainer's Docker Cloud username." + +# b0227c37244c4b82848cc2655f134d21 +#: ../../maintaining/tasks.md:47 +msgid "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members" +msgstr "" +"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members" + +# b0fdbdd14b1444d1b696d8367aa111fb +#: ../../maintaining/tasks.md:48 +msgid "Add the maintainer's GitHub username." +msgstr "Add the maintainer's GitHub username." + +# abe2cb04fcb9447496bf3bc9fb230cdc +#: ../../maintaining/tasks.md:50 +msgid "Pushing a Build Manually" +msgstr "Pushing a Build Manually" + +# 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 "" +"If automated builds on Docker Cloud have got you down, do the following to " +"push a build manually:" + +# 3ebef623fa2f46f49ef639ad17105d4a +#: ../../maintaining/tasks.md:54 +msgid "Clone this repository." +msgstr "Clone this repository." + +# dcf8e9e8c72e40b9aa23c090311d6ea2 +#: ../../maintaining/tasks.md:55 +msgid "Check out the git SHA you want to build and publish." +msgstr "Check out the git SHA you want to build and publish." + +# fe788ad30f694b1f9b013cabfa820343 +#: ../../maintaining/tasks.md:56 +msgid "docker login with your Docker Hub/Cloud credentials." +msgstr "docker login with your Docker Hub/Cloud credentials." + +# 649dc474ffaa483eb625ed8061cb0097 +#: ../../maintaining/tasks.md:57 +msgid "Run make retry/release-all." +msgstr "Run make retry/release-all." diff --git a/docs/locale/en/LC_MESSAGES/using.po b/docs/locale/en/LC_MESSAGES/using.po new file mode 100644 index 00000000..64faeecd --- /dev/null +++ b/docs/locale/en/LC_MESSAGES/using.po @@ -0,0 +1,1881 @@ +# 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: 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" + +# 22b65331d42e414b9320143d30499447 +#: ../../using/common.md:1 +msgid "Common Features" +msgstr "Common Features" + +# 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 "" +"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." + +# 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 "" +"This page describes the options supported by the startup script as well as " +"how to bypass it to run alternative commands." + +# bb55c8d7786e4c1f8e11c1e309931c41 +#: ../../using/common.md:7 +msgid "Notebook Options" +msgstr "Notebook Options" + +# 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 "" +"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:" + +# 5d73f06cae2c4990a942c76988f19c1f +#: ../../using/common.md:15 +msgid "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" +msgstr "" +"For example, to set the base URL of the notebook server, you can run the " +"following:" + +# 9d43ee0e147b43469f56c4895720f682 +#: ../../using/common.md:21 +msgid "Docker Options" +msgstr "Docker Options" + +# 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 "" +"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." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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')." + +# 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 "" +"-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')." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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." + +# 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 "" +"-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)." + +# 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 "" +"--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." + +# 42df7956876a4592be13f4ce3c9c8f54 +#: ../../using/common.md:39 +msgid "Startup Hooks" +msgstr "Startup Hooks" + +# 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 "" +"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:" + +# 473e6aea1cbc4e50b75eec179a476b46 +#: ../../using/common.md:44 +msgid "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" +msgstr "" +"/usr/local/bin/start-notebook.d/ - handled before any of the standard " +"options noted above are applied" + +# 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 "" +"/usr/local/bin/before-notebook.d/ - handled after all of the standard " +"options noted above are applied and just before the notebook server launches" + +# 68e7bf5e72d747f886129a962ae84eef +#: ../../using/common.md:49 +msgid "" +"See the run-hooks function in the jupyter/base-notebook start.sh script for " +"execution details." +msgstr "" +"See the run-hooks function in the jupyter/base-notebook start.sh script for " +"execution details." + +# 7a9436da93a34647a59ee4cc77be5300 +#: ../../using/common.md:52 +msgid "SSL Certificates" +msgstr "SSL Certificates" + +# 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 "" +"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:" + +# b38385bb5753460397e87480c71d621f +#: ../../using/common.md:64 +msgid "" +"Alternatively, you may mount a single PEM file containing both the key and " +"certificate. For example:" +msgstr "" +"Alternatively, you may mount a single PEM file containing both the key and " +"certificate. For example:" + +# 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 "" +"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)." + +# 030c5c35440b45d8b1a82abdb946609f +#: ../../using/common.md:75 +msgid "For additional information about using SSL, see the following:" +msgstr "For additional information about using SSL, see the following:" + +# 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 "" +"The docker-stacks/examples for information about how to use Let's Encrypt " +"certificates when you run these stacks on a publicly visible domain." + +# 9cc027cb57c044a782068bf45d3bc22e +#: ../../using/common.md:78 +msgid "" +"The jupyter_notebook_config.py file for how this Docker image generates a " +"self-signed certificate." +msgstr "" +"The jupyter_notebook_config.py file for how this Docker image generates a " +"self-signed certificate." + +# dbfcfb88b099481781c8f3b3011a73e9 +#: ../../using/common.md:79 +msgid "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." +msgstr "" +"The Jupyter Notebook documentation for best practices about securing a " +"public notebook server in general." + +# f8fcaea33627485799126c6b6e08e7dc +#: ../../using/common.md:81 +msgid "Alternative Commands" +msgstr "Alternative Commands" + +# 10a9b432d6dd4a8a804da1976d27127e +#: ../../using/common.md:83 +msgid "start.sh" +msgstr "start.sh" + +# 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 "" +"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:" + +# f9ade4ab67f54867a79b59937239d9a7 +#: ../../using/common.md:91 +msgid "" +"Or, to run JupyterLab instead of the classic notebook, run the following:" +msgstr "" +"Or, to run JupyterLab instead of the classic notebook, run the following:" + +# 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 "" +"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." + +# d4d085e167a942709b72de803ee03bc0 +#: ../../using/common.md:99 +msgid "Others" +msgstr "Others" + +# 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 "" +"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)." + +# bcd8d95440b2493a9ffbca0678a14ed9 +#: ../../using/common.md:103 +msgid "Conda Environments" +msgstr "Conda Environments" + +# 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 "" +"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." + +# 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 "" +"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." + +# cdff04cd2c814d2a993dcf793c1a32a0 +#: ../../using/recipes.md:1 +msgid "Contributed Recipes" +msgstr "Contributed Recipes" + +# 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 "" +"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." + +# a01a0ec46bc8469290ee140a69d6b0a4 +#: ../../using/recipes.md:5 +msgid "Using pip install or conda install in a Child Docker image" +msgstr "Using pip install or conda install in a Child Docker image" + +# 95d414d34880400bb6f17842eaacdb47 +#: ../../using/recipes.md:7 +msgid "Create a new Dockerfile like the one shown below." +msgstr "Create a new Dockerfile like the one shown below." + +# 1fa3f126a9a6401d9941748e79380f8e +#: ../../using/recipes.md:16 +msgid "Then build a new image." +msgstr "Then build a new image." + +# 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 "" +"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." + +# a11c4c3379f64b4f8028d4b4c7437292 +#: ../../using/recipes.md:35 +msgid "For conda, the Dockerfile is similar:" +msgstr "For conda, the Dockerfile is similar:" + +# 42213789b3a14b02a491455f3bcdfa9a +#: ../../using/recipes.md:47 +msgid "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" +msgstr "Ref: docker-stacks/commit/79169618d571506304934a7b29039085e77db78c" + +# 471f68531d274ce4a7ad2a9f4274d8a9 +#: ../../using/recipes.md:49 +msgid "Add a Python 2.x environment" +msgstr "Add a Python 2.x environment" + +# 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 "" +"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:" + +# e07ac0abd67c4bb2a746953b44cd2ba8 +#: ../../using/recipes.md:73 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/440" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/440" + +# 88ae461b17e140a1ae71a9c175b4bd0d +#: ../../using/recipes.md:75 +msgid "Run JupyterLab" +msgstr "Run JupyterLab" + +# dbf08b368b5346ec8f6549737e561e5f +#: ../../using/recipes.md:77 +msgid "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." +msgstr "" +"JupyterLab is preinstalled as a notebook extension starting in tag " +"c33a7dc0eece." + +# 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 "" +"Run jupyterlab using a command such as docker run -it --rm -p 8888:8888 " +"jupyter/datascience-notebook start.sh jupyter lab" + +# 1531d01600af476b8401421c9305cdf3 +#: ../../using/recipes.md:81 +msgid "Let's Encrypt a Notebook server" +msgstr "Let's Encrypt a Notebook server" + +# 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 "" +"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." + +# 17ac8453774a4b028df89f2bdb3feec1 +#: ../../using/recipes.md:85 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/78" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/78" + +# 020d1144ff094e49ba690fd3292bad1a +#: ../../using/recipes.md:87 +msgid "Slideshows with Jupyter and RISE" +msgstr "Slideshows with Jupyter and RISE" + +# 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 "" +"RISE allows via extension to create live slideshows of your notebooks, with " +"no conversion, adding javascript Reveal.js:" + +# 14fd425e7dad41c9b00fee87d7d2225e +#: ../../using/recipes.md:95 +msgid "Credit: Paolo D. based on docker-stacks/issues/43" +msgstr "Credit: Paolo D. based on docker-stacks/issues/43" + +# 3e38842bbf0244f5897f995d7744d4ed +#: ../../using/recipes.md:97 +msgid "xgboost" +msgstr "xgboost" + +# 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 "" +"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." + +# faf7639219434c4d902b0e9bd6e626c2 +#: ../../using/recipes.md:109 +msgid "Running behind a nginx proxy" +msgstr "Running behind a nginx proxy" + +# 912ad155cb4a45069d9e8ec8b1b87cb0 +#: ../../using/recipes.md:111 +msgid "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for" +" instance:" +msgstr "" +"Sometimes it is useful to run the Jupyter instance behind a nginx proxy, for" +" instance:" + +# 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 "" +"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)" + +# 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 "" +"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" + +# 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 "" +"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." + +# ba9a795db881452d8a815f3bf2f3aa7a +#: ../../using/recipes.md:118 +msgid "Host volume mounts and notebook errors" +msgstr "Host volume mounts and notebook errors" + +# 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 "" +"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" + +# b71f0c2e0f184959a9a6f0765b9f0b4e +#: ../../using/recipes.md:122 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/199" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/199" + +# 29b6203639a444d38051b7dd23195ad5 +#: ../../using/recipes.md:124 +msgid "Manpage installation" +msgstr "Manpage installation" + +# 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 "" +"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:" + +# 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 "" +"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:" + +# b41452481f5d421fa005b0e1a33bf9b4 +#: ../../using/recipes.md:173 +msgid "" +"Be sure to check the current base image in base-notebook before building." +msgstr "" +"Be sure to check the current base image in base-notebook before building." + +# 7b0274764c614b46b0a2e663231e59b7 +#: ../../using/recipes.md:175 +msgid "JupyterHub" +msgstr "JupyterHub" + +# ccf49b18478443ecbd9fd7fc9c171cd9 +#: ../../using/recipes.md:177 +msgid "We also have contributed recipes for using JupyterHub." +msgstr "We also have contributed recipes for using JupyterHub." + +# e5835af60f9c4bfeb8e6995d703f730e +#: ../../using/recipes.md:179 +msgid "Use JupyterHub's dockerspawner" +msgstr "Use JupyterHub's dockerspawner" + +# 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 "" +"In most cases for use with DockerSpawner, given any image that already has a" +" notebook stack set up, you would only need to add:" + +# 5d92054033604627ae5b3161c3d0b903 +#: ../../using/recipes.md:183 +msgid "install the jupyterhub-singleuser script (for the right Python)" +msgstr "install the jupyterhub-singleuser script (for the right Python)" + +# fcf37a1789f84906bde9085583cff95b +#: ../../using/recipes.md:184 +msgid "change the command to launch the single-user server" +msgstr "change the command to launch the single-user server" + +# e6f1488b2ffb4beaa2414ca545f10261 +#: ../../using/recipes.md:186 +msgid "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be" +" enough for most cases." +msgstr "" +"Swapping out the FROM line in the jupyterhub/singleuser Dockerfile should be" +" enough for most cases." + +# 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 "" +"Credit: Justin Tyberg, quanghoc, and Min RK based on docker-" +"stacks/issues/124 and docker-stacks/pull/185" + +# 260577d0e15f4102bbad7486357528d4 +#: ../../using/recipes.md:190 +msgid "Containers with a specific version of JupyterHub" +msgstr "Containers with a specific version of JupyterHub" + +# 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 "" +"To use a specific version of JupyterHub, the version of jupyterhub in your " +"image should match the version in the Hub itself." + +# 41410dcc4e264932b64e96e6857b1bd3 +#: ../../using/recipes.md:199 +msgid "Credit: MinRK" +msgstr "Credit: MinRK" + +# 68fe2ae525474d91af1d8647378f078b +#: ../../using/recipes.md:202 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/177" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/177" + +# 3b6b7a3b35aa42a8a70a5c9e91af21d2 +#: ../../using/recipes.md:204 +msgid "Spark" +msgstr "Spark" + +# 8d1092f2b1a64da292134b240b621f48 +#: ../../using/recipes.md:206 +msgid "" +"A few suggestions have been made regarding using Docker Stacks with spark." +msgstr "" +"A few suggestions have been made regarding using Docker Stacks with spark." + +# 54e47498667747d1a7f576895d140c6f +#: ../../using/recipes.md:208 +msgid "Using PySpark with AWS S3" +msgstr "Using PySpark with AWS S3" + +# 127111e623114603b4c841b66ce8f16f +#: ../../using/recipes.md:210 +msgid "Using Spark session for hadoop 2.7.3" +msgstr "Using Spark session for hadoop 2.7.3" + +# 5454399deea24bb2a166ddd1fd168752 +#: ../../using/recipes.md:230 +msgid "Using Spark context for hadoop 2.6.0" +msgstr "Using Spark context for hadoop 2.6.0" + +# af0c5beb70664b74b6798a869023b3ca +#: ../../using/recipes.md:252 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/127" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/127" + +# 56531d33de8c46bb853db7ecef65d1ef +#: ../../using/recipes.md:254 +msgid "Using Local Spark JARs" +msgstr "Using Local Spark JARs" + +# 783af638cf454b6ea8bfd04df9da967f +#: ../../using/recipes.md:270 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/154" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/154" + +# 80df4b671dc64d9bad9bd2915524fe02 +#: ../../using/recipes.md:272 +msgid "Using spark-packages.org" +msgstr "Using spark-packages.org" + +# 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 "" +"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." + +# 5a1cab88fa6c477a99f4352670b6cf76 +#: ../../using/recipes.md:276 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/43" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/43" + +# 753a64e86395492481c9541dcb91f0ed +#: ../../using/recipes.md:278 +msgid "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" +msgstr "Use jupyter/all-spark-notebooks with an existing Spark/YARN cluster" + +# 53fbe7a910d84359af93acf195711ffd +#: ../../using/recipes.md:342 +msgid "Credit: britishbadger from docker-stacks/issues/369" +msgstr "Credit: britishbadger from docker-stacks/issues/369" + +# c82c3fc2484d48d5889dd8e3e79723b2 +#: ../../using/recipes.md:344 +msgid "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with " +"no token)" +msgstr "" +"Run Jupyter Notebook/Lab inside an already secured environment (i.e., with " +"no token)" + +# 53c63d298efa42cab5d39c3b242d44e0 +#: ../../using/recipes.md:346 +msgid "(Adapted from issue 728)" +msgstr "(Adapted from issue 728)" + +# 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 "" +"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:" + +# 59cd4c1e695f42c09ea911048769f8b7 +#: ../../using/recipes.md:354 +msgid "For jupyterlab:" +msgstr "For jupyterlab:" + +# 49d382c7a9c14ddda58b2e88521dc3bc +#: ../../using/recipes.md:360 +msgid "For jupyter classic:" +msgstr "For jupyter classic:" + +# 297f3ad3d8504a75a0fd5659fa73b67c +#: ../../using/recipes.md:365 +msgid "" +"Enable nbextension spellchecker for markdown (or any other nbextension)" +msgstr "" +"Enable nbextension spellchecker for markdown (or any other nbextension)" + +# e2b10f15c91e4db9b7898a1a191526c7 +#: ../../using/recipes.md:367 +msgid "NB: this works for classic notebooks only" +msgstr "NB: this works for classic notebooks only" + +# 158be3dba029417b832640f01cd22f75 +#: ../../using/recipes.md:380 +msgid "Ref: https://github.com/jupyter/docker-stacks/issues/675" +msgstr "Ref: https://github.com/jupyter/docker-stacks/issues/675" + +# ade5800ecee24c9eb4f16af9585951fc +#: ../../using/running.md:1 +msgid "Running a Container" +msgstr "Running a Container" + +# da480368616a4ffa976061bdc0128763 +# 1b0a0481a9454392a32c005d7513e453 +#: ../../using/running.md:3 ../../using/selecting.md:7 +msgid "Using one of the Jupyter Docker Stacks requires two choices:" +msgstr "Using one of the Jupyter Docker Stacks requires two choices:" + +# d94683d29b6341a98420c4e6adebc4bb +# 436b43aa9da944d281cf51ea731d286a +#: ../../using/running.md:5 ../../using/selecting.md:9 +msgid "Which Docker image you wish to use" +msgstr "Which Docker image you wish to use" + +# de5bb072aa194beebbf587038b36bdcf +# fca43aa36e854a9ab4d2b2816c015847 +#: ../../using/running.md:6 ../../using/selecting.md:10 +msgid "How you wish to start Docker containers from that image" +msgstr "How you wish to start Docker containers from that image" + +# 19634063eb14436daa48af3b1ee3fcc5 +#: ../../using/running.md:8 +msgid "This section provides details about the second." +msgstr "This section provides details about the second." + +# b855cc98da54497fa98956b68d00e840 +#: ../../using/running.md:10 +msgid "Using the Docker CLI" +msgstr "Using the Docker CLI" + +# 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 "" +"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." + +# 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 "" +"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." + +# 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 "" +"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:" + +# 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 "" +"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)." + +# 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 "" +"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." + +# 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 "" +"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." + +# 04e49785faff4511b8576e9d997bea67 +#: ../../using/running.md:85 +msgid "" +"The assigned port and notebook server token are visible using other Docker " +"commands." +msgstr "" +"The assigned port and notebook server token are visible using other Docker " +"commands." + +# 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 "" +"Together, the URL to visit on the host machine to access the server in this " +"case is " +"http://localhost:32769?token=15914ca95f495075c0aa7d0e060f1a78b6d94f70ea373b00." + +# ed09c347d7aa4dd79e505562f4f5efdd +#: ../../using/running.md:101 +msgid "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." +msgstr "" +"The container runs in the background until stopped and/or removed by " +"additional Docker commands." + +# 7fdc11c0394e4af88bb3c3178814d184 +#: ../../using/running.md:113 +msgid "Using Binder" +msgstr "Using Binder" + +# 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 "" +"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." + +# f148f5335f354e549f00dce0cc630475 +#: ../../using/running.md:117 +msgid "Using JupyterHub" +msgstr "Using JupyterHub" + +# 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 "" +"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." + +# bb8d103e20df4ebab2321ae4eee584e7 +#: ../../using/running.md:121 +msgid "Using Other Tools and Services" +msgstr "Using Other Tools and Services" + +# 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 "" +"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." + +# d34ba542e6ed43a7b490cfa65b67d9c3 +#: ../../using/selecting.md:1 +msgid "Selecting an Image" +msgstr "Selecting an Image" + +# 70b39f1dbdb242599b33cd78bbe6a850 +# cb08cf9b24364322a943a40bea1fd39f +#: ../../using/selecting.md:3 ../../using/selecting.md:14 +msgid "Core Stacks" +msgstr "Core Stacks" + +# 7a8f664007004185a07b672d25205ca2 +# 5040afcacc8d4cdeb5bc9b0ed6a06c88 +#: ../../using/selecting.md:4 ../../using/selecting.md:123 +msgid "Image Relationships" +msgstr "Image Relationships" + +# e364abca4ff948f5a6dba4d5685f9fe8 +# ae86feb2ae9c4ed081379460d4a559fb +#: ../../using/selecting.md:5 ../../using/selecting.md:141 +msgid "Community Stacks" +msgstr "Community Stacks" + +# 27b83c7429d142b89e0e425b662e94a9 +#: ../../using/selecting.md:12 +msgid "This section provides details about the first." +msgstr "This section provides details about the first." + +# 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 "" +"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." + +# 6562071d34574731baa6241fc067690c +#: ../../using/selecting.md:18 +msgid "jupyter/base-notebook" +msgstr "jupyter/base-notebook" + +# 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 "Source on GitHub | Dockerfile commit history | Docker Hub image tags" + +# 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 "" +"jupyter/base-notebook is a small image supporting the options common across " +"all core stacks. It is the basis for all other stacks." + +# d869d6c4081e483180f51de5f5e225a7 +#: ../../using/selecting.md:26 +msgid "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" +msgstr "" +"Minimally-functional Jupyter Notebook server (e.g., no pandoc for saving " +"notebooks as PDFs)" + +# d6384943a3394b9d9a5a505e2387d392 +#: ../../using/selecting.md:27 +msgid "Miniconda Python 3.x in /opt/conda" +msgstr "Miniconda Python 3.x in /opt/conda" + +# 031a321f6173495daef86225cd234a72 +#: ../../using/selecting.md:28 +msgid "No preinstalled scientific computing packages" +msgstr "No preinstalled scientific computing packages" + +# 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 "" +"Unprivileged user jovyan (uid=1000, configurable, see options) in group " +"users (gid=100) with ownership over the /home/jovyan and /opt/conda paths" + +# cdd04f4dbb864e82b8b993ccb1670687 +#: ../../using/selecting.md:30 +msgid "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" +msgstr "" +"tini as the container entrypoint and a start-notebook.sh script as the " +"default command" + +# 0e3cf3b3a6e540be861ef295f1808099 +#: ../../using/selecting.md:31 +msgid "" +"A start-singleuser.sh script useful for launching containers in JupyterHub" +msgstr "" +"A start-singleuser.sh script useful for launching containers in JupyterHub" + +# 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 "" +"A start.sh script useful for running alternative commands in the container " +"(e.g. ipython, jupyter kernelgateway, jupyter lab)" + +# 9e8346716bc148fb8df45bce44fa7c38 +#: ../../using/selecting.md:33 +msgid "Options for a self-signed HTTPS certificate and passwordless sudo" +msgstr "Options for a self-signed HTTPS certificate and passwordless sudo" + +# ee56473bbb334a9b96db5870f6be611c +#: ../../using/selecting.md:35 +msgid "jupyter/minimal-notebook" +msgstr "jupyter/minimal-notebook" + +# eec9e5e3162343eba481b73cc223fa49 +#: ../../using/selecting.md:41 +msgid "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." +msgstr "" +"jupyter/minimal-notebook adds command line tools useful when working in " +"Jupyter applications." + +# cf19dcbf0d084508924f166d2b0fa7e3 +#: ../../using/selecting.md:43 +msgid "Everything in jupyter/base-notebook" +msgstr "Everything in jupyter/base-notebook" + +# 52d17abfd2f14628a9937f1b7584582d +#: ../../using/selecting.md:44 +msgid "Pandoc and TeX Live for notebook document conversion" +msgstr "Pandoc and TeX Live for notebook document conversion" + +# b81070edc9c849c184be4687ce17b786 +#: ../../using/selecting.md:45 +msgid "git, emacs, jed, nano, tzdata, and unzip" +msgstr "git, emacs, jed, nano, tzdata, and unzip" + +# aa65fcb5d17649bb88ded23f0880e147 +#: ../../using/selecting.md:47 +msgid "jupyter/r-notebook" +msgstr "jupyter/r-notebook" + +# 54b4b695a8ed493bb79993e62dd164c2 +#: ../../using/selecting.md:53 +msgid "jupyter/r-notebook includes popular packages from the R ecosystem." +msgstr "jupyter/r-notebook includes popular packages from the R ecosystem." + +# d83a0f40bfc34554a0c362f02c656e55 +# c27e75f042064ae0a64447053b46785e +#: ../../using/selecting.md:55 ../../using/selecting.md:69 +msgid "Everything in jupyter/minimal-notebook and its ancestor images" +msgstr "Everything in jupyter/minimal-notebook and its ancestor images" + +# 99e3f1d20553480c81dda15a66369f52 +#: ../../using/selecting.md:56 +msgid "The R interpreter and base environment" +msgstr "The R interpreter and base environment" + +# 34bc2c80ad014b019fb54fc1fad024c4 +# 8c5a996a6b0c4309810071f5194f532a +#: ../../using/selecting.md:57 ../../using/selecting.md:119 +msgid "IRKernel to support R code in Jupyter notebooks" +msgstr "IRKernel to support R code in Jupyter notebooks" + +# a24d121e485e4bd9bbe4df9883a7c148 +#: ../../using/selecting.md:58 +msgid "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, " +"stringr, lubridate, and broom from conda-forge" +msgstr "" +"tidyverse packages, including ggplot2, dplyr, tidyr, readr, purrr, tibble, " +"stringr, lubridate, and broom from conda-forge" + +# d49e405f45dd40a69e64b1636f69381d +#: ../../using/selecting.md:59 +msgid "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13," +" caret, rcurl, and randomforest packages from conda-forge" +msgstr "" +"plyr, devtools, shiny, rmarkdown, forecast, rsqlite, reshape2, nycflights13," +" caret, rcurl, and randomforest packages from conda-forge" + +# 9cfe9452daa04dfc982c2d99948a37eb +#: ../../using/selecting.md:61 +msgid "jupyter/scipy-notebook" +msgstr "jupyter/scipy-notebook" + +# 47f831c00a78451bb75de1467d90d34c +#: ../../using/selecting.md:67 +msgid "" +"jupyter/scipy-notebook includes popular packages from the scientific Python " +"ecosystem." +msgstr "" +"jupyter/scipy-notebook includes popular packages from the scientific Python " +"ecosystem." + +# 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 "" +"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" + +# be048a3494074da99c0f5b98454feda8 +#: ../../using/selecting.md:71 +msgid "ipywidgets for interactive visualizations in Python notebooks" +msgstr "ipywidgets for interactive visualizations in Python notebooks" + +# c3e92433ff5f4702beeaea78d6ee6fd7 +#: ../../using/selecting.md:72 +msgid "Facets for visualizing machine learning datasets" +msgstr "Facets for visualizing machine learning datasets" + +# ff01e76ad1544fb48e024a617ae932b5 +#: ../../using/selecting.md:74 +msgid "jupyter/tensorflow-notebook" +msgstr "jupyter/tensorflow-notebook" + +# bf2f117cf3a047aa8be8cd73f4080455 +#: ../../using/selecting.md:80 +msgid "" +"jupyter/tensorflow-notebook includes popular Python deep learning libraries." +msgstr "" +"jupyter/tensorflow-notebook includes popular Python deep learning libraries." + +# 1fccef5b590549ffb4ea6933eaf12674 +# 1140d31915eb42fc89725521ec90c1dc +#: ../../using/selecting.md:82 ../../using/selecting.md:106 +msgid "Everything in jupyter/scipy-notebook and its ancestor images" +msgstr "Everything in jupyter/scipy-notebook and its ancestor images" + +# 099eb36a6961440b8bea7901b226a96d +#: ../../using/selecting.md:83 +msgid "tensorflow and keras machine learning libraries" +msgstr "tensorflow and keras machine learning libraries" + +# 13413eabaac34b94b4bc5ae28e445dda +#: ../../using/selecting.md:85 +msgid "jupyter/datascience-notebook" +msgstr "jupyter/datascience-notebook" + +# 23244942c9ef4eb8aba10cd558bf5fe9 +#: ../../using/selecting.md:91 +msgid "" +"jupyter/datascience-notebook includes libraries for data analysis from the " +"Julia, Python, and R communities." +msgstr "" +"jupyter/datascience-notebook includes libraries for data analysis from the " +"Julia, Python, and R communities." + +# 7e65863f6a0840729876d3669158c4ce +#: ../../using/selecting.md:93 +msgid "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and " +"their ancestor images" +msgstr "" +"Everything in the jupyter/scipy-notebook and jupyter/r-notebook images, and " +"their ancestor images" + +# 6246f4a0d2454714860e4ffa80aef958 +#: ../../using/selecting.md:94 +msgid "The Julia compiler and base environment" +msgstr "The Julia compiler and base environment" + +# 143e63b9b0a9418a8c93870f6186808e +#: ../../using/selecting.md:95 +msgid "IJulia to support Julia code in Jupyter notebooks" +msgstr "IJulia to support Julia code in Jupyter notebooks" + +# 7a170fe5f6a949cc939d2f40200b3336 +#: ../../using/selecting.md:96 +msgid "HDF5, Gadfly, and RDatasets packages" +msgstr "HDF5, Gadfly, and RDatasets packages" + +# 4b741debc1e84661ab63b8bf0d9c3bbe +#: ../../using/selecting.md:98 +msgid "jupyter/pyspark-notebook" +msgstr "jupyter/pyspark-notebook" + +# 815f62ec44f54dbfaa5a052d15580b94 +#: ../../using/selecting.md:104 +msgid "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." +msgstr "" +"jupyter/pyspark-notebook includes Python support for Apache Spark, " +"optionally on Mesos." + +# 0cb03ee6cd9d488597be17be045f3b74 +#: ../../using/selecting.md:107 +msgid "Apache Spark with Hadoop binaries" +msgstr "Apache Spark with Hadoop binaries" + +# 977ee95d9f664fe2a62505e0a78b1447 +#: ../../using/selecting.md:108 +msgid "Mesos client libraries" +msgstr "Mesos client libraries" + +# 43c0814f5a024a598dd26a4af0212cea +#: ../../using/selecting.md:110 +msgid "jupyter/all-spark-notebook" +msgstr "jupyter/all-spark-notebook" + +# 0c1536b3ff6d40a885e9cdd881dc19bd +#: ../../using/selecting.md:116 +msgid "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache " +"Spark, optionally on Mesos." +msgstr "" +"jupyter/all-spark-notebook includes Python, R, and Scala support for Apache " +"Spark, optionally on Mesos." + +# ecf9548ffc5e4e0eb4bbdf6cb458cf32 +#: ../../using/selecting.md:118 +msgid "Everything in jupyter/pyspark-notebook and its ancestor images" +msgstr "Everything in jupyter/pyspark-notebook and its ancestor images" + +# 5f6081607cab47739c306516cf84a814 +#: ../../using/selecting.md:120 +msgid "" +"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" +msgstr "" +"Apache Toree and spylon-kernel to support Scala code in Jupyter notebooks" + +# a4b50e47f8684dfbbe71e0c3353199dd +#: ../../using/selecting.md:121 +msgid "ggplot2, sparklyr, and rcurl packages" +msgstr "ggplot2, sparklyr, and rcurl packages" + +# 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 "" +"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." + +# df2da8e55aa740a485fd638aa7397b8a +#: ../../using/selecting.md:129 +msgid "Builds" +msgstr "Builds" + +# 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 "" +"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." + +# f4781cd0f2c040458a15b80846026405 +#: ../../using/selecting.md:133 +msgid "Versioning" +msgstr "Versioning" + +# 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 "" +"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." + +# 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 "" +"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)." + +# 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 "" +"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)." + +# 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 "" +"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." + +# f1c9edb79eae4a5f929fdc1e0e2d4366 +#: ../../using/selecting.md:145 +msgid "This list only has 2 examples. You can be the next!" +msgstr "This list only has 2 examples. You can be the next!" + +# 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 "" +"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 ." + +# 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 "" +"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 ." + +# c3720b9d103947499b34ebd19567733f +#: ../../using/selecting.md:151 +msgid "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." +msgstr "" +"See the contributing guide for information about how to create your own " +"Jupyter Docker Stack." + +# b9f784eaaa0a4072929bc51254fa322e +#: ../../using/specifics.md:1 +msgid "Image Specifics" +msgstr "Image Specifics" + +# dfb2958ae819459383ad8c75ba65dd39 +#: ../../using/specifics.md:3 +msgid "" +"This page provides details about features specific to one or more images." +msgstr "" +"This page provides details about features specific to one or more images." + +# 9cfa68a10a3c4eb8b63c435e43bf77fc +#: ../../using/specifics.md:5 +msgid "Apache Spark" +msgstr "Apache Spark" + +# 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 "" +"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." + +# 21d870dca44845948d9ab959f8ccc105 +#: ../../using/specifics.md:9 +msgid "Using Spark Local Mode" +msgstr "Using Spark Local Mode" + +# 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 "" +"Spark local mode is useful for experimentation on small data when you do not" +" have a Spark cluster available." + +# 91033be3c31b48d4a1a6a235491bd897 +# 6cc19049cacb4403989934496ecc4375 +#: ../../using/specifics.md:13 ../../using/specifics.md:71 +msgid "In a Python Notebook" +msgstr "In a Python Notebook" + +# 556a0ebdcab54a87b01f1b8bed45628e +# 823b89e12a514c54b10255bcc2081397 +#: ../../using/specifics.md:24 ../../using/specifics.md:98 +msgid "In a R Notebook" +msgstr "In a R Notebook" + +# a42af3a3c0a44602b15d8d7ed52d267b +# cb0340653342464892f57379cf775ea9 +#: ../../using/specifics.md:36 ../../using/specifics.md:119 +msgid "In a Spylon Kernel Scala Notebook" +msgstr "In a Spylon Kernel Scala Notebook" + +# 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 "" +"Spylon kernel instantiates a SparkContext for you in variable sc after you " +"configure Spark options in a %%init_spark magic cell." + +# 48c05ebdfde54ea6b8794b47171a6c10 +# 66315cf3b7554105bfeaf6a3a5b43b73 +#: ../../using/specifics.md:52 ../../using/specifics.md:134 +msgid "In an Apache Toree Scala Notebook" +msgstr "In an Apache Toree Scala Notebook" + +# 5d8060e95aa941e58a64d0465dbacafa +#: ../../using/specifics.md:54 +msgid "" +"Apache Toree instantiates a local SparkContext for you in variable sc when " +"the kernel starts." +msgstr "" +"Apache Toree instantiates a local SparkContext for you in variable sc when " +"the kernel starts." + +# 1a30fe3a85fa44b1860efb1e8bf123e3 +#: ../../using/specifics.md:61 +msgid "Connecting to a Spark Cluster on Mesos" +msgstr "Connecting to a Spark Cluster on Mesos" + +# 74263d337820458d851a4b869d14f1cf +#: ../../using/specifics.md:63 +msgid "" +"This configuration allows your compute cluster to scale with your data." +msgstr "" +"This configuration allows your compute cluster to scale with your data." + +# c7ca76d01c6e4f10ad8f793b65dc41db +#: ../../using/specifics.md:65 +msgid "Deploy Spark on Mesos." +msgstr "Deploy Spark on Mesos." + +# 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 "" +"Configure each slave with the --no-switch_user flag or create the $NB_USER " +"account on every slave node." + +# 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 "" +"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.)" + +# 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 "" +"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." + +# 46c5b891e7ce4fa78d3c0eeff0e22635 +#: ../../using/specifics.md:69 +msgid "Follow the language specific instructions below." +msgstr "Follow the language specific instructions below." + +# 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 "" +"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." + +# 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 "" +"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:" + +# 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 "" +"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:" + +# e0c67007d0cc4c9da0fb73d5ed25356d +#: ../../using/specifics.md:157 +msgid "Connecting to a Spark Cluster in Standalone Mode" +msgstr "Connecting to a Spark Cluster in Standalone Mode" + +# 6c6f7d3049814b25a3acf211e2587ec2 +#: ../../using/specifics.md:159 +msgid "" +"Connection to Spark Cluster on Standalone Mode requires the following set of" +" steps:" +msgstr "" +"Connection to Spark Cluster on Standalone Mode requires the following set of" +" steps:" + +# 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 "" +"Verify that the docker image (check the Dockerfile) and the Spark Cluster " +"which is being deployed, run the same version of Spark." + +# d6b4329933e24b69879a4621b26bf454 +#: ../../using/specifics.md:162 +msgid "Deploy Spark in Standalone Mode." +msgstr "Deploy Spark in Standalone Mode." + +# 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 "" +"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" + +# 9e271f07799e4cb0a4b79df224a5639f +#: ../../using/specifics.md:167 +msgid "Tensorflow" +msgstr "Tensorflow" + +# 2a525d328e6f419f98d2ed3b99978e25 +#: ../../using/specifics.md:169 +msgid "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." +msgstr "" +"The jupyter/tensorflow-notebook image supports the use of Tensorflow in " +"single machine or distributed mode." + +# 4440ceaa200f4029b5cbaf9c895a8e5c +#: ../../using/specifics.md:171 +msgid "Single Machine Mode" +msgstr "Single Machine Mode" + +# d82de0694427429fa44d9988c1db4851 +#: ../../using/specifics.md:185 +msgid "Distributed Mode" +msgstr "Distributed Mode" diff --git a/requirements-dev.txt b/requirements-dev.txt index 0eb06d64..ccf868ba 100644 --- a/requirements-dev.txt +++ b/requirements-dev.txt @@ -1,5 +1,5 @@ docker pytest -recommonmark==0.4.0 +recommonmark==0.5.0 requests sphinx>=1.6