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.
You can work on the project in the cloud (preferred method) or locally (if you know what you're doing).
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:
In the cloud, create a new Codespace. Alternatively, to work locally, clone the repo:
git clone git@github.com:boisgera/itn-web.git
Codespace should automatically install your dependencies. If you work locally, type:
npm install
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.
Synchronize: download the most recent version of the project files
(git pull
locally),
Edit the files, then commit your changes
(git add
+ git commit
locally),
Synchronize: upload these changes to the project repository
(git push
locally).
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.