All Projects → dlang-tour → Core

dlang-tour / Core

Licence: bsl-1.0
D Language online tour ( and online editor (

1415 Projects Similar to Core

Tourist Guide into your React Components
The Raku Guide
Golang For Nodejs Developers
Examples of Golang compared to Node.js for learning
Tutorial Git
📘 어떻게 깃을 사용하는지 빠르게 알아봅시다. (Quick learn How to use Git.)
Java8 Tutorial
Modern Java - A Guide to Java 8
Wasm By Example
Wasm By Example is a website with a set of hands-on introduction examples and tutorials for WebAssembly (Wasm)
Digital video introduction
A hands-on introduction to video technology: image, video, codec (av1, vp9, h265) and more (ffmpeg encoding).
A small library that helps you to make an amazing parallax view
🔦The ShowcaseView library is designed to highlight and showcase specific parts of apps to the user with an attractive and flat overlay.
Haskell Study Plan
An opinionated list of resources for learning Haskell
Road To Master Ngrx Store
A curated guided hyperlinks to learn all there is to know of Ngrx/Store and state management in general
Learn Python for free using open-source notebooks in Hebrew.
Awesome Swiftui
A collaborative list of awesome articles, talks, books, videos and code examples about SwiftUI.
Opencv Tutorials
Tutorials for learning OpenCV in Python from Scratch
Ros Academy For Beginners
中国大学MOOC《机器人操作系统入门》代码示例 ROS tutorial

The Dlang Online Tour

Build Status

This is the D language online tour which provides an online introduction to this great system programming language with examples that can be edited, compiled and run online.

The most recent version of this tour can be seen here:

Running offline

The tour can be downloaded for offline access:

git clone --recursive && cd core
git submodule foreach git pull origin master

This requires DUB - D's package manager. DUB is part of the release installer and archives.

Specifying a language directory

For translator it's often convenient to clone their directory and run the tour only with their language. A custom language can be loaded directly using the -l / --lang-dir option with the path to the directoy of the to be loaded language:

dub fetch dlang-tour # only once
dub run dlang-tour -- --lang-dir .

Add Content

This repository contains the application that runs the tour. Please refer to english content or another language.

Further information on how to add or change existing content can also be found in the

Compile & Run

On a minimal Ubuntu system the following command will install the system packages needed to run all examples:

apt update && apt install \
    curl xz-utils unzip gnupg `# Needed for the script` \
    build-essential `# C toolchain for compiling and linking` \
    libssl-dev libevent-dev `# Vibe-d network dependencies`\
    libopenblas-dev `# lubeck computer library dependency` \
    libxml++2.6-2v5 zlib1g-dev `# LDC dependencies`

Make sure dub is installed and simply run dub in the dlang-tour folder:

git clone --recursive && cd core

You might want to change the settings in config.yml to change the ports the tour is listening to.

OpenSSL 1.1

If you see linker errors regarding OpenSSL/1.1, try:

dub --override-config="vibe-d:tls/openssl-1.1"

Compiling & running of user source code

The source code on the tour can be compiled and then executed online and its output returned to the user. Therefore three different types of execution drivers have been implemented within the dlang-tour:

  • off: no online compilation allowed. If the user hits Runs an error message will be returned.
  • stupidlocal: an unsafe method that just runs rdmd on the local host system and returns its output. Very unsafe and musn't ever be used in production!
  • docker: runs dmd within a special Docker container (core-exec) and returns its output. The driver imposes the Docker container memory and execution time limits. Additional configurations options available in config.yml.

The execution driver is set in config.yml.

Caching of the program output can also be enabled in config.yml (exec.cache = true). Caching will only be enabled for the built-in default examples however.

Docker image

A Docker image is automatically built by Travis CI and pushed to the repository at The Dlang-Tour Docker container is configured to use Docker itself to compile and run D source code in the online editor. For that to work the host system's Docker /var/run/docker.sock Unix domain socket has to be mounted to work inside the container. A sandbox for compiling will then be started on the host system actually, and not within the DLang Tour Docker container itself.

The code for running the D compilers in a Docker sandbox can be found here: core-exec.

So to run the latest dlang-tour version in a Docker container, run the following command:

docker run -d --rm -p 80:8080 -e GOOGLE_ANALYTICS_ID=123 -v /var/run/docker.sock:/var/run/docker.sock \
	--name dlang-tour dlangtour/core

The tour will be available at your host system on port 80. To stop the container again just run:

docker stop dlang-tour

For further Docker foo please refer to the Docker documentation.

Note: The docker version inside the container must be compatible to that on the host system! Generally a newer version might run on the host system than within the container.

The Docker container is also the suggested way of dlang-tour's deployment.

Dlang Tour Bot

There is a friendly bot in place that listens to the events of all language repositories and triggers rebuilds and thus automatic deploments on a new change. More information about it can be found at it's repository.

Environment variables


default: (empty)

To enable Google Analytics please specify the environment variable GOOGLE_ANALYTICS_ID and set it to the tracking ID provided for your Analytics account.


default: (empty)

Required for exporting Gists to GitHub. Follow these instrutions to generate a CLI GitHub token.


default: 256

Memory limit per started rdmd Docker container which compiles and runs the user code.


default: 10

Maximum number of parallel executions of the rdmd user code Docker container.


default: 20

Time limit in seconds the rdmd Docker container with the user code is allowed to take until it is killed.


default: 4096

Maximum allowed size in bytes of the generated user program's output.


A deployment guide can be found in the deploy folder.


Boost License. See LICENSE.txt for more details.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected]
✭ 89
d (194)