HTMS is OSS

PACKAGE 2.4

SLIDES 3.1

HTMS is OSS

HTMS Background

HTMS debuted at EuroTcl 2019 as part of SPMC: SISLIDY Presentation Markup Compiler.

HTMS is OSS debuted at Sqlite2021.

HTMS is the basis of the SPMC presentation markup compiler.

SPMC compiled this slide show into a single HTML document.

HTMS-2.4.0.tm

converts shorthand into HTML
future-proof
extensible
and, now, it supports XML

Syntax Review

Quick Review

HyperText Markup Shorthand

a quick review

Void Tags

Void tags cannot contain content.

HTMS

br

HTML

<br/>

Empty Elements

Empty elements do not have contents.

HTMS

figcaption

HTML

<figcaption>
</figcaption>

Elements with Content

HTML is meant to markup content.

HTMS

p CONTENT

HTML

<p>
    CONTENT
</p>

Tags w/ Key-only Attributes

Key-only attributes have implied values.

HTMS

p.hidden CONTENT

HTML

<p hidden=hidden>
    CONTENT
</p>

Tags w/ Key-Value Attributes

Key-value attributes have explicit values.

HTMS

a.rel=next CONTENT

HTML

<a rel=next>
    CONTENT
</a>

Tags w/ Multiple Attributes

Tags can have multiple attributes.

HTMS

a.rel=next.rev=prev CONTENT

HTML

<a rel=next rev=prev>
    CONTENT
</a>

Superfluous Attributes

Special case of superfluous attributes.

HTMS

a.rel=next.rel=prev CONTENT

HTML

<a rel=next>
    CONTENT
</a>

Superfluous attributes are omitted.

Micro-optimizations

A lot of tiny changes can sum up to a noticeable improvement.

A billion here, a billion there, and pretty soon you're talking real money.
— attributed to U.S. Senator Everett Dirksen

See Improving ... performance using micro-optimizations. EuroTcl, Eindhoven, 2016.

Tags with a Class Attribute

The class attribute is the element's type.

HTMS

a=C1 CONTENT

HTML

<a class=C1>
    CONTENT
</a>

Tags with an ID Attribute

IDs name elements in HTML, CSS, etc.

HTMS

p#1a CONTENT

HTML

<p id=1a>
    CONTENT
</p>

Tags with Style Properties

Style attributes contain CSS properties.

HTMS

a.color:red CONTENT

HTML

<a style=color: red;>
    CONTENT
</a>

Multiple Style Properties ...

... are put in a single attribute.

HTMS

a.color:#800.color:red.hyphens:none CONTENT

HTML

<a style=color: red; hyphens: none;>
    CONTENT
</a>

Superfluous properties are omitted.

Compound Shorthand

The shorthand forms can be combined.

HTMS

figcaption=quote#dirksen.hidden.color:blue

HTML

<figcaption class=quote id=dirksen
   hidden style=color: blue;>
</figcaption>

Sample Savings

Summary of Savings

