The best documentation framework every created.
Project description
Bravo! You have received a Mercantilism Diploma in "somatic" from
the Orbital Convergence University International Air and Water
Embassy of the Tangerine Planet (the planet that is one ellipse further from
the Sun than Earth's ellipse).
You are now officially certified to include "somatic" in your practice!
Encore! Encore! Encore! Encore!
somatic
description
Started from the shell, "somatic" presents files in the current working
directory (CWD) that have extension ".S.HTML" (case sensitive).
obtainment
[xonsh] pip install somatic
tutorial
[xonsh] somatic help
the shell interface
[xonsh] somatic
"somatic" starts on port 20000, or the first avaible port after that.
- Running on http://127.0.0.1:20000
This is the equivalent of:
[xonsh] somatic start --port 20000
--
Alternatively you can add --static-port
and "somatic"
stops if the port specified is unavailable.
[xonsh] somatic start --port 20000 --static-port
--
This is an example ".S.HTML" file.
<pre>
<h1>This is an example HTML file.</h1>
<p>
It really only needs the "pre" tag to
look like a reflection of its contents in a browser.
</p>
<p>
Tags like "html" and "body" are actually not
necessary for rendering HTML in modern browsers.
</p>
<p>
for text to wrap, instead of extending off the page,
style "white-space: pre-wrap" can be utilized instead of
a "pre" tag like so:
<div style="white-space: pre-wrap"></div>
</p>
</pre>
However, here is the "CSS1Compat" option,
https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode
with scaling based on the browser screen "viewport" of the screen,
https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag
and support for UTF-8 characters.
http://www.unicode.org/charts
https://www.w3.org/International/questions/qa-html-encoding-declarations
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
</head>
<body>
<main>
<article style="white-space: pre-wrap">
</article>
</main>
</body>
</html>
the python3 interface
import pathlib
from os.path import dirname, join, normpath
this_folder = pathlib.Path (__file__).parent.resolve ()
import somatic
somatic.start ({
"extensions": [
'.S.HTML',
'.$.HTML',
'.s.HTML',
'.6.HTML',
'.jpg',
'.png'
],
#
# This is the node from which the traversal occur.
#
"directory": str (this_folder) + "/structures/somatic",
#
# This path is removed from the absolute path of share files found.
#
"relative path": str (this_folder) + "/structures/somatic",
#
# The first port to check
#
"port": 20000,
#
# Whether to check more ports if port is unavailable
#
"static port": False,
#
# 0, 1, 2
#
"verbose": 1,
})
import time
while True:
time.sleep (1000)
contacts
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file somatic-3.0.3.tar.gz
.
File metadata
- Download URL: somatic-3.0.3.tar.gz
- Upload date:
- Size: 536.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.10.12 Linux/6.5.0-27-generic
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35d1e8f9a28798d2a7bab4b7c7d175b39109ea200cd8411ebb097a16e9d0b61b |
|
MD5 | 795732f7c791ced1c02bbd33882b0e80 |
|
BLAKE2b-256 | 5d4cfb80df738998b851f3668c15e030c2785d61ca6d416ed50ced4bcc153b5e |
File details
Details for the file somatic-3.0.3-py3-none-any.whl
.
File metadata
- Download URL: somatic-3.0.3-py3-none-any.whl
- Upload date:
- Size: 534.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.2 CPython/3.10.12 Linux/6.5.0-27-generic
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 53b6b900287571026c145170d2be731e19846acb0f5655de40a56c4b56fa69f9 |
|
MD5 | a8225d695bbb1b32a05f8f56b5cb131c |
|
BLAKE2b-256 | 5bde55b886714173aa13311d7b36988690ea01342aaf4802ced972205eecee93 |