Merge pull request #844 from parente/transifex

Try RTD+Transifex workflow
2025-10-17 15:02:57 +00:00 · 2019-04-22 09:45:03 -04:00
parent 58e2a02d75 c6bee3951c
commit f646d2b2a3
14 changed files with 3195 additions and 16 deletions
--- a/.travis.yml
+++ b/.travis.yml
@@ -1,12 +1,14 @@
+dist: xenial
 language: python
 python:
-    - 3.6
+    - 3.7
 sudo: required
 services:
    - docker
 install:
+    - pip install --upgrade pip
    - make dev-env
 script:
    - set -e
-    - make test/docs docs
+    - make docs
    - make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1"
--- a/3
+++ b/3
@@ -60,9 +60,6 @@ dev-env: ## install libraries required to build docs and run tests
 docs: ## build HTML documentation
 	make -C docs html

-test/docs: ## check links in Sphinx documentation
-	make -C docs
-
 test/%: ## run tests against a stack
 	@TEST_IMAGE="$(OWNER)/$(notdir $@)" pytest test

--- a/docs/.tx/config
+++ b/docs/.tx/config
@@ -0,0 +1,27 @@
+[main]
+host = https://www.transifex.com
+
+[jupyter-docker-stacks-1.using]
+file_filter = locale/<lang>/LC_MESSAGES/using.po
+source_file = _build/gettext/using.pot
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.maintaining]
+file_filter = locale/<lang>/LC_MESSAGES/maintaining.po
+source_file = _build/gettext/maintaining.pot
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.index]
+file_filter = locale/<lang>/LC_MESSAGES/index.po
+source_file = _build/gettext/index.pot
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.contributing]
+file_filter = locale/<lang>/LC_MESSAGES/contributing.po
+source_file = _build/gettext/contributing.pot
+source_lang = en
+type = PO
+
--- 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
+linkcheck_anchors = False
+
+# -- Translation ----------------------------------------------------------
+
+gettext_uuid = True
+locale_dirs = ['locale/']
--- a/docs/contributing/features.md
+++ b/docs/contributing/features.md
@@ -7,7 +7,7 @@ Thank you for contributing to the Jupyter Docker Stacks! We review pull requests
 Please follow the process below to suggest a new feature for inclusion in one of the core stacks:

 1. [Open a GitHub issue](https://github.com/jupyter/docker-stacks/issues) describing the feature you'd like to contribute.
-2. Discuss with the maintainers whether the addition makes sense in [one of the core stacks](../using/selecting.html#Core-Stacks), as a [recipe in the documentation](recipes.html), as a [community stack](stacks.html), or as something else entirely.
+2. Discuss with the maintainers whether the addition makes sense in [one of the core stacks](../using/selecting.md#Core-Stacks), as a [recipe in the documentation](recipes.md), as a [community stack](stacks.md), or as something else entirely.

 ## Selection Criteria

--- a/docs/contributing/recipes.md
+++ b/docs/contributing/recipes.md
@@ -1,8 +1,8 @@
 # New Recipes

-We welcome contributions of [recipes](../using/recipes.html), short examples of using, configuring, or extending the Docker Stacks, for inclusion in the documentation site. Follow the process below to add a new recipe:
+We welcome contributions of [recipes](../using/recipes.md), short examples of using, configuring, or extending the Docker Stacks, for inclusion in the documentation site. Follow the process below to add a new recipe:

 1. Open the `docs/using/recipes.md` source file.
-2. Add a second-level Markdown heading naming your recipe at the bottom of the file (e.g., `## Add the RISE extension``)
+2. Add a second-level Markdown heading naming your recipe at the bottom of the file (e.g., `## Add the RISE extension`)
 3. Write the body of your recipe under the heading, including whatever command line, Dockerfile, links, etc. you need.
 4. [Submit a pull request](https://github.com/PointCloudLibrary/pcl/wiki/A-step-by-step-guide-on-preparing-and-submitting-a-pull-request) (PR) with your changes. Maintainers will respond and work with you to address any formatting or content issues.
--- a/docs/locale/en/LC_MESSAGES/contributing.po
+++ 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 <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\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."
--- a/docs/locale/en/LC_MESSAGES/index.po
+++ 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 <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\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 <https://mybinder.org/v2/gh/jupyter/docker-"
+"stacks/master?filepath=README.ipynb>`_ by simply clicking the preceding "
+"link. Otherwise, the two examples below may help you get started if you "
+"`have Docker installed <https://docs.docker.com/install/>`_, know "
+":doc:`which Docker image <using/selecting>` 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 <https://mybinder.org/v2/gh/jupyter/docker-"
+"stacks/master?filepath=README.ipynb>`_ by simply clicking the preceding "
+"link. Otherwise, the two examples below may help you get started if you "
+"`have Docker installed <https://docs.docker.com/install/>`_, know "
+":doc:`which Docker image <using/selecting>` 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://<hostname>:8888/?token=<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://<hostname>:8888/?token=<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://<hostname>:10000/?token=<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://<hostname>:10000/?token=<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://<hostname>:10000/?token=<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://<hostname>:10000/?token=<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"
--- a/docs/locale/en/LC_MESSAGES/maintaining.po
+++ 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 <EMAIL@ADDRESS>, 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 <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\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 /<name-of-the-"
+"stack>."
+msgstr ""
+"Update the Build Context in the default build rule to be /<name-of-the-"
+"stack>."
+
+# 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."
--- a/docs/locale/en/LC_MESSAGES/using.po
+++ b/docs/locale/en/LC_MESSAGES/using.po
--- a/docs/using/common.md
+++ b/docs/using/common.md
@@ -75,7 +75,7 @@ In either case, Jupyter Notebook expects the key and certificate to be a base64
 For additional information about using SSL, see the following:

 * The [docker-stacks/examples](https://github.com/jupyter/docker-stacks/tree/master/examples) for information about how to use [Let's Encrypt](https://letsencrypt.org/) certificates when you run these stacks on a publicly visible domain.
-* The [jupyter_notebook_config.py](jupyter_notebook_config.py) file for how this Docker image generates a self-signed certificate.
+* The [jupyter_notebook_config.py](https://github.com/jupyter/docker-stacks/blob/master/base-notebook/jupyter_notebook_config.py) file for how this Docker image generates a self-signed certificate.
 * The [Jupyter Notebook documentation](https://jupyter-notebook.readthedocs.io/en/latest/public_server.html#securing-a-notebook-server) for best practices about securing a public notebook server in general.

 ## Alternative Commands
--- a/docs/using/recipes.md
+++ b/docs/using/recipes.md
@@ -1,6 +1,6 @@
 # Contributed Recipes

-Users sometimes share interesting ways of using the Jupyter Docker Stacks. We encourage users to [contribute these recipes](../contributing/recipes.html) to the documentation in case they prove useful to other members of the community by submitting a pull request to `docs/using/recipes.md`. The sections below capture this knowledge.
+Users sometimes share interesting ways of using the Jupyter Docker Stacks. We encourage users to [contribute these recipes](../contributing/recipes.md) to the documentation in case they prove useful to other members of the community by submitting a pull request to `docs/using/recipes.md`. The sections below capture this knowledge.

 ## Using `pip install` or `conda install` in a Child Docker image

--- a/docs/using/selecting.md
+++ b/docs/using/selecting.md
@@ -21,7 +21,7 @@ The Jupyter team maintains a set of Docker image definitions in the [https://git
 | [Dockerfile commit history](https://github.com/jupyter/docker-stacks/commits/master/base-notebook/Dockerfile)
 | [Docker Hub image tags](https://hub.docker.com/r/jupyter/base-notebook/tags/)

-`jupyter/base-notebook` is a small image supporting the [options common across all core stacks](common.html). It is the basis for all other stacks.
+`jupyter/base-notebook` is a small image supporting the [options common across all core stacks](common.md). It is the basis for all other stacks.

 * Minimally-functional Jupyter Notebook server (e.g., no [pandoc](https://pandoc.org/) for saving notebooks as PDFs)
 * [Miniconda](https://conda.io/miniconda.html) Python 3.x in `/opt/conda`
@@ -148,4 +148,4 @@ The core stacks are just a tiny sample of what's possible when combining Jupyter

 * [education-notebook is a community Jupyter Docker Stack image](https://github.com/umsi-mads/education-notebook). The image includes nbgrader and RISE on top of the datascience-notebook image. Click here to launch it on [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/umsi-mads/education-notebook/master).

-See the [contributing guide](../contributing/stacks.html) for information about how to create your own Jupyter Docker Stack.
+See the [contributing guide](../contributing/stacks.md) for information about how to create your own Jupyter Docker Stack.
--- 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