boisgera / itn-web

https://boisgera.github.io/itn-web/
GNU General Public License v3.0
0 stars 3 forks source link

Institut des Transformations numériques

A web site built with Astro & Astroship.

This repository is the antechamber of https://itn.dev/ ; the actual site is hosted at https://github.com/ITN-Mines-Paris/ITN-Mines-Paris.github.io which is synchronized manually with this repository.

Live Demo

https://boisgera.github.io/itn-web/

Installation

You can work on the project in the cloud (preferred method) or locally (if you know what you're doing).

0. Prerequisites

To work in the cloud, you need a GitHub account to get (a 60-hour a month free) access to GitHub Codespaces.

To work locally, you need to install:

1. Clone the repository

In the cloud, create a new Codespace. Alternatively, to work locally, clone the repo:

git clone git@github.com:boisgera/itn-web.git

2. Install Dependencies

Codespace should automatically install your dependencies. If you work locally, type:

npm install

3. Start a Web Server

The command

npm run dev

starts a Web development server. In Codespaces it will also prompt you to open a browser window (locally, you are on your own). In both cases, each time you save a file, the browser will reload the site so that you can immediately see the effect of your changes.

You are now ready to start working on the project.

4. Development cycle

Project Structure

Inside of your Astro project, you'll see the following folders and files:

/
├── public/
│   └── ...
├── src/
│   ├── assets/
│   │   └── ...
│   ├── components/
│   │   └── ...
│   ├── layouts/
│   │   └── ...
│   └── pages/
│       └── ...
└── package.json

Astro looks for .astro,.md or .mdx files in the src/pages/ directory. Each page is exposed as a route based on its file name.

Static assets can be placed in the public/ directory. Images placed in the assets/directory are optimized and served as static assets.

Refer to Astro documentation for more information.