Markup language ecosystem сombining small file size, big number of possibilities for describing the interface and readability.
Find a file
2024-08-11 16:33:53 +03:00
libs/typescript fix: optimize daletpack strings, update types.ts 2024-08-05 19:17:40 +03:00
specification doc: fix daleth examples syntax in tags 2024-08-09 21:04:09 +03:00
LICENSE Initial commit 2024-07-22 18:00:17 +03:00
README.md doc: format concept 2024-08-11 16:33:53 +03:00

Dalet

Dalet

Markup language ecosystem сombining small file size, big number of possibilities for describing the interface and readability.

Specification

Rust implementation

Warning

Specification and rust implementation is not complete and very unstable.

Concept

This is Daleth (high level language that compiles to Daletl).

# multilines
#
# {text} - input is trimmed with indent
#
# {~n text} - n is number of minimum spaces to add after trimming with indent
# for each line
#
# {#text} - input not modified
#
#
# tag syntax
#
# tag: text body
# tag { multiline text body }
# body text always trimmed
#
# tag [ multiple tags body ]
#
# Arguments
# tag argument
#
# Tags without body and argument also supported
#
#
# custom no tag syntax
#
# {-text} - paragraph, text indent is trimmed
# [[tags]] - element tag with body of multiple tags
# text - element tag with text body

meta "title": Daleth syntax concept
meta "description": This document describes Daleth syntax and some tags

h1: TxtDot revolution
p: TxtDot is a cool project

# If no tag is specified, then the 'el' tag is placed

This is element
br

# if no tag is specified but a '{- text}' is present, then the 'p' tag is placed
# '\n' is replaced with ' ' in this format.
{-
    Check Dalet too
    This is one paragraph
}

{-
    This is another paragraph ({- text\})
}

row "center" [
    link "https://github.com/txtdot/txtdot": Homepage
    btn "https://example.com/donate" [
        # tag without body
        img "https://example.com/donate.png"
        Donate
    ]
]

# [] for multiple tags
row [
    # if no tag is specified but a '[[]]' is present, then the 'el' tag
    # with multiple tags body placed
    [[
        h2: Features

        ul [
            Server-side page simplification
            Media proxy
            Image compression with Sharp
            Rendering client-side apps `Vanilla, React, Vue, etc` with webder
            Search with SearXNG
            Handy API endpoints
            No client JavaScript
            Some kind of Material Design 3
            Customization with plugins, see @txtdot/sdk and @txtdot/plugins
        ]
    ]]

    [[
        h2: Running

        [[
            h3: Dev

            # {} for multiline strings, indent is automatically trimmed
            code {
                npm install
                npm run dev
            }

            # {~n Text} n is number of minimum spaces
            code "markdown" {~4
                this is codeblock
            }

            # {# Text} Text after "`# " not modified
            code "markdown" {#     this is codeblock}
        ]]

        [[
            h3: Production
            code {
                npm install
                npm run build
                npm run start
            }
        ]]

        [[
            h3: Docker
            code: docker compose up -d
        ]]

    ]]
]

# Table has custom format if text used
# +| cells | - primary column
#  | cells | - secondary column
#  | Element | Description | - converts to
#  tcol [
#    Element
#    Description
#  ]
table {
    +| Tag      | Description     |
     | h        | Heading         |
     | p        | Paragraph       |
     | img      | Image           |
     | link     | Link            |
     | btn      | Button          |
     | ul       | Unordered list  |
     | br       | Line break      |
    +| quantity | 7               |
}