Public Repository

Last pushed: 9 days ago
Short Description
Build documentation using Sphinx and deploy to a static website hosted in AWS S3
Full Description

Overview

This image is based on ubuntu. It contains the basic dependencies needed to build documentation with Sphinx.
The f5-sphinx-theme is built in.

Usage

docker run --rm -it -v $PWD:$PWD --workdir $PWD -e "LOCAL_USER_ID=$(id -u)" containthedocs "$@"

Versions:

  • latest - Ubuntu 16.04-based image
  • latex_pdf - Same as latest, but with LaTeX packages built in. Much bigger download.

Dockerfile

FROM ubuntu:xenial
ENV APPPATH /wkdir
WORKDIR /wkdir
RUN set -x \
 && apt-get update \
 && apt-get install -y \
      build-essential \
      git \
      libssl-dev \
      libffi-dev \
      nodejs-legacy \
      npm \
      python-dev \
      python-pip \
      curl \
      wget \
      sudo \
 && rm -rf /var/lib/apt/lists/*
RUN npm install -g write-good
COPY requirements.txt /tmp
RUN pip install -U pip \
 && pip install -r /tmp/requirements.txt
COPY entrypoint.sh /
COPY tools/* /usr/local/bin/
ENTRYPOINT [ "/entrypoint.sh" ]
CMD [ "/bin/bash" ]

requirements.txt

sphinx>=1.6.2
f5-sphinx-theme
recommonmark
awscli
sphinx-autobuild
git+https://github.com/f5devcentral/f5-sphinx-theme.git@master
cloud_sptheme
sphinxjp.themes.basicstrap

Built-in deployment scripts

The image contains a /tools directory containing a number of scripts used to deploy documentation from GitHub/GitLab project repos to an AWS s3 bucket configured for static website hosting. These scripts are specific to F5's requirements, but can be amended (and commited as a new image) to suit your needs.

Docker Pull Command
Owner
f5devcentral

Comments (0)