Delta Chat Website
björn petersen db74e9b5e7
Merge pull request #205 from deltachat/download-remove_qr
3 weeks ago
.github create the folder before uploading the preview, if it doesn't exist. (#202) 3 weeks ago
_data move page metadata and upgrade to scss 4 weeks ago
_includes move page metadata and upgrade to scss 4 weeks ago
_layouts fix german help menu 8 months ago
_posts fixing typos 1 month ago
_sass change btn color to menu gradient like 3 weeks ago
assets hide recomendation section if js is disabled 3 weeks ago
ca update translations 3 weeks ago
de update translations 3 weeks ago
en remove QR code because it is not worth the space on the download page just to link to 3 weeks ago
es update translations 3 weeks ago
fr update translations 3 weeks ago
it update translations 3 weeks ago
nb update translations 3 weeks ago
pl update translations 3 weeks ago
pt update translations 3 weeks ago
ru update translations 3 weeks ago
sq update translations 3 weeks ago
tools update translations 4 weeks ago
uk update translations 3 weeks ago
.gitattributes Force unique lineends. 2 years ago
.gitignore a quick post on the UX test report 8 months ago
35c3.html add 35c3 landing page 11 months ago
404.html move page metadata and upgrade to scss 4 weeks ago
Gemfile Add sitemap plugin. 2 years ago
Gemfile.lock Bump jekyll from 3.5.2 to 3.6.3 3 weeks ago
LICENSE Initial commit 2 years ago improve translation documentation 4 weeks ago
_config.yml move page metadata and upgrade to scss 4 weeks ago
_redirects update shortcut redirects 10 months ago
favicon.ico Add data files. 2 years ago
feed.xml move page metadata and upgrade to scss 4 weeks ago
google2faa16b6e4ce3d8b.html Add Webmastertools verification file. 2 years ago
google1730128c2b186138.html make google happy 2 months ago
index.html init ukrainian 9 months ago

Delta Chat Website

This repository contains the default website of Delta Chat - feel free to edit any file as you like and send a pull request.

Formatting of blog posts and web pages

In the various source text files that are used for generating the static website we use Semantic linefeeds to keep "diffs" for changes small. The gist of it is that you put each "phrase" part of a sentence into a single line.

How to create a new blog post

  • In the directory _posts create new file in the form eg. by copying an existing file

  • Write your blog post to the file and do not forget to add or modify the title: and author: line atop

  • That's all, the result goes to , and the RSS-Feed. Ping r10s or compl4xx on so they post it to Mastodon, Twitter, Friendica and other services.

Testing changes

  • You can create your fork on Github and Github pages; the forked website will then be available at https://<your-username>

  • Alternatively, install Jekyll on your local machive and execute jekyll serve --destination <path-to-build-dir> in the source directory.

Directory structure

  • /en - Contains the source language files in Markdown. Can be edited directly.

  • /de, /es, fr ... - Contain the translated files; translation is done through .po files that are translated using Transifex, see above. You must not edit translated files directly here but you can add additional files that are unique to the language.

  • /_layouts - This directory contains a default layout template for each language (the layout is referenced in Markdown using layout: name)

  • /assets - Page specific images and files; in general, we use one subdirectory per page or section here.

  • /assets/css - CSS and layout specific images and files here.

Translate the website

You can edit and improve the existing translations with Transifex. To update existing translations from the Transifex server, see the scripts and the documentation in the tools folder.

To add a new language, the followinging steps are required once:

  • create a new layout in /_layouts/default-<lang>.html and make sure that this layout is referenced in the corresponding Transifex entries as layout: default-<lang>

  • create directory /<lang>

  • add the language to tlangs in /tools/ and run ./ pull from the tools-direcory

  • check the language selection in /index.html and in /_includes/footer-languages.html.

To add a new page:

  • create the source as en/<name>.md

  • modify tools/.tx/config - add a section for the new page modify tools/ - add your page to sfiles variable and create dir translations/delta-chat-pages.<name>po/

  • run cd tools; ./t-dance push

Further Hints

  • whereever possible, use Markdown instead of HTML, esp. in the files that should be translated

  • no JavaScript whereever possible, no weird CSS nor other complicated things

  • the layout should be as simple as possible and should always work on small mobile screens as well as on desktops

  • when layouting, do not force a special structure. Header, Content, Footer - done.

  • no complex navigation - Simply link subpages from the main pages

  • no one-page-layout - we also have sites with long text, and we do not want to have separate layouts

  • we do not want a complex navigation, some toplinks, a footer, done.

  • Remember: Form follows function, KISS. The site should be dead-simple.

  • Finally: Have fun :-)


Licensed under the GPLv3, see LICENSE file for details.

Copyright © 2017-2019 Delta Chat contributors