Documentation

Here is a running example of a fully configured website.

Installation

Use Docker Compose

version: "3.9"

services:
  ewp:
    image: git.mylloon.fr/anri/mylloon.fr:latest
    container_name: EWP
    volumes:
      - /here/your/path/config:/app/config
      - /here/your/path/data:/app/data
    ports:
      - 80:8080
    restart: unless-stopped

Do you want to make the site available on Tor as well?

version: "3.9"

services:
  tor:
    image: goldy/tor-hidden-service:latest
    container_name: Website_tor
    network_mode: bridge
    links:
      - ewp
    environment:
      EWP_TOR_SERVICE_HOSTS: "80:ewp:8080"
      EWP_TOR_SERVICE_VERSION: "3"
    volumes:
      - tor-keys:/var/lib/tor/hidden_service/
    secrets:
      - source: ewp
        target: ewp
        mode: 0400
    restart: unless-stopped

  ewp:
    image: git.mylloon.fr/anri/mylloon.fr:latest
    container_name: Website
    network_mode: bridge
    hostname: ewp
    volumes:
      - /here/your/path/ewp/app/config:/app/config
      - /here/your/path/ewp/app/data:/app/data
    ports:
      - 99:8080
    restart: unless-stopped

volumes:
  tor-keys:
    driver: local

# Use https://github.com/cathugger/mkp224o to generate a key
secrets:
  ewp:
    file: /here/your/path/ewp/hidden_service/hs_ed25519_secret_key

You can tell the Tor Browser that you are offering an onion link by specifying your address in the config.toml file.

onion = "http://youraddress.onion/"

Configuration

Global configuration

This file is stored at /app/config/config.toml

mail = "your.mail at host.com"
lang = "lang"
onion = "http://youraddress.onion/"
app_name = "Nickname"
name = "Firstname"
fullname = "Fullname"

Link shortener for contacts

Add content

Markdown files have YAML headers with --- separator:

---
option: value
---

Markdown file

Blog

Markdown files are stored in /app/data/blog/

---
title: Option<String>
date: Option<Date>
description: Option<String>
publish: Option<bool>
tags: Option<Vec<Tag>>
---

Post content

if no title, the filename will be used
date format is day-month-year
publish is default to false. When false, posts are hidden from index but accessible, see #30

Projects

Markdown files are stored in /app/data/projects/

---
title: Option<String>
link: Option<String>
description: Option<String>
language: Option<String>
---

Project description

If no link : the div won't be clickable and will be reported as is to the user (no corner-arrow)
Note that only a handful of languages are supported.

Contacts

Markdown files are stored in /app/data/contacts/

---
title: String
custom: Option<bool>
user: Option<String>
link: Option<String>
newtab: Option<bool>
description: Option<String>
---

Custom project description

custom is default to false, if true all other metadata are ignored, except the title, and the markdown will be used instead
when custom is false then markdown will be ignored and only metadata will be used to create the contact field
newtab add property to open in a new tab a link
user is the username used in the platform

3.6 KiB Raw Blame History