css workbench page

test rst>html + css by providing all possible use-cases.

According to all known laws of aviation, there is no way a bee should be able to fly. Its wings are too small to get its fat little body off the ground. The bee, of course, flies anyway because bees don't care what humans think is impossible. Yellow, black. Yellow, black. Yellow, black. Yellow, black. Ooh, black and yellow! Let's shake it up a little. Barry! Breakfast is ready!

-- From https://gist.github.com/MattIPv4/045239bc27b16b2bcf7a3a9a4648c08a

"LGTM" he said, but if only he knew ...

Testing line blocks:

Each new line begins with a

vertical bar ("|").

Line breaks and initial indents

are preserved.

Continuation lines are wrapped

Testing emojis while being inline. I hope you do like cats ! . According to all known laws of aviation, there is no way a bee should be able to fly. Its wings are too small to get its fat little body off the ground.

time to test heading (this h2)

let's get into it

this should be h3

another one bite the dust

and this is h4

keep on digging

do we even have h5 ??

wow so much nesting

lists

Bullet lists:

This is item 1
This is item 2
Bullets are "-", "*" or "+". Continuing text must be aligned after the bullet and whitespace.

Enumerated lists:

This is the first item
This is the second item
Enumerators are arabic numbers, single letters, or roman numerals
List items should be sequentially numbered, but need not start at 1 (although not all formatters will honour the first index).
This item is auto-enumerated

Definition lists:

what: Definition lists associate a term with a definition.
how: The term is a one-line phrase, and the definition is one or more paragraphs or body elements, indented relative to the term. Blank lines are not allowed between term and definition

links

Regular link: https://github.com/MrLixm/MrLixm.github.io

This is an interesting website !

Footnote references, like [5]. Note that footnotes may get rearranged, e.g., to the bottom of the "page".

Autonumbered footnotes are possible, like using [1] and [2].

They may be assigned 'autonumber labels' - for instance, [4] and [3].

Auto-symbol footnotes are also possible, like this: [*] and [†].

Citation references, like [CIT2002]. Note that citations may get rearranged, e.g., to the bottom of the "page".

[CIT2002]

A citation (as often used in journals).

External hyperlinks, like Python.

tables

A simple table:

Inputs		Output
A	B	A or B
False	False	False
True	False	True
False	True	True
True	True	True

A large table:

name	description
authors	Comma separated list of person who authored the page. See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta/name
keywords	List of tags matching the page topics
language	Language of the page. As standardized by https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/lang and https://www.w3.org/International/articles/language-tags/
title	Additional override if the rst file title is not desired. See https://ogp.me/#metadata
type	Caracterize the kind of content of the page. As standardized by https://ogp.me/#types
image	Relative file path to the image to use as cover for the page. See https://ogp.me/#metadata
description	Short, human-readable summary of the page content. See https://ogp.me/#optional

A grid table:

Header 1	Header 2	Header 3
body row 1	column 2	column 3
body row 2	Cells may span columns.
body row 3	Cells may span rows.	Cells contain blocks.
body row 4	Cells may span rows.	Cells contain blocks.

code blocks

And now some code:

from pathlib import Path
import OpenImageIO as oiio

def read_image(path: Path) -> oiio.ImageBuf:
    """
    Read given image from disk as oiio buffer.
    """
    return oiio.ImageBuf(str(path))

def write_image(
    image: oiio.ImageBuf,
    dst_path: Path,
    compression: str,
    bitdepth: oiio.TypeDesc,
):
    if ":" in compression:
        compression, quality = compression.split(":")
        image.specmod().attribute("quality", int(quality))
    image.specmod().attribute("compression", compression)
    image.write(str(dst_path), bitdepth)
    if image.has_error:
        raise IOError(f"Cannot write image to disk: {image.geterror()}")

Or as literal block:

def read_image(path: Path) -> oiio.ImageBuf:
   """
   Read given image from disk as oiio buffer.
   """
   return oiio.ImageBuf(str(path))

With lines :

1
2
3
4
5  def read_image(path: Path) -> oiio.ImageBuf:
    """
    Read given image from disk as oiio buffer.
    """
    return oiio.ImageBuf(str(path))

Overflowing :

1
2
3
4
5  def read_image(path: Path) -> oiio.ImageBuf:
    """
    This is hopefully a long enougg line of text so we can test how a code-block will render with a noticeable overflow.
    """
    return oiio.ImageBuf(str(path))

As a doctest:

>>> print("hello world")
Hello world !!! wait, it's not what I asked ?
>>> assert "🐸" + "🧪" == "🏳️‍🌈"

With include directive:

from pathlib import Path
import OpenImageIO as oiio


def read_image(path: Path) -> oiio.ImageBuf:
    """
    Read given image from disk as oiio buffer.
    """
    return oiio.ImageBuf(str(path))

from pathlib import Path
import OpenImageIO as oiio


def read_image(path: Path) -> oiio.ImageBuf:
    """
    Read given image from disk as oiio buffer.
    """
    return oiio.ImageBuf(str(path))