1. DetailedInformation
  2. Backend
  3. schhtml

schtml

schhtml to format, który korzysta w maksymalnym stopniu ze składni html'a ale nie aspiruje do zgodności z tym formatem. Główną ideą formatu schtml jest prostota przy zachowaniu podobieństwa do html'a. Schtml jest wykorzystywany przez pytigona podczas renderowania formularzy w kliencie graficznym opartym na wxPython. SChtml służy także do generowania wydruków w formacie pdf.

HTML_TAGS = ["html", "head", "comment"]

BLOCK_TAGS = ["body", "form"]

ATOM_TAGS = [ "br", "a", "img", "calc", "hr", ]

PAR_TAGS = [ "p", "h1", "h2", "h3", "h4", "h5", "h6", "i", "b", "s", "small", "big", "sub", "sup", "tt", "span", "ol", "ul", "li", "div", ]

TABLE_TAGS = ["table", "caption", "tr", "td", "th"]

PAGE_TAGS = [ "page", "header", "footer", "newpage", ]

EXTRA_TAGS = [ "vimg", ]

CSS_TAG = [ "link", ]

Rozmieszczenie elementów na stronie różni się w zależności czy są one bezpośrednimi potomkami elementu body czy są głębiej zagnieżdżone. Bezpośredni potomkowie body umieszczani są jeden pod drugim. Dla przykładu strona:

html
    body
        div widht=50%
            .Hello
        div width=50%
            .Hello

będzie zawierała 2 napisy Hello, jeden pod drugim. Aby elementy div, których znalazły się obok siebie należy je umieścić wewnętrz dodatkowego elementu div, tak jak w poniższym przykładzie:

html
    body
        div width=100%
            div widht=50%
                .Hello
            div width=50%
                .Hello

Inaczej także wyświetlane są tabele w zależności czy są potomkami elementu body czy nie. Wiersze tabeli będącej potomkiem body mogą być przenoszone na kolejne strony. Tabela która nie jest bezpośrednim potomkiem body i która nie zmieści się cała na bieżącej stronie będzie w całości przenoszona na kolejną stronę.

SChHtml może renderowany html body page header footer

        newpage

register_tag_map("page", Page) register_tag_map("header", HeaderFooter) register_tag_map("footer", HeaderFooter) register_tag_map("newpage", NewPage)

CSS:

schtml obsluguje uproszczony format css.

Obsługiwane elementy css:

  • width: [ "50", "50%" ]

  • height: [ "50", "50%" ]

  • color: [ "#ff00ff", "#fff", "rgb(r,g,b)" ]

  • font-family: ["serif", "sans-serif", "monospace", "cursive", "fantasy",]
  • font-size: [ "100%", "20" ]
  • font-style: "italic"
  • font-weight: "bold"
  • text-decoration: ["underline", "oblique"]
  • page-break-inside: "avoid"

  • white-space: "pre"

  • bgcolor

  • background-color: #ff00ff
  • background-image: url(image)
  • background: bgcolor, [ "url(image)" ], ["repeat" ], ["scroll", "fixed", "inherit"], ["left", "center", "right"], ["top", "center", "bottom"]

  • background-size: ["cover", "contain", "100%"]

  • border-top: size

  • border-right: size
  • border-bottom: size
  • border-left: size
  • border: size

  • border-color: #ff00ff

  • margin: size margin: top_down left_right margin: top right bottom left allsizes in px (rem, em are replaced to px) or % (for % of element (or parent of element if the element has not yet calculated sizes) width or height )

  • padding: size

  • cellpadding: size

  • cellspacing: size

  • src: image_path

  • align: ['left', 'center', 'right']

  • text-align: ['left', 'center', 'right']
  • vertical-align: [ 'top', 'bottom', 'center' ]

ol:

  • type: '1', 'a', 'A'

ul:

  • type: 'disc', 'circle', 'square', 'none'

table:

  • border-color: #ff00ff

additional:

Umieść gdzieś na stronie: a wygenerowany ze strony dokument pdf będzie miał poziomą orientację.

todo: size[calc]

konstrukcja: "selektor selektor2 selektro3" w schtml jest równoznaczna "selektor > selektro2 > selektor3" w html'u.

Przy eksporcie html'a do formatów: pdf i spdf, możesz generować automatyczne nagłówki i stopki na każdej renderowanej stronie. Do definicji tych nagłówków i stopek służy tag . Należy go łączyć razem z podrzędnymi tagami

i
?: Schhtml ?: Schhtml