From fcd1372e03577e1b07e01bae210a83104134c139 Mon Sep 17 00:00:00 2001 From: Kowalski Prime Date: Thu, 7 Nov 2019 00:02:51 +0100 Subject: [PATCH] Update readme, closes #4, closes #5, closes #6 --- README.md | 109 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 56 insertions(+), 53 deletions(-) diff --git a/README.md b/README.md index 2b670dd..b9e73ec 100644 --- a/README.md +++ b/README.md @@ -1,34 +1,41 @@

- Gatsby + Gatsby +

+ BicoccaHUB +

-

- Gatsby's default starter -

-Kick off your project with this default boilerplate. This starter ships with the main Gatsby configuration files you might need to get up and running blazing fast with the blazing fast app generator for React. -_Have another more specific idea? You may want to check out our vibrant collection of [official and community-created starters](https://www.gatsbyjs.org/docs/gatsby-starters/)._ +La piΓΉ grande collezione di appunti del corso di informatica degli studenti della Bicocca ## πŸš€ Quick start -1. **Create a Gatsby site.** +1. **Clona i sorgenti.** - Use the Gatsby CLI to create a new site, specifying the default starter. + Usa il comando `git clone` per clonare i sorgenti del sito ```shell - # create a new Gatsby site using the default starter - gatsby new my-default-starter https://github.com/gatsbyjs/gatsby-starter-default + # Clona la repository mediante Git + git clone https://github.com/BicoccaHUB/bicoccahub.git ``` -1. **Start developing.** +1. **Intalla le dipendenze.** - Navigate into your new site’s directory and start it up. + Naviga nel sito e installa le dipendenze necessarie mediante NPM + + ```shell + cd bicoccahub/ + npm install + ``` + +1. **Inizia a sviluppare.** + + Avvia il server di sviluppo con il comando `gatsby develop` ```shell - cd my-default-starter/ gatsby develop ``` @@ -40,58 +47,54 @@ _Have another more specific idea? You may want to check out our vibrant collecti Open the `my-default-starter` directory in your code editor of choice and edit `src/pages/index.js`. Save your changes and the browser will update in real time! -## 🧐 What's inside? +## 🧐 Come modifico il sito? A quick look at the top-level files and directories you'll see in a Gatsby project. . - β”œβ”€β”€ node_modules - β”œβ”€β”€ src - β”œβ”€β”€ .gitignore - β”œβ”€β”€ .prettierrc - β”œβ”€β”€ gatsby-browser.js - β”œβ”€β”€ gatsby-config.js - β”œβ”€β”€ gatsby-node.js - β”œβ”€β”€ gatsby-ssr.js - β”œβ”€β”€ LICENSE - β”œβ”€β”€ package-lock.json - β”œβ”€β”€ package.json - └── README.md - -1. **`/node_modules`**: This directory contains all of the modules of code that your project depends on (npm packages) are automatically installed. - -2. **`/src`**: This directory will contain all of the code related to what you will see on the front-end of your site (what you see in the browser) such as your site header or a page template. `src` is a convention for β€œsource code”. - -3. **`.gitignore`**: This file tells git which files it should not track / not maintain a version history for. - -4. **`.prettierrc`**: This is a configuration file for [Prettier](https://prettier.io/). Prettier is a tool to help keep the formatting of your code consistent. - -5. **`gatsby-browser.js`**: This file is where Gatsby expects to find any usage of the [Gatsby browser APIs](https://www.gatsbyjs.org/docs/browser-apis/) (if any). These allow customization/extension of default Gatsby settings affecting the browser. - -6. **`gatsby-config.js`**: This is the main configuration file for a Gatsby site. This is where you can specify information about your site (metadata) like the site title and description, which Gatsby plugins you’d like to include, etc. (Check out the [config docs](https://www.gatsbyjs.org/docs/gatsby-config/) for more detail). - -7. **`gatsby-node.js`**: This file is where Gatsby expects to find any usage of the [Gatsby Node APIs](https://www.gatsbyjs.org/docs/node-apis/) (if any). These allow customization/extension of default Gatsby settings affecting pieces of the site build process. - -8. **`gatsby-ssr.js`**: This file is where Gatsby expects to find any usage of the [Gatsby server-side rendering APIs](https://www.gatsbyjs.org/docs/ssr-apis/) (if any). These allow customization of default Gatsby settings affecting server-side rendering. + β”‚ + └┬─ src + └┬─ data + β”œβ”€β”€ staff.yml + └── subjects.yml -9. **`LICENSE`**: Gatsby is licensed under the MIT license. +1. **`staff.yml`**: Questo file contiene i dati relativi alle persone che hanno contribuito, diviso in varie sezioni (coders, autori e ringraziamenti speciali) -10. **`package-lock.json`** (See `package.json` below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed for your project. **(You won’t change this file directly).** +2. **`subjects.yml`**: Questo file contiene i dati relativi agli indirizzi degi repository contenenti gli appunti. Il file Γ¨ diviso per anno e per materie. Ogni materia successivamente contiene i vari repositori (indirizzo, autore e se sono in corso di sviluppo) -11. **`package.json`**: A manifest file for Node.js projects, which includes things like metadata (the project’s name, author, etc). This manifest is how npm knows which packages to install for your project. +## πŸŽ“ Aggiunta di una repository -12. **`README.md`**: A text file containing useful reference information about your project. +Come specificato nella sezione precedente, il file da modificare per aggiungere nuove repository Γ¨ il file `subjects.yml`, che Γ¨ scritto mediante la sintassi di [YAML](https://yaml.org/) -## πŸŽ“ Learning Gatsby +```yaml +- year: + subjects: + - name: + repositories: + - owner: + url: +``` -Looking for more guidance? Full documentation for Gatsby lives [on the website](https://www.gatsbyjs.org/). Here are some places to start: +Per aggiungere un nuovo repository sarΓ  quindi sufficiente seguire lo schema sopra citato seguendo le corrette regole di spaziatura, aggiungendo un record di questo tipo: -- **For most developers, we recommend starting with our [in-depth tutorial for creating a site with Gatsby](https://www.gatsbyjs.org/tutorial/).** It starts with zero assumptions about your level of ability and walks through every step of the process. +```yaml +- owner: + url: +``` -- **To dive straight into code samples, head [to our documentation](https://www.gatsbyjs.org/docs/).** In particular, check out the _Guides_, _API Reference_, and _Advanced Tutorials_ sections in the sidebar. +ottenendo quindi il seguente risultato -## πŸ’« Deploy +```yaml +- year: + subjects: + - name: + repositories: + - owner: + url: + - owner: + url: +``` -[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/gatsbyjs/gatsby-starter-default) +Prima di inviare una [pull request](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/creating-a-pull-request) Γ¨ necessario accertarsi che il sito compili senza nessun `error` e possibilmente senza nessun `warning`. - +Ulteriori guide sono disponibili all'indirizzo [https://bicoccahub.netlify.com/contribuisci](https://bicoccahub.netlify.com/contribuisci) \ No newline at end of file