ontowave 1.0.3 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +265 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -0,0 +1,265 @@
|
|
|
1
|
+
# 🌊 OntoWave
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/ontowave)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
|
+
|
|
6
|
+
**Bibliothèque JavaScript moderne pour le rendu markdown professionnel avec support complet des tableaux**
|
|
7
|
+
|
|
8
|
+
## ✨ Fonctionnalités
|
|
9
|
+
|
|
10
|
+
- 🎯 **Tableaux Markdown** avec alignements complets (gauche, centre, droite)
|
|
11
|
+
- 🎨 **Styles CSS professionnels** automatiques (hover, zebra striping, responsive)
|
|
12
|
+
- 📦 **Sans dépendances** - Tout en un seul fichier minifié
|
|
13
|
+
- 🚀 **Auto-chargement** depuis fichiers markdown
|
|
14
|
+
- 🔢 **Syntaxe KaTeX** pour équations mathématiques
|
|
15
|
+
- 📊 **Diagrammes Mermaid** pour visualisations
|
|
16
|
+
- 📄 **YAML Front Matter** pour métadonnées
|
|
17
|
+
|
|
18
|
+
## 🚀 Installation
|
|
19
|
+
|
|
20
|
+
### Via NPM
|
|
21
|
+
|
|
22
|
+
```bash
|
|
23
|
+
npm install ontowave
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
### Via CDN (unpkg.com)
|
|
27
|
+
|
|
28
|
+
```html
|
|
29
|
+
<!-- Dernière version (recommandé pour démo) -->
|
|
30
|
+
<script src="https://unpkg.com/ontowave/dist/ontowave.min.js"></script>
|
|
31
|
+
|
|
32
|
+
<!-- Version fixe (recommandé pour production) -->
|
|
33
|
+
<script src="https://unpkg.com/ontowave@1.0.2/dist/ontowave.min.js"></script>
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## 💻 Utilisation Rapide
|
|
37
|
+
|
|
38
|
+
### HTML Minimal
|
|
39
|
+
|
|
40
|
+
```html
|
|
41
|
+
<!DOCTYPE html>
|
|
42
|
+
<html>
|
|
43
|
+
<head>
|
|
44
|
+
<meta charset="UTF-8">
|
|
45
|
+
<title>OntoWave Demo</title>
|
|
46
|
+
</head>
|
|
47
|
+
<body>
|
|
48
|
+
<div id="content"></div>
|
|
49
|
+
<script src="https://unpkg.com/ontowave/dist/ontowave.min.js"></script>
|
|
50
|
+
</body>
|
|
51
|
+
</html>
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### JavaScript/TypeScript
|
|
55
|
+
|
|
56
|
+
```javascript
|
|
57
|
+
import ontowave from 'ontowave';
|
|
58
|
+
|
|
59
|
+
// Rendu markdown
|
|
60
|
+
const html = ontowave.render('# Hello World');
|
|
61
|
+
document.getElementById('content').innerHTML = html;
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## 📋 Exemples
|
|
65
|
+
|
|
66
|
+
### Tableau avec Alignements
|
|
67
|
+
|
|
68
|
+
```markdown
|
|
69
|
+
| Produit | Quantité | Prix |
|
|
70
|
+
|:--------|:--------:|-----:|
|
|
71
|
+
| Ordinateur | 2 | 1799.98€ |
|
|
72
|
+
| Souris | 5 | 127.50€ |
|
|
73
|
+
| **TOTAL** | **7** | **1927.48€** |
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
**Rendu :**
|
|
77
|
+
|
|
78
|
+
| Produit | Quantité | Prix |
|
|
79
|
+
|:--------|:--------:|-----:|
|
|
80
|
+
| Ordinateur | 2 | 1799.98€ |
|
|
81
|
+
| Souris | 5 | 127.50€ |
|
|
82
|
+
| **TOTAL** | **7** | **1927.48€** |
|
|
83
|
+
|
|
84
|
+
### Syntaxe d'Alignement
|
|
85
|
+
|
|
86
|
+
- `:---` ou `---` → Gauche (défaut)
|
|
87
|
+
- `:---:` → Centre
|
|
88
|
+
- `---:` → Droite
|
|
89
|
+
|
|
90
|
+
## 🔗 Liens Utiles
|
|
91
|
+
|
|
92
|
+
- 📦 **NPM Package** : [npmjs.com/package/ontowave](https://www.npmjs.com/package/ontowave)
|
|
93
|
+
- 🌐 **Site Web** : [ontowave.org](https://ontowave.org)
|
|
94
|
+
- 📚 **Démo Tableaux** : [ontowave.org/demo-tables.md](https://ontowave.org/demo-tables.md)
|
|
95
|
+
- 🐙 **GitHub Repository** : [github.com/stephanedenis/OntoWave](https://github.com/stephanedenis/OntoWave)
|
|
96
|
+
- 🎨 **Pages de Test** :
|
|
97
|
+
- [test-npm-minimal.html](test-npm-minimal.html) - HTML minimal
|
|
98
|
+
- [test-npm-auto.html](test-npm-auto.html) - Avec auto-loading
|
|
99
|
+
- [demo-npm-simple.html](demo-npm-simple.html) - Démo simple
|
|
100
|
+
|
|
101
|
+
## 📖 Documentation
|
|
102
|
+
|
|
103
|
+
### Styles CSS Automatiques
|
|
104
|
+
|
|
105
|
+
OntoWave applique automatiquement des styles professionnels :
|
|
106
|
+
|
|
107
|
+
- **Classes CSS** : `.text-left`, `.text-center`, `.text-right`
|
|
108
|
+
- **Bordures** : Bordures collapse avec couleurs harmonieuses
|
|
109
|
+
- **Hover** : Effet de survol sur les lignes
|
|
110
|
+
- **Zebra Striping** : Lignes alternées pour meilleure lisibilité
|
|
111
|
+
- **Responsive** : S'adapte aux petits écrans
|
|
112
|
+
|
|
113
|
+
### Configuration
|
|
114
|
+
|
|
115
|
+
OntoWave fonctionne automatiquement au chargement :
|
|
116
|
+
|
|
117
|
+
1. Détecte `div#content` dans votre HTML
|
|
118
|
+
2. Cherche `index.md` (ou fichier configuré)
|
|
119
|
+
3. Charge et transforme le markdown en HTML
|
|
120
|
+
4. Applique les styles de tableaux automatiquement
|
|
121
|
+
|
|
122
|
+
## 🆕 Release Notes
|
|
123
|
+
|
|
124
|
+
### v1.0.2 - 16 octobre 2025
|
|
125
|
+
|
|
126
|
+
#### 🎯 Corrections Majeures
|
|
127
|
+
- ✅ **Fix complet des alignements de tableaux markdown**
|
|
128
|
+
- Support des 3 syntaxes : `:---`, `:---:`, `---:`
|
|
129
|
+
- Application correcte des classes CSS `.text-left`, `.text-center`, `.text-right`
|
|
130
|
+
- Gestion des cellules vides et contenu mixte
|
|
131
|
+
|
|
132
|
+
#### 🚀 Améliorations Infrastructure
|
|
133
|
+
- ✅ **Suppression des commentaires CSS dans JavaScript**
|
|
134
|
+
- Nettoyage des fichiers source (`ontowave.js`)
|
|
135
|
+
- Mise à jour du build distribué (`dist/ontowave.min.js`)
|
|
136
|
+
- Script automatisé : `scripts/clean-css-comments.sh`
|
|
137
|
+
|
|
138
|
+
- ✅ **Workflow GitHub Actions NPM automatique**
|
|
139
|
+
- Publication automatique sur NPM lors des PR merge
|
|
140
|
+
- Tests non-bloquants avec `continue-on-error: true`
|
|
141
|
+
- Commit automatique des build artifacts
|
|
142
|
+
- Permissions correctes : `contents: write, packages: write`
|
|
143
|
+
|
|
144
|
+
- ✅ **CDN unpkg.com disponible**
|
|
145
|
+
- Version automatique : `https://unpkg.com/ontowave/dist/ontowave.min.js`
|
|
146
|
+
- Version fixe : `https://unpkg.com/ontowave@1.0.2/dist/ontowave.min.js`
|
|
147
|
+
- Résolution sémantique : `@latest`, `@1`, `@1.0`
|
|
148
|
+
|
|
149
|
+
#### 🧪 Tests et Validation
|
|
150
|
+
- ✅ **Pages de test minimales créées**
|
|
151
|
+
- `test-npm-minimal.html` - HTML minimal (11 lignes)
|
|
152
|
+
- `test-npm-auto.html` - Avec auto-loading markdown
|
|
153
|
+
- Test Playwright : Validation du chargement depuis unpkg.com
|
|
154
|
+
|
|
155
|
+
#### 📚 Documentation
|
|
156
|
+
- ✅ **Documentation complète**
|
|
157
|
+
- `README.md` - Guide principal avec exemples
|
|
158
|
+
- `docs/index.md` - Documentation site web
|
|
159
|
+
- `docs/demo-tables.md` - Démonstration complète des tableaux
|
|
160
|
+
- `SUCCESS_NPM_PUBLISH.md` - Journal du succès NPM
|
|
161
|
+
- `HISTORIQUE_ERREURS_WORKFLOW.md` - Historique debug workflow
|
|
162
|
+
- `README_TEST_NPM_MINIMAL.md` - Guide des pages de test
|
|
163
|
+
|
|
164
|
+
#### 🛠️ Outils Développeur
|
|
165
|
+
- ✅ **Scripts d'automatisation**
|
|
166
|
+
- `scripts/clean-css-comments.sh` - Nettoyage CSS
|
|
167
|
+
- `scripts/configure-agent-autonomy.sh` - Config anti-pager
|
|
168
|
+
- `scripts/watch-workflow-safe.sh` - Surveillance workflow
|
|
169
|
+
|
|
170
|
+
#### 🎉 Règles d'Autonomie Agents
|
|
171
|
+
- ✅ **Documentation REGLES_AUTONOMIE_AGENTS.md**
|
|
172
|
+
- Interdictions strictes : pagers (vi, less, more)
|
|
173
|
+
- Solutions obligatoires : `export PAGER=""`, `git config core.editor ""`
|
|
174
|
+
- Checklist complète pour agents autonomes
|
|
175
|
+
|
|
176
|
+
### v1.0.1 - 16 octobre 2025
|
|
177
|
+
|
|
178
|
+
#### Première Publication Réussie
|
|
179
|
+
- 🎉 Package publié sur NPM
|
|
180
|
+
- ✅ Workflow GitHub Actions fonctionnel
|
|
181
|
+
- ✅ Build automatique et déploiement
|
|
182
|
+
|
|
183
|
+
## 🛠️ Développement
|
|
184
|
+
|
|
185
|
+
### Build
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
# Installation
|
|
189
|
+
npm install
|
|
190
|
+
|
|
191
|
+
# Build
|
|
192
|
+
npm run build
|
|
193
|
+
|
|
194
|
+
# Tests
|
|
195
|
+
npm test
|
|
196
|
+
|
|
197
|
+
# Tests E2E (Playwright)
|
|
198
|
+
npx playwright test
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
### Structure du Projet
|
|
202
|
+
|
|
203
|
+
```
|
|
204
|
+
ontowave/
|
|
205
|
+
├── src/
|
|
206
|
+
│ └── ontowave.js # Source principale
|
|
207
|
+
├── dist/
|
|
208
|
+
│ └── ontowave.min.js # Build minifié
|
|
209
|
+
├── docs/
|
|
210
|
+
│ ├── index.html # Site web principal
|
|
211
|
+
│ ├── index.md # Documentation
|
|
212
|
+
│ └── demo-tables.md # Démo tableaux
|
|
213
|
+
├── tests/
|
|
214
|
+
│ └── e2e/
|
|
215
|
+
│ ├── test-minimal.spec.js
|
|
216
|
+
│ └── test-demo-npm.spec.js
|
|
217
|
+
├── scripts/
|
|
218
|
+
│ ├── clean-css-comments.sh
|
|
219
|
+
│ └── configure-agent-autonomy.sh
|
|
220
|
+
├── test-npm-minimal.html # Test minimal
|
|
221
|
+
├── test-npm-auto.html # Test auto-loading
|
|
222
|
+
└── package.json
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## 🤝 Contribution
|
|
226
|
+
|
|
227
|
+
Les contributions sont les bienvenues! Veuillez :
|
|
228
|
+
|
|
229
|
+
1. Fork le projet
|
|
230
|
+
2. Créer une branche (`git checkout -b feature/AmazingFeature`)
|
|
231
|
+
3. Commit vos changements (`git commit -m 'Add AmazingFeature'`)
|
|
232
|
+
4. Push vers la branche (`git push origin feature/AmazingFeature`)
|
|
233
|
+
5. Ouvrir une Pull Request
|
|
234
|
+
|
|
235
|
+
### Guidelines
|
|
236
|
+
|
|
237
|
+
- Suivre les règles d'autonomie agents (voir `REGLES_AUTONOMIE_AGENTS.md`)
|
|
238
|
+
- Pas de pagers interactifs (vi, less, more)
|
|
239
|
+
- Tests automatisés requis
|
|
240
|
+
- Documentation à jour
|
|
241
|
+
|
|
242
|
+
## 📄 Licence
|
|
243
|
+
|
|
244
|
+
MIT License - Copyright (c) 2025 Stéphane Denis
|
|
245
|
+
|
|
246
|
+
Voir [LICENSE](LICENSE) pour plus de détails.
|
|
247
|
+
|
|
248
|
+
## 👨💻 Auteur
|
|
249
|
+
|
|
250
|
+
**Stéphane Denis**
|
|
251
|
+
|
|
252
|
+
- GitHub: [@stephanedenis](https://github.com/stephanedenis)
|
|
253
|
+
- NPM: [npmjs.com/~stephanedenis](https://www.npmjs.com/~stephanedenis)
|
|
254
|
+
|
|
255
|
+
## 🙏 Remerciements
|
|
256
|
+
|
|
257
|
+
- Projet créé dans le cadre de l'écosystème Panini
|
|
258
|
+
- Inspiration : Philosophie de l'autonomie des agents
|
|
259
|
+
- Technologies : marked.js, KaTeX, Mermaid, YAML
|
|
260
|
+
|
|
261
|
+
---
|
|
262
|
+
|
|
263
|
+
**OntoWave** - *Parce que le markdown mérite un rendu professionnel* 🌊
|
|
264
|
+
|
|
265
|
+
[](https://www.npmjs.com/package/ontowave)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ontowave",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.5",
|
|
4
4
|
"description": "Lightweight JavaScript library for creating interactive documentation from Markdown with multilingual support, Prism syntax highlighting, Mermaid diagrams, and PlantUML rendering",
|
|
5
5
|
"main": "dist/ontowave.js",
|
|
6
6
|
"unpkg": "dist/ontowave.min.js",
|