yann/gpx.studio
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

README.md

Browse Source
This commit is contained in:
yann 2025-06-02 16:29:39 +02:00
parent 6c2f8a8919
commit ff608327c1
1 changed files with 36 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
README.md
View File

@ -3,35 +3,27 @@
<img alt="Logo of gpx.studio." src="website/static/logo.svg"> <img alt="Logo of gpx.studio." src="website/static/logo.svg">
</picture> </picture>
[**gpx.studio**](https://gpx.studio) is an online tool for creating and editing GPX files. * [**gpx.studio**](https://gpx.studio) est un outil en ligne pour créer et éditer des fichiers GPX.
* <https://github.com/gpxstudio>
![gpx.studio screenshot](website/src/lib/assets/img/docs/getting-started/interface.png) ![gpx.studio screenshot](website/src/lib/assets/img/docs/getting-started/interface.png)
This repository contains the source code of the website. Ce dépôt contient le code source du site.
## Contributing ## Traduction
Please create an issue if you find a bug or have a feature request. Le site Web est traduit par des bénévoles sur une plateforme de traduction collaborative.
Vous pouvez aider à compléter et à améliorer les traductions en rejoignant le projet [Crowdin](https://crowdin.com/project/gpxstudio).
Code contributions are also welcome, but except for obvious bug fixes, please open an issue first to discuss the changes you would like to make. ## Développement
## Translation Le code est divisé en deux parties:
- `gpx`: une bibliothèque de caractères pour analyser et manipuler les fichiers GPX,
- `site web`: le site lui-même, qui est une application [SvelteKit](https://kit.svelte.dev/).
The website is translated by volunteers on a collaborative translation platform. Vous aurez besoin de [Node.js](https://nodejs.org/) pour construire et exécuter ces deux parties.
You can help complete and improve the translations by joining the [Crowdin project](https://crowdin.com/project/gpxstudio).
If you would like to start the translation in a new language, please contact me or create an issue.
Any help is greatly appreciated! ### Construction de la bibliothèque `gpx`
## Development
The code is split into two parts:
- `gpx`: a Typescript library for parsing and manipulating GPX files,
- `website`: the website itself, which is a [SvelteKit](https://kit.svelte.dev/) application.
You will need [Node.js](https://nodejs.org/) to build and run these two parts.
### Building the `gpx` library
```bash ```bash
cd gpx cd gpx
@ -39,9 +31,9 @@ npm install
npm run build npm run build
``` ```
### Running the website ### Fonctionnement du site
To be able to load the map, you will need to create your own <a href="https://account.mapbox.com/auth/signup" target="_blank">Mapbox access token</a> and store it in a `.env` file in the `website` directory. Pour pouvoir charger la carte, vous devrez créer votre propre <a href="https://account.mapbox.com/auth/signup" target="_blank">Jeton d'accès Mapbox</a> et le stocker dans un fichier `.env` dans le répertoire `site web`.
```bash ```bash
cd website cd website
@ -50,31 +42,30 @@ npm install
npm run dev npm run dev
``` ```
## Credits ## Crédits
This project has been made possible thanks to the following open source projects: Ce projet a été rendu possible grâce aux projets open source suivants:
- Development: - Développement:
- [Svelte](https://github.com/sveltejs/svelte) and [SvelteKit](https://github.com/sveltejs/kit) — seamless development experience - [Svelte](https://github.com/sveltejs/svelte) and [SvelteKit](https://github.com/sveltejs/kit) — expérience de développement sans faille
- [MDsveX](https://github.com/pngwn/MDsveX) — allowing a Markdown-based documentation - [MDsveX](https://github.com/pngwn/MDsveX) — permettant une documentation basée sur Markdown
- [svelte-i18n](https://github.com/kaisermann/svelte-i18n) — easy localization - [svelte-i18n](https://github.com/kaisermann/svelte-i18n) — localisation facile
- Design: - Conception:
- [shadcn-svelte](https://github.com/huntabyte/shadcn-svelte) — beautiful components - [shadcn-svelte](https://github.com/huntabyte/shadcn-svelte) — beautiful components
- [lucide-svelte](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-svelte) — beautiful icons - [lucide-svelte](https://github.com/lucide-icons/lucide/tree/main/packages/lucide-svelte) — belles icônes
- [tailwindcss](https://github.com/tailwindlabs/tailwindcss) — easy styling - [tailwindcss](https://github.com/tailwindlabs/tailwindcss) — un style facile
- [Chart.js](https://github.com/chartjs/Chart.js) — beautiful and fast charts - [Chart.js](https://github.com/chartjs/Chart.js) — beaux et rapides graphiques
- Logic: - Logique:
- [immer](https://github.com/immerjs/immer) — complex state management - [immer](https://github.com/immerjs/immer) — gestion d'État complexe
- [Dexie.js](https://github.com/dexie/Dexie.js) — IndexedDB wrapper - [Dexie.js](https://github.com/dexie/Dexie.js) — Emballage IndexedDB
- [fast-xml-parser](https://github.com/NaturalIntelligence/fast-xml-parser) — fast GPX file parsing - [fast-xml-parser](https://github.com/NaturalIntelligence/fast-xml-parser) — analyse rapide de fichier GPX
- [SortableJS](https://github.com/SortableJS/Sortable) — creating a sortable file tree - [SortableJS](https://github.com/SortableJS/Sortable) — création d'un arborescence de fichiers triables
- Mapping: - Cartographie:
- [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) — beautiful and fast interactive maps - [Mapbox GL JS](https://github.com/mapbox/mapbox-gl-js) — de belles cartes interactives rapides
- [brouter](https://github.com/abrensch/brouter) — routing engine - [brouter](https://github.com/abrensch/brouter) — moteur de routage
- [OpenStreetMap](https://www.openstreetmap.org) — map data used by Mapbox and brouter - [OpenStreetMap](https://www.openstreetmap.org) — données cartographiques utilisées par Mapbox et brouter
- Search: - [DocSearch](https://github.com/algolia/docsearch) — moteur de recherche de la documentation
- [DocSearch](https://github.com/algolia/docsearch) — search engine for the documentation
## License ## Licence
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. Ce projet est sous licence MIT - voir le fichier [LICENSE](LICENSE) pour plus de détails.