Merge branch 'master' into issue-861

Resolved conflicts between local branch and updates to the upstream
master.

.travis.yml

+dist: xenial
 language: python
 python:
-    - 3.6
+    - 3.7
 sudo: required
 services:
     - docker
-install:
-    - make dev-env
-script:
-    - set -e
-    - make test/docs docs
-    - make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1"
+
+jobs:
+  include:    
+    - stage: diff-test
+      install:
+      - pip install --upgrade pip
+      - make dev-env
+      script:
+      - set -e
+      - if [ $(make n-docs-diff) -ne 0 ]; then make docs; fi;
+      - if [ $(make n-other-diff) -ne 0 ]; then make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1"; fi;
+    - stage: push-tx
+      install:
+      - pip install --upgrade pip
+      - make dev-env
+      script: 
+      - if [ $(make n-docs-diff DIFF_RANGE=$TRAVIS_COMMIT_RANGE) -ne 0 ]; then make tx-en; fi;
+    - stage: full-test
+      install:
+      - pip install --upgrade pip
+      - make dev-env
+      script:
+      - set -e
+      - make docs
+      - make build-test-all DARGS="--build-arg TEST_ONLY_BUILD=1"
+
+stages:
+    - name: diff-test
+      if: type = pull_request
+    - name: push-tx
+      if: type = push AND branch = master
+    - name: full-test
+      if: type = cron AND branch = master
+
+env:
+  global:
+    secure: JDQKgB1laaenzmEGI9gduwK/iS0030qsl62njJg3jib0R8wxBi2OeetEdoGl9m4NFsqqnp0OO7nm4rzGfuwjL1A38flSlXOTxhjm/hvo3vmnqVu5lDcdk9+IRkafnfd3Dyd86tLxRVETOqZwCLmdNkB2fmQII8du5IIqbJuUGp8DrG7kVMf3NBr9rjkZRfByQrgG4s1NXuT61VvpWMPJAOhcrImuHBheVJDEV0U3n6Xavd7Wo+pAHrHU8exvYTZ1IzZMbHc6K0iC/NpCHcH9+9DAeLDk/q1aDNqbTExnQevOHZzNqgHC2qFOlN4jfy/TLYLpLXtUismneBBqVSK3iZso3Vqy2BRXWgouI+Tt+08ffocy9XPwEzSwkgPgDlFVUikPOy5imwjpDb13RMIyMY4CKlSOdQx2rH2kPkZ0MJJPcki3KGuGl3qRvqyblMn+lZvjAu6WVLZfo7EtcxsQ0ZZxbAbGoUVl27FHg+UvIfC0I3wEcZIp7oED47Q8s0MdCijD3AwkRPvx/iyp3J0A42su7kkOooFcmUItEIqegQJ4Aki1FBv2i5vHmBobClktytZceLsKvzCeLjMpL9HcUVfUaJDKRwtUYIozpYeBnac+E6J1s6glcqLrXIHWez8N6SzokBa6SPqdtODdzzk5OJupByub6CYWsRXvxIQ7/wI=

Makefile

@@ -6,6 +6,7 @@
 SHELL:=bash
 OWNER:=jupyter
 ARCH:=$(shell uname -m)
+DIFF_RANGE?=master...HEAD
 
 # Need to list the images in build dependency order
 ifeq ($(ARCH),ppc64le)
@@ -60,8 +61,27 @@ dev-env: ## install libraries required to build docs and run tests
 docs: ## build HTML documentation
 	make -C docs html
 
-test/docs: ## check links in Sphinx documentation
-	make -C docs
+n-docs-diff: ## number of docs/ files changed since branch from master
+	@git diff --name-only $(DIFF_RANGE) -- docs/ ':!docs/locale' | wc -l | awk '{print $$1}'
+
+
+n-other-diff: ## number of files outside docs/ changed since branch from master
+	@git diff --name-only $(DIFF_RANGE) -- ':!docs/' | wc -l | awk '{print $$1}'
+
+tx-en: ## rebuild en locale strings and push to master (req: GH_TOKEN)
+	@git config --global user.email "travis@travis-ci.org"
+	@git config --global user.name "Travis CI"
+	@git checkout master
+
+	@make -C docs clean gettext
+	@cd docs && sphinx-intl update -p _build/gettext -l en
+
+	@git add docs/locale/en
+	@git commit -m "[ci skip] Update en source strings (build: $$TRAVIS_JOB_NUMBER)"
+
+	@git remote add origin-tx https://$${GH_TOKEN}@github.com/jupyter/docker-stacks.git
+	@git push -u origin-tx master
+
 
 test/%: ## run tests against a stack
 	@TEST_IMAGE="$(OWNER)/$(notdir $@)" pytest test

base-notebook/Dockerfile

@@ -79,6 +79,7 @@ RUN cd /tmp && \
     $CONDA_DIR/bin/conda config --system --set show_channel_urls true && \
     $CONDA_DIR/bin/conda install --quiet --yes conda="${CONDA_VERSION%.*}.*" && \
     $CONDA_DIR/bin/conda update --all --quiet --yes && \
+    conda list python | grep '^python ' | tr -s ' ' | cut -d '.' -f 1,2 | sed 's/$/.*/' >> $CONDA_DIR/conda-meta/pinned && \
     conda clean --all -f -y && \
     rm -rf /home/$NB_USER/.cache/yarn && \
     fix-permissions $CONDA_DIR && \
