Create beautiful and localized documentations and websites using MkDocs + Github

Come and learn about MkDocs new features and change your mind about static pages!

Alexys Jacob

Community Documentation Internationalization Open-Source Tooling

See in schedule: Wed, Jul 28, 12:00-12:45 CEST (45 min) Download/View Slides

In this talk I will walk you through all the steps needed to create and host feature rich and localized documentations (and even websites) using MkDocs + Github Pages.

MkDocs is a famous Python powered project used to build documentation for a lot of projects. It's based on Markdown and supports Markdown extensions, custom themes and plugins to extend its rendering capabilities.

But it did not support building documentations in multiple languages and this was a wanted feature since 2014...

After building documentations using MkDocs I decided to use it to switch my website and blog from Wordpress to a static page generator. I thus took on the challenge to contribute localization support to the MkDocs project because I needed it and it could benefit the community.

After 2 months of work, 175 comments and 85 commits over 55 files I'm glad that my PR have been merged and is part of the MkDocs 1.2 version.

I learned a lot along the way and I wanted to share my experience and a comprehensive walk through to get you ready and happy to use these new MkDocs features!

Type: Talk (45 mins); Python level: Beginner; Domain level: Beginner

Alexys Jacob


CTO at Numberly, Open-Source contributor, Gentoo Linux developer, PSF contributing member.

I’ve been giving talks for a few years now, mostly to share my experience on architecture design, distributed systems, fault tolerance and scaling Python.

Numberly is a Marketing Technologist that helps its customers leverage the value of their data using all the digital communication channels available. We own and operate our infrastructure and are working on building large scale and highly available global architectures and applications. Our main development language to achieve this in all this variety of use cases is Python!

As a Gentoo Linux developer I focus mainly on clustering and NoSQL related packages. I'm a packager of various Open Source projects such as uwsgi, mongodb, consul, rabbitmq, keepalived, scylla...

You can catch me around with my handle: @ultrabug