www.tcl.tk/tcl/TclCmd/*.htm

htms size          raw size
1_245_614  93% of 1_346_630     111 files
    6_487  94% of     7_077        median
   11_222  94% of    12_135          mean

htms size         full size
1_245_614  91% of 1_382_875     111 files
    6_487  92% of     7_375        median
   11_222  92% of    12_458          mean

An Anchor with an Href

Use a second # (and BTW, .. is .)

HTMS

a##tcl..tk/#globalnav CONTENT

HTML

<a href=tcl.tk/#globalnav>
    CONTENT
</a>

Saves and additional 2%-points.

Extra Savings

Summary of Extra Savings

www.tcl.tk/tcl/TclCmd/*.htm

htms size  -vs-  raw size, -vs-  full size
1_239_233   91% 1_346_630  89%  1_382_875    111 files
    6_340   92%     7_077  90%      7_375       median
   11_164   92%    12_132  90%     12_458         mean

Anchor with everything

HTMS

a=C1#1a#tcl..tk.rel=next.fg:#FFF.bg:blue 
    HTML content

HTML

<a class=C1 id=1a href=tcl.tk rel=next
   style=fg: #FFF; bg: blue;>
    HTML content
</a>

Open Source Licensing

OSS Licensing

granting copying rights

Open Source Software

open..., free/libre..., shared...

Not merely available source

FSF — the Free Software Foundation; think ... GNU
OSI — the Open Software Initiative
SPDX — the Software Package Data Exchange
CC — the Creative Commons Corporation
and many more groups

With many, many license choices ...

The CC0-1.0 License

Creative Commons Zero v1.0 Universal

Free for any usage EXCEPT patents or trademarks!

thus not FSF Free for code,
but OK for documentation
and not OSI Open
—again due to patent rights

The CC-BY-3.0 License

CC Attribution 3.0 Unported

Free for any copyright usage, but ...

you MUST include the existing copyright (and authorship?) notices
you MUST link to the legal terms
you MUST NOT disparage an author's
honor or reputation

Neither FSF- nor OSI-approved for software.

The MIT License

(Mass. Inst. of Tech.) License

Free for any usage, but ...

you MUST include the copyright notice and the permission notice in all copies

Both FSF- and OSI-approved for software.

The MIT-0 License

MIT No Attribution

Free for any usage.

you do NOT even have to include the copyright

OSI approved for software.

The TCL License

TCL/TK License

Free for any usage, but ...

you MUST include the copyright and permission notices — along with ...

This software is copyrighted by the Regents of the University of California, Sun Microsystems, Inc., Scriptics Corporation, ActiveState Corporation and other parties.

Neither FSF- nor OSI-approved for software.

The Knuth License

(Donald E.) Knuth License

This software is copyright and you are explicitly granted a license which gives you, the user of the software, legal permission to copy, distribute and/or modify the software, so long as if you modify the software then it carry a different name from the original software.

Neither FSF- nor OSI-approved for software.

Other Licenses

Honorable mentions:

Summary

HTMS is OSS

code is
SPDX-License-Identifier: MIT-0
text is
SPDX-License-Identifier: CC0-1.0
the feather graphic originated by fant0man is
SPDX-License-Identifier: CC-BY-3.0

Public Fossil Repository

Public Repository

chiselapp.com/user/k8/repository/htms

Tcl Modules

                             lines LOC
cmd/htms                       11    6
lib/drymodule-2.1.3.tm        111   29
src/edict/genpun-1.1.2.tm     112   65
src/edict/supsub-1.1.2.tm      47   41
src/htms-2.4.4.tm             275  244
src/htmscli-2.4.1.tm          109   93
---------------------------- ----- ---
                              665  478

Summary

Bibliography

Hipp, Richard. Improving TCL core performance using micro-optimizations, EuroTcl, Eindhoven, June 2016. youtu.be/AJrsl3rHQ74
htms, Fossil repository, October 2021. chiselapp.com/user/k8/repository/htms
Kaelbling, Michael. SPMC: SISLIDY presentation markup compiler, EuroTcl, Nuremburg, June 2019. youtu.be/U5E3wewbpuM
Software Package Data Exchange. SPDX license list, November 2021. https://spdx.org/licenses/

Take-Aways

HTMS saves over 5% on HTML file size
plus, the HTML is meta-programmable
plus, HTMS is extensible
chiselapp.com/user/k8/repository/htms

Thank you for your attention!

HTMS is OSS

HTMS is OSS

Contents

HTMS Background

HTMS-2.4.0.tm

Syntax Review

Quick Review

HyperText Markup Shorthand

Void Tags

Empty Elements

Elements with Content

Tags w/ Key-only Attributes

Tags w/ Key-Value Attributes

Tags w/ Multiple Attributes

Superfluous Attributes

Micro-optimizations

Tags with a Class Attribute

Tags with an ID Attribute

Tags with Style Properties

Multiple Style Properties ...

Compound Shorthand

Sample Savings

Summary of Savings

An Anchor with an Href

Extra Savings

Summary of Extra Savings

Anchor with everything

Open Source Licensing

OSS Licensing

granting copying rights

​Open Source Software

open..., free/libre..., shared...

The CC0-1.0 License

Creative Commons Zero v1.0 Universal

The CC-BY-3.0 License

CC Attribution 3.0 Unported

The MIT License

(Mass. Inst. of Tech.) License

The MIT-0 License

MIT No Attribution

The TCL License

TCL/TK License

The ​Knuth License

(Donald E.) Knuth License

Other ​Licenses

Honorable mentions:

Summary

Summary

HTMS is OSS

Public Fossil Repository

Public Repository

chiselapp.com/user/k8/repository/htms

Tcl Modules

Summary

Summary

Bibliography

Take-Aways

Thank you for your attention!

Open Source Software

The Knuth License

Other Licenses