@@ -100,7 +101,7 @@ RUN conda install --quiet --yes 'tini=0.18.0' && \
 RUN conda install --quiet --yes \
     'notebook=5.7.8' \
     'jupyterhub=0.9.6' \
-    'jupyterlab=0.35.4' && \
+    'jupyterlab=0.35.5' && \
     conda clean --all -f -y && \
     jupyter labextension install @jupyterlab/hub-extension@^0.12.0 && \
     npm cache clean --force && \

base-notebook/hooks/post_checkout

+#!/bin/bash
+if [[ "$COMMIT_MSG" = *"skip ci"* || "$COMMIT_MSG" = *"ci skip"* ]]; then
+    exit 1;
+fi
\ No newline at end of file

docs/.tx/config

+[main]
+host = https://www.transifex.com
+
+[jupyter-docker-stacks-1.using-po--master]
+file_filter = locale/<lang>/LC_MESSAGES/using.po
+source_file = locale/en/LC_MESSAGES/using.po
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.maintaining-po--master]
+file_filter = locale/<lang>/LC_MESSAGES/maintaining.po
+source_file = locale/en/LC_MESSAGES/maintaining.po
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.index-po--master]
+file_filter = locale/<lang>/LC_MESSAGES/index.po
+source_file = locale/en/LC_MESSAGES/index.po
+source_lang = en
+type = PO
+
+[jupyter-docker-stacks-1.contributing-po--master]
+file_filter = locale/<lang>/LC_MESSAGES/contributing.po
+source_file = locale/en/LC_MESSAGES/contributing.po
+source_lang = en
+type = PO
+

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
\ No newline at end of file
+
+# -- Translation ----------------------------------------------------------
+
+gettext_uuid = True
+locale_dirs = ['locale/']
\ No newline at end of file

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
 

docs/contributing/recipes.md

 # 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.

docs/contributing/tests.md

@@ -4,7 +4,7 @@ We greatly appreciate pull requests that extend the automated tests that vet the
 
 ## How the Tests Work
 
