utils-lib

KO | EN

gitlite — search

#git #ruby #codex #cloud-native #reactjs #agent #awesome-list #rust #claude #pytorch

(★ 9)

Forge JS, une bibliothèque pédagogique de 10 fonctions JavaScript avec documentation interactive.

File Explorer

ZIP Download

- - documentation.css
  - foundation.css
  - home.css
  - main.css
  - responsive.css
- - demo.js
.gitattributes
.gitignore
.nojekyll
index.html
library.html
README.md
robots.txt
sitemap.xml

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Bibliothèque pédagogique de 10 fonctions JavaScript natives accompagnée d'un mini-site de documentation interactif. Chaque fiche présente le code source, la signature, les paramètres, deux exemples réellement calculés et un exécuteur isolé dans le navigateur.

![Aperçu de la documentation Forge JS](https://raw.githubusercontent.com/Osiris-Balonga/utils-lib/main/assets/images/previews/readme-preview-documentation.png)

![Aperçu de l'exécuteur Forge JS](https://raw.githubusercontent.com/Osiris-Balonga/utils-lib/main/assets/images/previews/readme-preview-runner.png)

## Démo

- GitHub Pages : https://osiris-balonga.github.io/utils-lib/
- Repository : https://github.com/Osiris-Balonga/utils-lib

## Objectif

Ce projet répond au livrable `Semaine 7 - Projet avancé` du catalogue JavaScript Phase 2 d'Akieni Academy. L'objectif est de créer une boîte à outils de fonctions réutilisables et son mini-site de documentation, tout en pratiquant les paramètres, les valeurs de retour, la portée et la logique algorithmique.

## Fonctionnalités

- page d'accueil présentant la collection et ses tests ;
- documentation organisée par fonction ;
- navigation latérale avec une seule fiche visible à la fois ;
- sommaire local synchronisé avec le défilement ;
- code source réel de chaque fonction ;
- deux exemples calculés par JavaScript pour chaque fonction ;
- exécuteur modifiable lancé dans une iframe isolée ;
- copie des exemples et du code source ;
- recherche avec surlignage des correspondances ;
- menu mobile accessible ;
- gestion de `prefers-reduced-motion`.

## Fonctions disponibles

| Fonction | Catégorie | Description |
|---|---|---|
| `estPair(nombre)` | Nombres | Vérifie si un nombre est pair |
| `maxDeDeux(a, b)` | Nombres | Retourne le plus grand de deux nombres |
| `factorielle(nombre)` | Nombres | Calcule la factorielle d'un entier |
| `calculerMoyenne(nombres)` | Nombres | Calcule la moyenne d'un tableau |
| `inverserChaine(texte)` | Chaînes | Inverse une chaîne de caractères |
| `compterVoyelles(texte)` | Chaînes | Compte les voyelles, accents compris |
| `estPalindrome(texte)` | Chaînes | Vérifie si un texte est un palindrome |
| `capitaliser(texte)` | Chaînes | Met en majuscule la première lettre de chaque mot |
| `convertirTemperature(celsius)` | Conversions | Convertit des degrés Celsius en Fahrenheit |
| `calculerTVA(prix, taux)` | Conversions | Calcule le montant de TVA et le prix TTC |

## Architecture JavaScript

Les fonctions sont séparées par domaine :

- `numbers.js` regroupe les fonctions numériques ;
- `strings.js` regroupe les fonctions de texte ;
- `conversions.js` regroupe les conversions ;
- `demo.js` gère la documentation, les exemples, l'exécuteur et les interactions.

Chaque fichier de fonctions enrichit l'objet global `ForgeJS`. Cette organisation conserve un fonctionnement direct avec `file://` tout en évitant un fichier utilitaire monolithique.

## Technologies

- HTML5 sémantique ;
- CSS3 avec feuilles spécialisées ;
- JavaScript vanilla ;
- CSS Grid et Flexbox ;
- Phosphor Icons ;
- Google Fonts : Inter et JetBrains Mono ;
- iframe avec `sandbox` pour l'exécuteur ;
- Git et GitHub Pages.

## Structure

```text
utils-lib/
  assets/
    css/
      documentation.css
      foundation.css
      home.css
      main.css
      responsive.css
    images/
      brand/
        favicon/
      previews/
    js/
      functions/
        conversions.js
        numbers.js
        strings.js
      demo.js
  index.html
  library.html
  robots.txt
  sitemap.xml
  README.md
```

## Lancement local

Ouvrir directement `index.html` dans un navigateur récent.

Pour le développement, un serveur statique peut aussi être lancé depuis le dossier du projet :

```bash
python -m http.server 8000
```

Puis ouvrir `http://127.0.0.1:8000/`.

## Responsive et accessibilité

L'interface est testée de 375 px à 1440 px. La navigation devient un panneau mobile sous 800 px, les blocs de code conservent leur défilement horizontal et les contrôles possèdent des états de focus visibles.

## Auteur

Osiris Balonga - [GitHub](https://github.com/Osiris-Balonga)

utils-lib

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

utils-lib

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README