Skip to content

csb0730/deltachat-pages

 
 

Repository files navigation

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.

How to create a new blog post

  • In the directory _posts create new file in the form YYYY-MM-DD-title.md 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 https://delta.chat/en/blog , the RSS-Feed, Twitter @delta_chat, Friendica and maybe even more.

Testing changes

  • You can create your fork on Github and Github pages; the forked website will then be available at https://<your-username>.github.io/deltachat-pages/
  • 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, this layout is referenced in the corresponding Transifex entries as layout: default-<lang>
  • create directory /<lang>
  • add the language to tlangs in /tools/t-dance.sh and run ./t-dance.sh pull from the tools-direcory
  • check the language selection in /index.html and in /_includes/footer-languages.html.

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 :-)

License

Licensed under the GPLv3, see LICENSE file for details.

Copyright © 2017, 2018 Delta Chat contributors

Releases

No releases published

Packages

No packages published

Languages

  • HTML 72.4%
  • CSS 12.4%
  • Shell 10.6%
  • Ruby 4.6%