-Travis executes `make build-test-all` against every pull request submitted to the `jupyter/docker-stacks` repository. The `make` command builds every docker image. After building each image, the `make` command executes `pytest` to run both image-specific tests like those in [base-notebook/test/](https://github.com/jupyter/docker-stacks/tree/master/base-notebook/test) and common tests defined in [test/](https://github.com/jupyter/docker-stacks/tree/master/test). Both kinds of tests make use of global [pytest fixtures](https://docs.pytest.org/en/latest/fixture.html) defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/master/conftest.py) file at the root of the projects.
+Travis executes `make build-test-all` against pull requests submitted to the `jupyter/docker-stacks` repository. This `make` command builds every docker image. After building each image, the `make` command executes `pytest` to run both image-specific tests like those in [base-notebook/test/](https://github.com/jupyter/docker-stacks/tree/master/base-notebook/test) and common tests defined in [test/](https://github.com/jupyter/docker-stacks/tree/master/test). Both kinds of tests make use of global [pytest fixtures](https://docs.pytest.org/en/latest/fixture.html) defined in the [conftest.py](https://github.com/jupyter/docker-stacks/blob/master/conftest.py) file at the root of the projects.
 
 ## Contributing New Tests
 

docs/contributing/translations.md

+# Doc Translations
+
+We are delighted when members of the Jupyter community want to help translate these documentation pages to other languages. If you're interested, please visit links below below to join our team on [Transifex](https://transifex.com) and to start creating, reviewing, and updating translations of the Jupyter Docker Stacks documentation.
+
+1. Follow the steps documented on the [Getting Started as a Translator](https://docs.transifex.com/getting-started-1/translators) page.
+2. Look for *jupyter-docker-stacks* when prompted to choose a translation team. Alternatively, visit https://www.transifex.com/project-jupyter/jupyter-docker-stacks-1 after creating your account and request to join the project.
+3. See [Translating with the Web Editor](https://docs.transifex.com/translation/translating-with-the-web-editor) in the Transifex documentation.
\ No newline at end of file

docs/index.rst

@@ -43,9 +43,10 @@ Table of Contents
    :maxdepth: 2
    :caption: Contributor Guide
 
-   contributing/issues 
+   contributing/issues
    contributing/packages
    contributing/recipes
+   contributing/translations
    contributing/tests
    contributing/features
    contributing/stacks

docs/locale/en/LC_MESSAGES/index.po

+# 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>, 2019.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: docker-stacks latest\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-05-05 19:53-0400\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <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"
+"Generated-By: Babel 2.6.0\n"
+
+# 22f1bd46933144e092bf92e3af4c6f4f
+#: ../../index.rst:32
+msgid "User Guide"
+msgstr ""
+
+# f35d75046f8c42ae8cab58d826154823
+#: ../../index.rst:42
+msgid "Contributor Guide"
+msgstr ""
+
+# a737afe726cd49c4986d75b7d74eeed3
+#: ../../index.rst:54
+msgid "Maintainer Guide"
+msgstr ""
+
+# 9cd216fa91ef40bbb957373faaf93732
+#: ../../index.rst:60
+msgid "Getting Help"
+msgstr ""
+
+# a0aa0bcd999c4c5e96cc57fd77780f96
+#: ../../index.rst:2
+msgid "Jupyter Docker Stacks"
+msgstr ""
+
+# 5d06f458dc524214b2c97e865dd2dc81
+#: ../../index.rst:4
+msgid ""
+"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
+"Jupyter applications and interactive computing tools. You can use a stack"
+" image to do any of the following (and more):"
+msgstr ""
+
+# c69f151c806e4cdf9bebda05b06c760e
+#: ../../index.rst:6
+msgid "Start a personal Jupyter Notebook server in a local Docker container"
+msgstr ""
+
+# b26271409ab743b2a349b3a8ca95233e
+#: ../../index.rst:7
+msgid "Run JupyterLab servers for a team using JupyterHub"
+msgstr ""
+
+# 4d60f4325fff4ffcad12703a4b9d6781
+#: ../../index.rst:8
+msgid "Write your own project Dockerfile"
+msgstr ""
+
+# 78b0d31eb6e9462888eef92e6a84cdb7
+#: ../../index.rst:11
+msgid "Quick Start"
+msgstr ""
+
+# d4c0e237dbe74e0d9afbf2b2f0e219c8
+#: ../../index.rst:13
+msgid ""
+"You can try a `recent build of the jupyter/base-notebook image on "
+"mybinder.org <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 ""
+
+# 051ed23ef62e41058a7c889604f96035
+#: ../../index.rst:15
+msgid ""
+"The other pages in this documentation describe additional uses and "
+"features in detail."
+msgstr ""
+
+# e91f3b62a1b54166b966be6d7a4f061e
+#: ../../index.rst:17
+msgid ""
+"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
+"tagged ``17aba6048f44`` from Docker Hub if it is not already present on "
+"the local host. It then starts a container running a Jupyter Notebook "
+"server and exposes the server on host port 8888. The server logs appear "
+"in the terminal. Visiting ``http://<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 ""
+
+# e04140e6cd8442f7a6f347d88224f591
+#: ../../index.rst:21
+msgid ""
+"**Example 2:** This command performs the same operations as **Example "
+"1**, but it exposes the server on host port 10000 instead of port 8888. "
+"Visiting ``http://<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 ""
+
+# 1c3229680cf44a5bb2d8450602bfcf7d
+#: ../../index.rst:25
+msgid ""
+"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` "
+"image tagged ``9b06df75e445`` from Docker Hub if it is not already "
+"present on the local host. It then starts an *ephemeral* container "
+"running a Jupyter Notebook server and exposes the server on host port "
+"10000. The command mounts the current working directory on the host as "
+"``/home/jovyan/work`` in the container. The server logs appear in the "
+"terminal. Visiting ``http://<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 ""
+
+# 3ac1a41d185844b1b43315a4cc74efc8
+#: ../../index.rst:30
+msgid "Table of Contents"
+msgstr ""
+

docs/locale/it/LC_MESSAGES/index.po

+# 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.
+# 
+# Translators:
+# Nicola Landolfi <ncl.lnd769@gmail.com>, 2019
+# 
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: docker-stacks latest\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-04-21 17:25-0400\n"
+"PO-Revision-Date: 2019-04-22 13:45+0000\n"
+"Last-Translator: Nicola Landolfi <ncl.lnd769@gmail.com>, 2019\n"
+"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: it\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+# 85291a2c92d440a089cf156fba58b86a
+#: ../../index.rst:32 ../../index.rst:32
+msgid "User Guide"
+msgstr "Guida Utente"
+
+# e4a3fd32059d4486b6b0f3a6fb5065b5
+#: ../../index.rst:42 ../../index.rst:42
+msgid "Contributor Guide"
+msgstr "Come contribuire"
+
+# 45de48c8617d4ebe83b7ff7141295836
+#: ../../index.rst:53 ../../index.rst:53
+msgid "Maintainer Guide"
+msgstr "Guida per i Maintainer"
+
+# aa99c4562d8d4cb3abfea375470e8af3
+#: ../../index.rst:59 ../../index.rst:59
+msgid "Getting Help"
+msgstr "Assistenza"
+
+# 76df09037a6147c8a85be8ef14c15532
+#: ../../index.rst:2
+msgid "Jupyter Docker Stacks"
+msgstr "Jupyter Docker Stacks"
+
+# b3fb253184e64174b26a2da73f221cc1
+#: ../../index.rst:4
+msgid ""
+"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
+"Jupyter applications and interactive computing tools. You can use a stack "
+"image to do any of the following (and more):"
+msgstr ""
+"Jupyter Docker Stacks consiste in una collezione di immagini Docker pronte "
+"all'uso, contenenti applicazioni Jupyter e strumenti per l'interactive "
+"computing. Esse permettono di (e non solo):"
+
+# 8cd55fb113a049e7be445b21084df7ea
+#: ../../index.rst:6
+msgid "Start a personal Jupyter Notebook server in a local Docker container"
+msgstr ""
+"Avviare un server personale Jupyter Notebook all'interno di un container "
+"Docker in locale"
+
+# 285fa13bed8547b4af0cfc480adf4861
+#: ../../index.rst:7
+msgid "Run JupyterLab servers for a team using JupyterHub"
+msgstr "Configurare un server JupyterLab da utilizzare con JupyterHub"
+
+# a49d31cedd4946ea98d7a4c720340d84
+#: ../../index.rst:8
+msgid "Write your own project Dockerfile"
+msgstr "Creare Dockerfile personalizzati"
+
+# 0aff0df2e46a44b4bc8070545e83c42c
+#: ../../index.rst:11
+msgid "Quick Start"
+msgstr "Per iniziare"
+
+# 3262accd283140058db73005072be200
+#: ../../index.rst:13
+msgid ""
+"You can try a `recent build of the jupyter/base-notebook image on "
+"mybinder.org <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 ""
+"Potete provare `una build recente dell'immagine jupyter/base-notebook su "
+"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
+"stacks/master?filepath=README.ipynb>`_ cliccando sul link precedente. "
+"Oppure, i due esempi in basso potrebbero aiutarvi a muovere i primi passi se"
+" `avete installato Docker <https://docs.docker.com/install/>`_, avete scelto"
+" :doc:` l'immagine da utilizzare <using/selecting>` e volete lanciare un "
+"solo server Jupyter Notebook in un container."
+
+# 9e4094e8de264e20bca0af8f6cf888b7
+#: ../../index.rst:15
+msgid ""
+"The other pages in this documentation describe additional uses and features "
+"in detail."
+msgstr ""
+"Le altre pagine di questa documentazione descrivono nel dettaglio le varie "
+"funzionalità ed ulteriori casi d'uso."
+
+# 8b75310f2eaa4aac95d9387e0a4db9e8
+#: ../../index.rst:17
+msgid ""
+"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
+"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
+"local host. It then starts a container running a Jupyter Notebook server and"
+" exposes the server on host port 8888. The server logs appear in the "
+"terminal. Visiting ``http://<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 ""
+"**Esempio 1:** Questo comando esegue il pull dell'immagine ``jupyter/scipy-"
+"notebook`` avente tag ``17aba6048f44`` da Docker Hub se non dovesse essere "
+"già presente sull'host locale. Poi avvia un container con un server Jupyter "
+"Notebook in ascolto sulla porta 8888 dell'host. I log del server compaiono "
+"nel terminale. All'indirizzo ``http://<hostname>:8888/?token=<token>`` è "
+"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del "
+"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato "
+"sul terminale. L'uscita dal server del notebook lascia intatto il container:"
+
+# 9e0229c99f404aceb7e517387ae88365
+#: ../../index.rst:21
+msgid ""
+"**Example 2:** This command performs the same operations as **Example 1**, "
+"but it exposes the server on host port 10000 instead of port 8888. Visiting "
+"``http://<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 ""
+"**Esempio 2:** Questo comando esegue le stesse operazioni dell'**Esempio "
+"1**, ma mette in ascolto il server sulla porta 10000 anziché 8888:"
+
+# 02c25d3f0abe48348100dd878c243a75
+#: ../../index.rst:25
+msgid ""
+"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image"
+" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the"
+" local host. It then starts an *ephemeral* container running a Jupyter "
+"Notebook server and exposes the server on host port 10000. The command "
+"mounts the current working directory on the host as ``/home/jovyan/work`` in"
+" the container. The server logs appear in the terminal. Visiting "
+"``http://<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 ""
+"**Esempio 3:** Questo comando esegue il pull dell'immagine ``jupyter"
+"/datascience-notebook`` avente tag ``9b06df75e445`` da Docker Hub se non "
+"dovesse essere già presente sull'host locale. Poi avvia un container "
+"*effimero* con un server Jupyter Notebook in ascolto sulla porta 10000. "
+"Inoltre, il comando monta la directory di lavoro corrente dell'host come "
+"``/home/jovyan/work`` all'interno del container. I log del server compaiono "
+"nel terminale. All'indirizzo ``http://<hostname>:10000/?token=<token>`` è "
+"presente la dashboard di Jupyter Notebook. ``hostname`` indica il nome del "
+"computer dove Docker è avviato mentre ``token`` è il token segreto mostrato "
+"sul terminale. Docker distrugge il container all'uscita del server del "
+"notebook, tuttavia i file salvati in ``~/work`` all'interno del container "
+"restano inalterati sull'host:"
+
+# 1bc0c7d54cd343d689362047c0b00122
+#: ../../index.rst:30
+msgid "Table of Contents"
+msgstr "Indice"

docs/locale/it/LC_MESSAGES/maintaining.po

+# 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: 2019-04-22 13:45+0000\n"
+"Language-Team: Italian (https://www.transifex.com/project-jupyter/teams/97886/it/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: it\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+# cefae71d9a804ab69c7e9f0a53eb7475
+#: ../../maintaining/tasks.md:1
+msgid "Maintainer Playbook"
+msgstr ""
+
+# af6a24b053794e55bddfe6e2e21ae74f
+#: ../../maintaining/tasks.md:3
+msgid "Merging Pull Requests"
+msgstr ""
+
+# c34b1d3b543346689adbca91331ac048
+#: ../../maintaining/tasks.md:5
+msgid ""
+"To build new images on Docker Cloud and publish them to the Docker Hub "
+"registry, do the following:"
+msgstr ""
+
+# 1597bb99448f41b994d1c7073b9c8721
+#: ../../maintaining/tasks.md:7
+msgid "Make sure Travis is green for a PR."
+msgstr ""
+
+# 401ed2733771440e8ef089f54cf2984d
+#: ../../maintaining/tasks.md:8
+msgid "Merge the PR."
+msgstr ""
+
+# 6d0bf2e7538640a0989e56df3c9d1106
+#: ../../maintaining/tasks.md:9
+msgid ""
+"Monitor the Docker Cloud build status for each of the stacks, starting with "
+"jupyter/base-notebook and ending with jupyter/all-spark-notebook. See the "
+"stack hierarchy diagram for the current, complete build order."
+msgstr ""
+
+# 428124fa830d4c74a618d7b3c696599c
+#: ../../maintaining/tasks.md:10
+msgid ""
+"Manually click the retry button next to any build that fails to resume that "
+"build and any dependent builds."
+msgstr ""
+
+# c4034a02dab8435f8d76c2d32321a262
+#: ../../maintaining/tasks.md:11
+msgid ""
+"Try to avoid merging another PR to master until all outstanding builds "
+"complete. There's no way at present to propagate the git SHA to build "
+"through the Docker Cloud build trigger API. Every build trigger works off of"
+" master HEAD."
+msgstr ""
+
+# 62ddd25e15064cea950f9f13a663dcdb
+#: ../../maintaining/tasks.md:13
+msgid "Updating the Ubuntu Base Image"
+msgstr ""
+
+# 091b1ce707f44bc6ae9742cf55b92ebf
+#: ../../maintaining/tasks.md:15
+msgid ""
+"When there's a security fix in the Ubuntu base image or after some time "
+"passes, it's a good idea to update the pinned SHA in the jupyter/base-"
+"notebook Dockerfile. Submit it as a regular PR and go through the build "
+"process. Expect the build to take a while to complete: every image layer "
+"will rebuild."
+msgstr ""
+
+# d834495e774a4fee952324e4cc5ab514
+#: ../../maintaining/tasks.md:17
+msgid "Adding a New Core Image to Docker Cloud"
+msgstr ""
+
+# b765140c2d1446849b747351532d6290
+#: ../../maintaining/tasks.md:19
+msgid ""
+"When there's a new stack definition, do the following before merging the PR "
+"with the new stack:"
+msgstr ""
+
+# b7b25a83cd3246bd886926722c30ac1a
+#: ../../maintaining/tasks.md:21
+msgid ""
+"Ensure the PR includes an update to the stack overview diagram in the "
+"documentation. The image links to the blockdiag source used to create it."
+msgstr ""
+
+# 50edc8e02aa9497d81dc312eafe5d2bf
+#: ../../maintaining/tasks.md:22
+msgid ""
+"Ensure the PR updates the Makefile which is used to build the stacks in "
+"order on Travis CI."
+msgstr ""
+
+# fabcb32a80a04a639aebd8b55d38119e
+#: ../../maintaining/tasks.md:23
+msgid ""
+"Create a new repository in the jupyter org on Docker Cloud named after the "
+"stack folder in the git repo."
+msgstr ""
+
+# 1811dcec60e3433d94514eaeebecb44b
+#: ../../maintaining/tasks.md:24
+msgid "Grant the stacks team permission to write to the repo."
+msgstr ""
+
+# afa7b1fcb0224380a111fe94f7781d60
+#: ../../maintaining/tasks.md:25
+msgid "Click Builds and then Configure Automated Builds for the repository."
+msgstr ""
+
+# 35b969b9f7a442d99f54a73494033d90
+#: ../../maintaining/tasks.md:26
+msgid "Select jupyter/docker-stacks as the source repository."
+msgstr ""
+
+# fe715af4446d409cb4d5ee81255bd86e
+#: ../../maintaining/tasks.md:27
+msgid ""
+"Choose Build on Docker Cloud's infrastructure using a Small node unless you "
+"have reason to believe a bigger host is required."
+msgstr ""
+
+# dc41895431b64657b5e24a8c96779ca6
+#: ../../maintaining/tasks.md:28
+msgid ""
+"Update the Build Context in the default build rule to be /<name-of-the-"
+"stack>."
+msgstr ""
+
+# e4d220bf1cb54781bc03f16a17ddafb8
+#: ../../maintaining/tasks.md:29
+msgid ""
+"Toggle Autobuild to disabled unless the stack is a new root stack (e.g., "
+"like jupyter/base-notebook)."
+msgstr ""
+
+# c5a459d038714ff78d4f156ee227d9ca
+#: ../../maintaining/tasks.md:30
+msgid ""
+"If the new stack depends on the build of another stack in the hierarchy:"
+msgstr ""
+
+# 611376c2ec6942479f60129177d312cc
+#: ../../maintaining/tasks.md:31
+msgid "Hit Save and then click Configure Automated Builds."
+msgstr ""
+
+# 81cc56c63891432d89d4df3001f1bcde
+#: ../../maintaining/tasks.md:32
+msgid "At the very bottom, add a build trigger named Stack hierarchy trigger."
+msgstr ""
+
+# 9e55682a966a422c846a3463c7a30cfe
+#: ../../maintaining/tasks.md:33
+msgid "Copy the build trigger URL."
+msgstr ""
+
+# a9d853a1d45b4ead965813822a96c934
+#: ../../maintaining/tasks.md:34
+msgid ""
+"Visit the parent repository Builds page and click Configure Automated "
+"Builds."
+msgstr ""
+
+# 327d4522c3884247871aa406bbe19402
+#: ../../maintaining/tasks.md:35
+msgid ""
+"Add the URL you copied to the NEXT_BUILD_TRIGGERS environment variable comma"
+" separated list of URLs, creating that environment variable if it does not "
+"already exist."
+msgstr ""
+
+# 1aa0e4b95ab847e0be8ac9647433c991
+# 7dfff62380a041968ee6e739b1ca271f
+#: ../../maintaining/tasks.md:36 ../../maintaining/tasks.md:40
+msgid "Hit Save."
+msgstr ""
+
+# 8315ed043efb40238227f8be0ad61b52
+#: ../../maintaining/tasks.md:37
+msgid "If the new stack should trigger other dependent builds:"
+msgstr ""
+
+# 6e0e15d05a544476b91794d10b8732ff
+#: ../../maintaining/tasks.md:38
+msgid "Add an environment variable named NEXT_BUILD_TRIGGERS."
+msgstr ""
+
+# 9dc2029e6360433ab7181187f7040d48
+#: ../../maintaining/tasks.md:39
+msgid ""
+"Copy the build trigger URLs from the dependent builds into the "
+"NEXT_BUILD_TRIGGERS comma separated list of URLs."
+msgstr ""
+
+# 89165b279d9142e9b8e5d7a923fca2be
+#: ../../maintaining/tasks.md:41
+msgid ""
+"Adjust other NEXT_BUILD_TRIGGERS values as needed so that the build order "
+"matches that in the stack hierarchy diagram."
+msgstr ""
+
+# 51c8151943794bc8b1d51d65ccd84736
+#: ../../maintaining/tasks.md:43
+msgid "Adding a New Maintainer Account"
+msgstr ""
+
+# 1994c19e7a734b2cad9af0afcd7da31e
+#: ../../maintaining/tasks.md:45
+msgid "Visit https://cloud.docker.com/app/jupyter/team/stacks/users"
+msgstr ""
+
+# 390ccdde528146bbbc3d2f62717a647c
+#: ../../maintaining/tasks.md:46
+msgid "Add the maintainer's Docker Cloud username."
+msgstr ""
+
+# b0227c37244c4b82848cc2655f134d21
+#: ../../maintaining/tasks.md:47
+msgid ""
+"Visit https://github.com/orgs/jupyter/teams/docker-image-maintainers/members"
+msgstr ""
+
+# b0fdbdd14b1444d1b696d8367aa111fb
+#: ../../maintaining/tasks.md:48
+msgid "Add the maintainer's GitHub username."
+msgstr ""
+
+# abe2cb04fcb9447496bf3bc9fb230cdc
+#: ../../maintaining/tasks.md:50
+msgid "Pushing a Build Manually"
+msgstr ""
+
+# 3ef85ec6ea0a4a84aecc2bc7e7a5a5fd
+#: ../../maintaining/tasks.md:52
+msgid ""
+"If automated builds on Docker Cloud have got you down, do the following to "
+"push a build manually:"
+msgstr ""
+
+# 3ebef623fa2f46f49ef639ad17105d4a
+#: ../../maintaining/tasks.md:54
+msgid "Clone this repository."
+msgstr ""
+
+# dcf8e9e8c72e40b9aa23c090311d6ea2
+#: ../../maintaining/tasks.md:55
+msgid "Check out the git SHA you want to build and publish."
+msgstr ""
+
+# fe788ad30f694b1f9b013cabfa820343
+#: ../../maintaining/tasks.md:56
+msgid "docker login with your Docker Hub/Cloud credentials."
+msgstr ""
+
+# 649dc474ffaa483eb625ed8061cb0097
+#: ../../maintaining/tasks.md:57
+msgid "Run make retry/release-all."
+msgstr ""

docs/locale/pt_BR/LC_MESSAGES/index.po

+# 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.
+# 
+# Translators:
+# Allan Neri Fernandes da Silva <allan.nerifs@gmail.com>, 2019
+# 
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: docker-stacks latest\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-04-21 17:25-0400\n"
+"PO-Revision-Date: 2019-04-22 13:45+0000\n"
+"Last-Translator: Allan Neri Fernandes da Silva <allan.nerifs@gmail.com>, 2019\n"
+"Language-Team: Portuguese (Brazil) (https://www.transifex.com/project-jupyter/teams/97886/pt_BR/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: pt_BR\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+# 85291a2c92d440a089cf156fba58b86a
+#: ../../index.rst:32 ../../index.rst:32
+msgid "User Guide"
+msgstr "Guia de uso"
+
+# e4a3fd32059d4486b6b0f3a6fb5065b5
+#: ../../index.rst:42 ../../index.rst:42
+msgid "Contributor Guide"
+msgstr "Guia de contribuição"
+
+# 45de48c8617d4ebe83b7ff7141295836
+#: ../../index.rst:53 ../../index.rst:53
+msgid "Maintainer Guide"
+msgstr "Guia de manutenção"
+
+# aa99c4562d8d4cb3abfea375470e8af3
+#: ../../index.rst:59 ../../index.rst:59
+msgid "Getting Help"
+msgstr "Obtendo ajuda"
+
+# 76df09037a6147c8a85be8ef14c15532
+#: ../../index.rst:2
+msgid "Jupyter Docker Stacks"
+msgstr "Jupyter Docker Stacks"
+
+# b3fb253184e64174b26a2da73f221cc1
+#: ../../index.rst:4
+msgid ""
+"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
+"Jupyter applications and interactive computing tools. You can use a stack "
+"image to do any of the following (and more):"
+msgstr ""
+"Jupyter Docker Stacks são um conjunto de imagens Docker prontas para uso "
+"contendo aplicações Jupyter e ferramentas interativas. Você pode usar uma "
+"pilha de imagens para fazer qualquer uma dessas coisas (e muito mais):"
+
+# 8cd55fb113a049e7be445b21084df7ea
+#: ../../index.rst:6
+msgid "Start a personal Jupyter Notebook server in a local Docker container"
+msgstr "Rodar um servidor Jupyter Notebook em um container Docker local"
+
+# 285fa13bed8547b4af0cfc480adf4861
+#: ../../index.rst:7
+msgid "Run JupyterLab servers for a team using JupyterHub"
+msgstr "Rode um servidor JupyterLab para uma equipe usando JupyterHub"
+
+# a49d31cedd4946ea98d7a4c720340d84
+#: ../../index.rst:8
+msgid "Write your own project Dockerfile"
+msgstr "Escrever seu próprio Dockerfile"
+
+# 0aff0df2e46a44b4bc8070545e83c42c
+#: ../../index.rst:11
+msgid "Quick Start"
+msgstr "Guia rápido"
+
+# 3262accd283140058db73005072be200
+#: ../../index.rst:13
+msgid ""
+"You can try a `recent build of the jupyter/base-notebook image on "
+"mybinder.org <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 ""
+"Você pode tentar  um `build recente da imagem do jupyter/base-notebook em "
+"mybinder.org <https://mybinder.org/v2/gh/jupyter/docker-"
+"stacks/master?filepath=README.ipynb>`_ simplesmente clicando neste link. "
+"Caso contrário, os dois exemplos abaixo podem te ajudar a começar se você "
+"`já tem o Docker instalado  <https://docs.docker.com/install/>`_ , sabe "
+":doc:`qual imagem <using/selecting>` usar, e quer iniciar um servidor "
+"Jupyter Notebook em um contêiner."
+
+# 9e4094e8de264e20bca0af8f6cf888b7
+#: ../../index.rst:15
+msgid ""
+"The other pages in this documentation describe additional uses and features "
+"in detail."
+msgstr ""
+"As próximas paginas desta documentação descrevem os usos e as "
+"funcionalidades adicionais com mais detalhes"
+
+# 8b75310f2eaa4aac95d9387e0a4db9e8
+#: ../../index.rst:17
+msgid ""
+"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
+"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
+"local host. It then starts a container running a Jupyter Notebook server and"
+" exposes the server on host port 8888. The server logs appear in the "
+"terminal. Visiting ``http://<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 ""
+"**Exemplo 1:** Este comando faz um pull da imagem ``jupyter/scipy-notebook``"
+" com a tag ``17aba6048f44`` do Docker Hub se ela ainda não estiver em sua "
+"maquina local. Em seguida inicia um contêiner executando um servidor Jupyter"
+" Notebook e expondo a porta 8888 do host. Os logs do servidor aparecem no "
+"terminal. Acessando o endereço ``http://<hostname>:8888/?token=<token>`` "
+"através de um navegador carregará o painel de controle do Jupyter Notebook, "
+"onde ``hostname`` é o nome do computador executando o docker e ``token`` é o"
+" token secreto exibido no console. O contêiner permanece intacto para "
+"reinicialização após o termino do servidor.::"
+
+# 9e0229c99f404aceb7e517387ae88365
+#: ../../index.rst:21
+msgid ""
+"**Example 2:** This command performs the same operations as **Example 1**, "
+"but it exposes the server on host port 10000 instead of port 8888. Visiting "
+"``http://<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 ""
+"**Exemplo 2:** Este comando faz as mesma coisas do **Exemplo 1**, mas expõe "
+"a porta 10000 do host em vez da 8888. Acessando o endereço "
+"``http://<hostname>:10000/?token=<token>`` através de um navegador carregará"
+" o JupyterLab, onde ``hostname`` é o nome do computador executando o docker "
+"e ``token`` é o token secreto exibido no console.::"
+
+# 02c25d3f0abe48348100dd878c243a75
+#: ../../index.rst:25
+msgid ""
+"**Example 3:** This command pulls the ``jupyter/datascience-notebook`` image"
+" tagged ``9b06df75e445`` from Docker Hub if it is not already present on the"
+" local host. It then starts an *ephemeral* container running a Jupyter "
+"Notebook server and exposes the server on host port 10000. The command "
+"mounts the current working directory on the host as ``/home/jovyan/work`` in"
+" the container. The server logs appear in the terminal. Visiting "
+"``http://<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 ""
+"**Exemplo 3:** Este comando faz um pull da imagem ``jupyter/datascience-"
+"notebook`` com a tag ``9b06df75e445`` do Docker Hub se ela ainda não estiver"
+" em sua maquina local. Em seguida inicia um contêiner *passageiro* rodando "
+"um servidor Jupyter Notebook expondo no host a porta 10000 do servidor. O "
+"comando associa o diretório atual do host com o diretório "
+"``/home/jovyan/work`` do contêiner. Os logs do servidor aparecem no "
+"terminal. Acessando o endereço ``http://<hostname>:10000/?token=<token>`` "
+"através de um navegador carregará o JupyterLab, onde ``hostname`` é o nome "
+"do computador executando o docker e ``token`` é o token secreto exibido no "
+"console. O Docker destrói o contêiner depois que o servidor for finalizado, "
+"mas os arquivos escritos em ``~work`` do contêiner permanecem intactos no "
+"host.::"
+
+# 1bc0c7d54cd343d689362047c0b00122
+#: ../../index.rst:30
+msgid "Table of Contents"
+msgstr "Índice"

docs/locale/zh/LC_MESSAGES/index.po

+# 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.
+# 
+# Translators:
+# Micky Chan <chanmickyyun@gmail.com>, 2019
+# 
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: docker-stacks latest\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2019-04-21 17:25-0400\n"
+"PO-Revision-Date: 2019-04-22 13:45+0000\n"
+"Last-Translator: Micky Chan <chanmickyyun@gmail.com>, 2019\n"
+"Language-Team: Chinese (https://www.transifex.com/project-jupyter/teams/97886/zh/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: zh\n"
+"Plural-Forms: nplurals=1; plural=0;\n"
+
+# 85291a2c92d440a089cf156fba58b86a
+#: ../../index.rst:32 ../../index.rst:32
+msgid "User Guide"
+msgstr "用户指南"
+
+# e4a3fd32059d4486b6b0f3a6fb5065b5
+#: ../../index.rst:42 ../../index.rst:42
+msgid "Contributor Guide"
+msgstr "贡献者指南"
+
+# 45de48c8617d4ebe83b7ff7141295836
+#: ../../index.rst:53 ../../index.rst:53
+msgid "Maintainer Guide"
+msgstr "维护者指南"
+
+# aa99c4562d8d4cb3abfea375470e8af3
+#: ../../index.rst:59 ../../index.rst:59
+msgid "Getting Help"
+msgstr "获取帮助"
+
+# 76df09037a6147c8a85be8ef14c15532
+#: ../../index.rst:2
+msgid "Jupyter Docker Stacks"
+msgstr "Jupyter Docker Stacks"
+
+# b3fb253184e64174b26a2da73f221cc1
+#: ../../index.rst:4
+msgid ""
+"Jupyter Docker Stacks are a set of ready-to-run Docker images containing "
+"Jupyter applications and interactive computing tools. You can use a stack "
+"image to do any of the following (and more):"
+msgstr ""
+"Jupyter Docker Stacks是一组Docker镜像包含Jupyter应用程序和交互式计算工具。您可以使用Stack镜像执行以下任何操作"
+
+# 8cd55fb113a049e7be445b21084df7ea
+#: ../../index.rst:6
+msgid "Start a personal Jupyter Notebook server in a local Docker container"
+msgstr "在本地Docker容器中启动个人Jupyter Notebook服务器"
+
+# 285fa13bed8547b4af0cfc480adf4861
+#: ../../index.rst:7
+msgid "Run JupyterLab servers for a team using JupyterHub"
+msgstr "使用JupyterHub为团队运行JupyterLab服务器"
+
+# a49d31cedd4946ea98d7a4c720340d84
+#: ../../index.rst:8
+msgid "Write your own project Dockerfile"
+msgstr "编写自己的Dockerfile"
+
+# 0aff0df2e46a44b4bc8070545e83c42c
+#: ../../index.rst:11
+msgid "Quick Start"
+msgstr "快速开始"
+
+# 3262accd283140058db73005072be200
+#: ../../index.rst:13
+msgid ""
+"You can try a `recent build of the jupyter/base-notebook image on "
+"mybinder.org <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 ""
+
+# 9e4094e8de264e20bca0af8f6cf888b7
+#: ../../index.rst:15
+msgid ""
+"The other pages in this documentation describe additional uses and features "
+"in detail."
+msgstr ""
+
+# 8b75310f2eaa4aac95d9387e0a4db9e8
+#: ../../index.rst:17
+msgid ""
+"**Example 1:** This command pulls the ``jupyter/scipy-notebook`` image "
+"tagged ``17aba6048f44`` from Docker Hub if it is not already present on the "
+"local host. It then starts a container running a Jupyter Notebook server and"
+" exposes the server on host port 8888. The server logs appear in the "
+"terminal. Visiting ``http://<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 ""
+
+# 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 ""
+
+# 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 ""
+
+# 1bc0c7d54cd343d689362047c0b00122
+#: ../../index.rst:30
+msgid "Table of Contents"
+msgstr ""

docs/maintaining/tasks.md

@@ -55,3 +55,28 @@ If automated builds on Docker Cloud have got you down, do the following to push
 2. Check out the git SHA you want to build and publish.
 3. `docker login` with your Docker Hub/Cloud credentials.
 4. Run `make retry/release-all`.
+
+## Enabling a New Doc Language Translation
+
+First enable translation on Transifex:
+
+1. Visit https://www.transifex.com/project-jupyter/jupyter-docker-stacks-1/languages/
+2. Click *Edit Languages* in the top right.
+3. Select the language from the dropdown.
+4. Click *Apply*.
+
+Then setup a subproject on ReadTheDocs for the language:
+
+1. Visit https://readthedocs.org/dashboard/import/manual/
+2. Enter *jupyter-docker-stacks-<lang>* for the project name.
+3. Enter https://github.com/jupyter/docker-stacks for the URL.
+4. Check *Edit advanced project options*.
+5. Click *Next*.
+6. Select the *Language* from the dropdown on the next screen.
+7. Click *Finish*.
+
+Finally link the new language subproject to the top level doc project:
+
+1. Visit https://readthedocs.org/dashboard/jupyter-docker-stacks/translations/
+2. Select the subproject you created from the *Project* dropdown.
+3. Click *Add*.

docs/using/recipes.md

 # 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