winzik/docs/ide/fr/getting-started.md
David Nurdin 7de153fc14 IDE documentation: one page per feature (docs/ide/, French in docs/ide/fr/) and a Doc browser inside the IDE
- docs/ide/: 49 user pages grouped in toc.json (editing, languages, run / test / debug, Git, web sites and Symfony, databases,
  Docker and SSH, games, AI, team, settings); pages of features still being built are "coming soon" stubs with a TODO list;
  15 pages translated into French; docs/ide.md and docs/ide.fr.md link to them.
- The Doc button at the top right of the IDE, Help > Documentation, Search Everywhere "Documentation" and a "?" in each tool
  window's header open the Doc browser (ide/ui/js/docs-browser.js): table of contents, rendered pages (pictures, code, tables,
  links between pages and to headings), full-text search, back / forward, the IDE's language with English as the fallback.
- ide/src/Docs/DocsLibrary.php (docs.index, docs.image): reads only the documentation folder (strict names, real path checked);
  the packaged copy ui/docs first, else the repository's docs/ide.
- Packaging: tools/stage-game.sh copies docs/ide into the exported IDE (its *.md exclusion would drop them), overlay-build.php
  puts them in code updates, bin/jumphp ide syncs them.
- Tests: docs-model.test.mjs (TOC, links, anchors, pictures, search; every page and picture of docs/ide exists), DocsLibraryTest
  (path traversal refused), the i18n test covers the new texts in 14 languages.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01JkYTqsvYu6AYr9yQ3Q4Nt6
2026-11-16 00:08:42 +01:00

35 lines
2 KiB
Markdown

# Bien démarrer
## Installer et lancer
- **Bureau** : installez l'IDE avec son installeur (jumphp.net), ou depuis un clone de JumPHP lancez `bin/jumphp ide` (l'IDE tourne
depuis les sources du clone ; `bin/jumphp ide --install` ajoute `jumphp-ide` et une entrée de menu). L'IDE installé se met à jour
tout seul.
- **Web** : `https://jumphp.net/ide` dans un navigateur, connecté avec votre compte jumphp.net. Il travaille sur vos projets publiés,
avec des brouillons par-dessus ; branches, lancements locaux, Docker et SSH sont réservés au bureau.
## L'écran d'accueil
Sans projet ouvert, l'IDE montre son écran d'accueil :
- **Se connecter avec jumphp.net** (bureau : votre navigateur s'ouvre, vous autorisez, l'IDE reçoit un jeton révocable dans le
studio). Vos projets (vos dépôts Git) sont listés ; un clic clone et ouvre.
- **Ouvrir un dossier** : n'importe quel dossier devient un projet.
- **Cloner un dépôt** : n'importe quelle adresse Git.
- **Nouveau projet** : un jeu, une application graphique / mobile / bureau / CLI, un plugin de l'IDE, un jeu hybride, une extension
du moteur, un remake Amstrad CPC, un portage, ou un **site web** (voir [Sites web](web-sites.md)). Il est créé **sur cet ordinateur
seulement** ; rien ne part en ligne avant de [publier](publish.md).
- **Nouveautés** : les nouvelles de JumPHP et les mises à jour de l'IDE, dans votre langue.
## Éditeur rapide et « Ouvrir avec JumPHP »
`jumphp-ide <fichier>` ouvre un fichier dans une fenêtre légère : Monaco seul, sans projet ni index ni Git. `Ctrl+S` enregistre (un
fichier modifié entre-temps par un autre programme n'est pas écrasé sans votre accord), `Ctrl+O` en ouvre un autre, **Ouvrir le
dossier comme projet** ouvre l'IDE complet. HTML, CSS, Twig et Markdown ont **Code / Les deux / Aperçu**.
**Outils > Intégrer au système…** ajoute « Ouvrir avec JumPHP » au gestionnaire de fichiers, pour votre utilisateur seulement
(Windows, Linux ; pas encore macOS).
## Ensuite
[L'interface](interface.md), [Éditeur](editor.md), [Lancer](run.md).