commit 80113aa887d19f6c01a713dd518b96079b6bc4f1
parent c263c317021652fad53b9e546f1e14cbd3b342d0
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Mon, 22 Sep 2025 14:52:52 +0200
Use the template files in an example
The example is installed as shared resources for Star-Typesetting.
Setting up a website from scratch is therefore as simple as copying
these resources into an empty directory.
Diffstat:
12 files changed, 153 insertions(+), 34 deletions(-)
diff --git a/Makefile b/Makefile
@@ -43,12 +43,16 @@ install: sty-genhead
install 755 "$(DESTDIR)$(BINPREFIX)" src/sty-hooks; \
install 755 "$(DESTDIR)$(BINPREFIX)" src/sty-index; \
install 755 "$(DESTDIR)$(BINPREFIX)" src/sty-list; \
- install 644 "$(DESTDIR)$(APPPREFIX)/star-ty" templates/Makefile; \
- install 644 "$(DESTDIR)$(APPPREFIX)/star-ty" templates/config.mk; \
- install 644 "$(DESTDIR)$(APPPREFIX)/star-ty" templates/footer.html; \
- install 644 "$(DESTDIR)$(APPPREFIX)/star-ty" templates/sty.css; \
install 644 "$(DESTDIR)$(PREFIX)/share/doc/star-ty" README.md; \
install 644 "$(DESTDIR)$(PREFIX)/share/doc/star-ty" COPYING
+ # Example
+ mkdir -p "$(DESTDIR)$(APPPREFIX)/star-ty"
+ cp -r example/* "$(DESTDIR)$(APPPREFIX)/star-ty"
+ find "$(DESTDIR)$(APPPREFIX)/star-ty" -type f -exec chmod 644 {} +
+ find "$(DESTDIR)$(APPPREFIX)/star-ty" -type d -exec chmod 755 {} +
+ sed 's#@README@#$(DESTDIR)$(PREFIX)/share/doc/star-ty/README.md#g' \
+ example/home/about.sh.in > "$(DESTDIR)$(APPPREFIX)/star-ty/home/about.sh"
+ chmod 644 "$(DESTDIR)$(APPPREFIX)/star-ty/home/about.sh"
uninstall:
rm -f "$(DESTDIR)$(BINPREFIX)/sty-genhead"
@@ -56,12 +60,9 @@ uninstall:
rm -f "$(DESTDIR)$(BINPREFIX)/sty-hooks"
rm -f "$(DESTDIR)$(BINPREFIX)/sty-index"
rm -f "$(DESTDIR)$(BINPREFIX)/sty-list"
- rm -f "$(DESTDIR)$(APPPREFIX)/star-ty/Makefile"
- rm -f "$(DESTDIR)$(APPPREFIX)/star-ty/config.mk"
- rm -f "$(DESTDIR)$(APPPREFIX)/star-ty/footer.html"
- rm -f "$(DESTDIR)$(APPPREFIX)/star-ty/sty.css"
rm -f "$(DESTDIR)$(PREFIX)/share/doc/star-ty/README.md"
rm -f "$(DESTDIR)$(PREFIX)/share/doc/star-ty/COPYING"
+ rm -rf "$(DESTDIR)$(APPPREFIX)/star-ty"
clean:
rm -f src/sty-genhead.o sty-genhead
diff --git a/templates/Makefile b/example/Makefile
diff --git a/templates/config.mk b/example/config.mk
diff --git a/example/home/about.sh.in b/example/home/about.sh.in
@@ -0,0 +1,3 @@
+#!/bin/sh
+
+cat @README@
diff --git a/example/home/images/prompt.png b/example/home/images/prompt.png
Binary files differ.
diff --git a/example/home/index.tsv b/example/home/index.tsv
@@ -0,0 +1,3 @@
+# Label web-page [languages]
+Star Typesetting about.html
+Lorem Ipsum lorem-ipsum-@LANG@.html la:fr
diff --git a/example/home/lorem-ipsum-fr.md b/example/home/lorem-ipsum-fr.md
@@ -0,0 +1,55 @@
+# Lorem Ipsum
+
+Lorem Ipsum est un type de texte d’espace réservé couramment utilisé
+dans les secteurs de la conception et de l'édition pour remplir un
+espace sur une page et donner une impression de l’apparence du contenu
+final. Le Lorem Ipsum en français est dérivé d’un texte latin du
+philosophe romain Cicéron et est utilisé depuis les années 1960. Le
+texte est absurde et ne transmet aucune signification spécifique, ce qui
+permet aux concepteurs de se concentrer sur la mise en page et les
+éléments visuels sans être distraits par un contenu significatif.
+
+Le texte d’espace réservé est essentiel pour que les concepteurs
+visualisent les mises en page sans être distraits par le contenu réel.
+Il permet de se concentrer sur l'esthétique et la structure,
+garantissant une présentation équilibrée. Une mise en page propre
+améliore la créativité et facilite l'expérimentation avec la
+typographie, les couleurs et l’espacement. Cette pratique rationalise le
+processus de conception et aide les parties prenantes à visualiser le
+potentiel du projet.
+
+La typographie est essentielle à une conception efficace, influençant
+considérablement la façon dont le contenu est perçu. L'utilisation du
+Lorem Ipsum dans différentes longueurs et styles permet aux
+concepteurs de voir comment différentes polices et tailles
+interagissent, créant ainsi des présentations visuellement cohérentes.
+Par exemple, l’association d’un en-tête en gras avec une police de
+corps atténuée établit une hiérarchie qui guide l'œil du spectateur.
+Cette expérimentation est essentielle pour développer des conceptions
+qui améliorent à la fois l’esthétique et la lisibilité, permettant aux
+concepteurs d’affiner leurs choix typographiques pour transmettre le
+ton et le message souhaités du contenu.
+
+
+
+> L'utilisation du Lorem Ipsum dans le texte français permet aux
+> concepteurs d’organiser les éléments d’une manière qui guide
+> naturellement les yeux des spectateurs sur la page. Elle simplifie
+> l’équilibrage des images et des espaces blancs sans distractions du
+> contenu réel, favorisant une expérience utilisateur propre et
+> attrayante. Cette approche garantit que les informations importantes
+> se démarquent tout en conservant l’attrait visuel. De plus, il permet
+> aux concepteurs d'expérimenter différentes mises en page et styles
+> sans les contraintes du texte réel, ce qui conduit à des solutions
+> plus innovantes qui captivent le public.
+
+Le Lorem Ipsum en français est essentiel dans la conception Web pour
+créer des mises en page réactives qui s'adaptent à différentes tailles
+d’écran. Il aide les concepteurs à simuler le flux et l'ajustement du
+contenu, garantissant une expérience utilisateur fluide. Cela est
+essentiel dans le paysage numérique d'aujourd’hui, où les utilisateurs
+accèdent au contenu sur différents appareils. Tester les conceptions
+avec du texte factice permet d’identifier rapidement les problèmes
+potentiels, ce qui permet des ajustements opportuns qui améliorent la
+convivialité et l'accessibilité, aboutissant finalement à un produit
+final plus soigné.
diff --git a/example/home/lorem-ipsum-la.md b/example/home/lorem-ipsum-la.md
@@ -0,0 +1,55 @@
+# Lorem Ipsum
+
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Maecenas nunc
+nulla, posuere vel egestas in, aliquet et enim. Vivamus imperdiet felis
+lacus, ac tempus dui accumsan quis. Morbi sollicitudin a nulla vel
+sodales. Ut malesuada sollicitudin neque, non porta lectus rhoncus quis.
+Lorem ipsum dolor sit amet, consectetur adipiscing elit. Mauris aliquam
+sem vel ex sollicitudin, sit amet tristique sem lobortis. Suspendisse
+potenti.
+
+Mauris varius tristique leo, nec ultrices turpis vehicula in. Nunc
+elementum ornare congue. Morbi vitae dui vitae erat imperdiet fermentum
+quis vitae nisi. Integer risus nunc, efficitur eu tristique non,
+molestie in libero. Fusce augue odio, posuere a sagittis ut, eleifend
+vitae elit. Nam venenatis nisl hendrerit tortor sollicitudin ornare.
+Suspendisse mollis et mauris mattis feugiat. Nam in placerat lacus, quis
+vulputate arcu. Cras in gravida dui. Curabitur vel lectus vel odio
+feugiat facilisis. Pellentesque habitant morbi tristique senectus et
+netus et malesuada fames ac turpis egestas. Sed risus eros, auctor nec
+velit at, laoreet blandit magna.
+
+Vestibulum ex diam, gravida ornare velit id, ultrices vulputate ipsum.
+Maecenas euismod, nunc et eleifend dictum, lectus sem egestas erat, eget
+ornare dolor urna nec est. Maecenas eu diam pretium, congue nulla
+tempor, laoreet leo. Lorem ipsum dolor sit amet, consectetur adipiscing
+elit. Duis sit amet lobortis metus. Pellentesque volutpat, lacus vel
+euismod tincidunt, risus enim consectetur massa, vel laoreet eros purus
+nec eros. Nunc a magna suscipit, vulputate ante eu, vestibulum dui.
+Nulla facilisi. Ut velit purus, rhoncus a purus a, tempor vulputate
+lectus. Fusce iaculis, massa at faucibus rhoncus, tortor ex condimentum
+tortor, non blandit risus justo ac mauris. Morbi pretium, est vel ornare
+condimentum, leo eros dapibus arcu, et mollis est tortor in urna. Donec
+risus elit, malesuada vitae congue ac, varius eget leo. Suspendisse
+consectetur maximus varius. Proin blandit nibh nec ullamcorper semper.
+Vestibulum pulvinar molestie diam ut pharetra.
+
+
+
+> Donec in mi tempor, vulputate lectus vitae, scelerisque purus. Nullam
+> elementum faucibus laoreet. Donec convallis et magna nec pulvinar.
+> Aenean feugiat ultricies cursus. Sed semper pretium mi a suscipit.
+> Aenean in suscipit nibh. Etiam id nisi efficitur risus ultricies
+> dapibus.
+
+Suspendisse id tortor faucibus, luctus eros sit amet, iaculis tellus.
+Integer accumsan fringilla odio non consectetur. Aliquam erat volutpat.
+Praesent vel lectus a leo interdum porta ut egestas odio. Etiam varius
+sem eu fringilla convallis. Fusce ac imperdiet dui. Nunc non nisi nec
+mauris gravida rutrum. Sed condimentum nunc nec urna lobortis fermentum
+ac mattis turpis. Maecenas augue velit, dignissim eu purus vel,
+fringilla imperdiet nulla. Vivamus sodales ultricies lorem vel dapibus.
+Nunc non feugiat ante. Fusce orci nulla, gravida vel tempor non, iaculis
+mollis tellus. Quisque eget urna eu ligula aliquam auctor vitae nec
+nibh. Aenean elit libero, condimentum sed vulputate sit amet, iaculis
+sed nisl.
diff --git a/example/menu.tsv b/example/menu.tsv
@@ -0,0 +1,2 @@
+# Label directory
+Home home
diff --git a/templates/sty.css b/example/sty.css
diff --git a/example/templates/footer.html b/example/templates/footer.html
@@ -0,0 +1,26 @@
+</div>
+<div id="footer">
+ <table>
+ <tr>
+ <td style="vertical-align: middle;">
+ <a rel="license" href="http://creativecommons.org/licenses/by-nd/4.0/">
+ <img
+ alt="CC BY-ND 4.0"
+ style="max-width: 100%; padding-right: 0.5em;"
+ src="https://i.creativecommons.org/l/by-nd/4.0/88x31.png" />
+ </a>
+ </td>
+ <td style="vertical-align: middle;">
+ Copyright © 2015-2025
+ <a href="mailto:contact@meso-star.com">|Méso|Star></a>
+ <br>
+ This page is licensed under a
+ <a rel="license"
+ href="http://creativecommons.org/licenses/by-nd/4.0/">
+ Creative Commons Attribution-NoDerivatives 4.0 International License
+ </a>
+ </td>
+ </tr>
+ </table>
+</div>
+</body>
diff --git a/templates/footer.html b/templates/footer.html
@@ -1,26 +0,0 @@
-</div>
-<div id="footer">
- <table>
- <tr>
- <td style="vertical-align: middle;">
- <a rel="license" href="http://creativecommons.org/licenses/by-nd/4.0/">
- <img
- alt="CC BY-ND 4.0"
- style="max-width: 100%; padding-right: 0.5em;"
- src="https://i.creativecommons.org/l/by-nd/4.0/88x31.png" />
- </a>
- </td>
- <td style="vertical-align: middle;">
- Copyright © 2015-2025
- <a href="mailto:author@email.com">Author Name</a>
- <br>
- This page is licensed under a
- <a rel="license"
- href="http://creativecommons.org/licenses/by-nd/4.0/">
- Creative Commons Attribution-NoDerivatives 4.0 International License
- </a>
- </td>
- </tr>
- </table>
-</div>
-</body>
