![]() |
3 weeks ago | |
---|---|---|
.github | 3 weeks ago | |
_data | 4 weeks ago | |
_includes | 4 weeks ago | |
_layouts | 8 months ago | |
_posts | 1 month ago | |
_sass | 3 weeks ago | |
assets | 3 weeks ago | |
ca | 3 weeks ago | |
de | 3 weeks ago | |
en | 3 weeks ago | |
es | 3 weeks ago | |
fr | 3 weeks ago | |
it | 3 weeks ago | |
nb | 3 weeks ago | |
pl | 3 weeks ago | |
pt | 3 weeks ago | |
ru | 3 weeks ago | |
sq | 3 weeks ago | |
tools | 4 weeks ago | |
uk | 3 weeks ago | |
.gitattributes | 2 years ago | |
.gitignore | 8 months ago | |
35c3.html | 11 months ago | |
404.html | 4 weeks ago | |
Gemfile | 2 years ago | |
Gemfile.lock | 3 weeks ago | |
LICENSE | 2 years ago | |
README.md | 4 weeks ago | |
_config.yml | 4 weeks ago | |
_redirects | 10 months ago | |
favicon.ico | 2 years ago | |
feed.xml | 4 weeks ago | |
google2faa16b6e4ce3d8b.html | 2 years ago | |
google1730128c2b186138.html | 2 months ago | |
index.html | 9 months ago |
This repository contains the default website of Delta Chat - feel free to edit any file as you like and send a pull request.
In the various source text files that are used for generating the static https://delta.chat 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.
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 , and the RSS-Feed. Ping r10s or compl4xx on irc.freenode.net/#deltachat so they post it to Mastodon, Twitter, Friendica and other services.
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.
/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.
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/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
.
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/t-dance.sh
- add your page to sfiles
variable
and create dir translations/delta-chat-pages.<name>po/
run cd tools; ./t-dance push
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