PlankMD

Markdown d'abord

Un fichier .plank.md est du Markdown valide. Le texte entre les blocs est le livret de montage, les blocs sont les planchettes.

Dans l'ordre de pose

Les lignes sont écrites dans l'ordre où l'on pose les planchettes, et le validateur vérifie chaque planchette à ce moment-là. Rien ne traverse rien, rien ne flotte.

Mesuré avec des planchettes

Les positions se comptent en épaisseurs de planchette. Les gabarits sont des planchettes fantômes qui montrent l'espace à laisser, et le validateur vérifie l'écart.

Vérifié à l'équilibre

Un calcul d'équilibre optionnel dit si la construction tient après chaque planchette, et quelle inclinaison chaque étape supporte. Un moteur physique rejoue le montage.

Pensé pour l'IA

Des lignes courtes et régulières qu'un modèle de langage sait écrire et qu'un validateur sait vérifier, avec des diagnostics assez précis pour corriger le modèle.

Ouvert

MIT pour la spécification et le code, CC0 pour les modèles. Indépendant de toute marque, avec les proportions de la planchette déclarées dans le fichier.

Un premier modèle

markdown

## Step 1: the first layer

Lay two planks flat and parallel, then two across them, on their ends.

```plank
flat-x 0 0 0
flat-x 0 12 0
flat-y 0 0 1
flat-y 12 0 1
```

## Step 2: build up the walls

```plank
flat-x 0 0 2  repeat=4 offset=0,0,2
flat-x 0 12 2 repeat=4 offset=0,0,2
flat-y 0 0 3  repeat=4 offset=0,0,2
flat-y 12 0 3 repeat=4 offset=0,0,2
```

Une planchette mesure 15 × 3 × 1 en épaisseurs de planchette : la plupart des modèles n'utilisent donc que de petits entiers. flat-x pose une planchette à plat le long de x ; les trois nombres sont son coin. Le texte du livret peut être écrit dans n'importe quelle langue, seuls les mots-clés sont en anglais. Ouvrir cette tour dans le lecteur.

Ce que vous trouverez ici

La spécification, PlankMD v0.1 (brouillon).

Un lecteur 3D, en français ou en anglais : étapes, montage planchette par planchette, édition en direct, diagnostics, calcul d'équilibre et test de chute. Collez ou déposez un fichier .plank.md, ou ouvrez-en un depuis le web avec ?src=<url>.

Une galerie de modèles plus grands : un château, un phare, une pagode, un voilier, des monuments, et Notre-Dame de Paris en 1392 planchettes.

Un validateur et une bibliothèque pour Node et le navigateur, sans dépendance : npx plankmd validate model.plank.md.

Des instructions pour les modèles de langage : un prompt système qui écrit des modèles valides et constructibles.

Compatibilité

Compatible avec les planchettes KAPLA® : la taille de planchette par défaut (plank: [15, 3, 1], unit_mm: 7.8) leur correspond. Toutes les autres planchettes conviennent aussi : déclarez leurs proportions dans le frontmatter.
KAPLA® est une marque déposée de son propriétaire. PlankMD est un projet indépendant ; il n'est ni affilié au propriétaire de la marque, ni parrainé, ni approuvé par lui.

PlankMD suit les principes de conception de LearnSpec, une suite ouverte de formats Markdown pour l'apprentissage.

PlankMDDes constructions en planchettes de bois, en Markdown