From fc2b2f9701c19933a240aaa7c97353566fe7cc36 Mon Sep 17 00:00:00 2001 From: Guido Porcaro Date: Sat, 20 Jan 2024 18:37:19 +0100 Subject: [PATCH] fix(site): remote config --- .github/workflows/deploy.yml | 62 ++++++++++++++++++ Gemfile.lock | 4 ++ _config.yml | 14 ++++ .../it/testing => assets/images}/piramide.png | Bin docs/_config.yml | 4 -- docs/it/introduzione.md | 49 -------------- docs/it/testing.md | 2 +- index.md | 51 ++++++++++++++ 8 files changed, 132 insertions(+), 54 deletions(-) create mode 100644 .github/workflows/deploy.yml create mode 100644 _config.yml rename {docs/it/testing => assets/images}/piramide.png (100%) delete mode 100644 docs/_config.yml delete mode 100644 docs/it/introduzione.md diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml new file mode 100644 index 00000000..261a1d7a --- /dev/null +++ b/.github/workflows/deploy.yml @@ -0,0 +1,62 @@ +# This workflow uses actions that are not certified by GitHub. +# They are provided by a third-party and are governed by +# separate terms of service, privacy policy, and support +# documentation. + +# Sample workflow for building and deploying a Jekyll site to GitHub Pages +name: Deploy Jekyll site to Pages + +on: + push: + branches: ["feat/matomo"] + + # Allows you to run this workflow manually from the Actions tab + workflow_dispatch: + +# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages +permissions: + contents: read + pages: write + id-token: write + +# Allow one concurrent deployment +concurrency: + group: "pages" + cancel-in-progress: true + +jobs: + # Build job + build: + runs-on: ubuntu-latest + steps: + - name: Checkout + uses: actions/checkout@v4 + - name: Setup Ruby + uses: ruby/setup-ruby@v1 + with: + ruby-version: "3.2" + bundler-cache: true # runs 'bundle install' and caches installed gems automatically + cache-version: 0 # Increment this number if you need to re-download cached gems + - name: Setup Pages + id: pages + uses: actions/configure-pages@v3 + - name: Build with Jekyll + # Outputs to the './_site' directory by default + run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}" + env: + JEKYLL_ENV: production + - name: Upload artifact + # Automatically uploads an artifact from the './_site' directory by default + uses: actions/upload-pages-artifact@v2 + + # Deployment job + deploy: + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + runs-on: ubuntu-latest + needs: build + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v2 diff --git a/Gemfile.lock b/Gemfile.lock index 28482a0d..f50ae961 100644 --- a/Gemfile.lock +++ b/Gemfile.lock @@ -12,6 +12,7 @@ GEM ffi (1.16.3) forwardable-extended (2.6.0) google-protobuf (3.25.2-x86_64-darwin) + google-protobuf (3.25.2-x86_64-linux) http_parser.rb (0.8.0) i18n (1.14.1) concurrent-ruby (~> 1.0) @@ -65,6 +66,8 @@ GEM safe_yaml (1.0.5) sass-embedded (1.70.0-x86_64-darwin) google-protobuf (~> 3.25) + sass-embedded (1.70.0-x86_64-linux-gnu) + google-protobuf (~> 3.25) terminal-table (3.0.2) unicode-display_width (>= 1.1.1, < 3) unicode-display_width (2.5.0) @@ -72,6 +75,7 @@ GEM PLATFORMS x86_64-darwin-22 + x86_64-linux DEPENDENCIES just-the-docs diff --git a/_config.yml b/_config.yml new file mode 100644 index 00000000..cabe4286 --- /dev/null +++ b/_config.yml @@ -0,0 +1,14 @@ +title: Il Libro Open Source + +theme: just-the-docs +baseUrl: "/book" +url: "https://il-libro-open-source.github.io" + +permalink: pretty + +search_enabled: true + +back_to_top: true +back_to_top_text: "Torna all'inizio" + +footer_content: "Copyright © 2023-2023 Il Libro Open Source" diff --git a/docs/it/testing/piramide.png b/assets/images/piramide.png similarity index 100% rename from docs/it/testing/piramide.png rename to assets/images/piramide.png diff --git a/docs/_config.yml b/docs/_config.yml deleted file mode 100644 index b66768b8..00000000 --- a/docs/_config.yml +++ /dev/null @@ -1,4 +0,0 @@ -title: Il Libro Open Source - -theme: just-the-docs -search_enabled: true diff --git a/docs/it/introduzione.md b/docs/it/introduzione.md deleted file mode 100644 index 4c098886..00000000 --- a/docs/it/introduzione.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -layout: default -title: Introduzione -nav_order: 1 ---- - -## Benvenuto - -Chiunque tu sia, da qualunque posto tu provenga, benvenuto in un viaggio incredibile nel mondo dello sviluppo software. - -In queste pagine approfondiremo assieme l'essenza del developer, non puntando alla padronanza tecnica di un linguaggio di programmazione o di uno specifico framework, ma a una comprensione più profonda dei valori che sono alla base di questo mestiere. - -Questo libro è per chiunque voglia intraprendere un percorso nel mondo dello sviluppo, migliorare le proprie competenze, scoprire nuovi orizzonti. - -Da dove nasce questo libro? Da una comunità di persone che hanno deciso di condividere le proprie esperienze, le proprie conoscenze, le proprie storie. Ed è proprio la comunità il cuore pulsante di questo libro, e speriamo che, una volta terminata la lettura, tu possa e voglia sentirti parte di questa comunità. - -## Open Source e collaborazione - -Al centro di questo viaggio c'è un profondo impegno nei confronti dei principi dell'**Open Source**. Crediamo che la conoscenza debba essere condivisa liberamente, che il codice debba essere aperto e che la saggezza collettiva di una comunità allargata sia una potente forza di progresso. Nello spirito di apertura, questo libro è esso stesso un progetto Open Source, che è disponibile oggi e per sempre in maniera gratuita, a testimonianza della nostra convinzione che insieme possiamo creare qualcosa di più grande della somma delle sue parti. - -Ma l’Open Source è solo l’inizio. Sosteniamo inoltre gli ideali di **Open Governance**, riconoscendo che la vera collaborazione prospera in un ambiente di trasparenza, responsabilità e inclusività. Proprio come nel mondo del software, dove il miglior codice emerge da diverse prospettive e idee, noi adottiamo un modello di governance che invita tutte le voci al tavolo. Il nostro team di "Ambassador" incarna questa etica, lavorando fianco a fianco con la comunità per plasmare il futuro di questo libro. - -Questo libro non è un monologo; è una **sinfonia collaborativa**. Ogni capitolo, paragrafo e frase è stato realizzato con cura, con il contributo di persone che hanno dedicato la propria esperienza e il proprio tempo a servizio di chiunque leggerà queste pagine, condividendone la visione. Come membro di questo mondo, anche tu sei invitato a prendere parte a questa conversazione in continua evoluzione. - -Proseguendo con questa lettura tieni sempre a mente quanto segue: il nostro progresso è saldamente ancorato a questi principi fondamentali per tutte le persone coinvolte. Open Source, Open Governance e collaborazione non sono soltanto parole, ma fari che illuminano le acque in cui navighiamo. Abbracciamo quindi questi ideali, rendiamoci disponibili ad imparare gli uni dagli altri e costruiamo, assieme, un futuro in cui lo sviluppo sarà accessibile a tutti e le cui porte rimarranno aperte per chiunque voglia entrare. - -L'Open Source è ovunque. Non ci credi? -OpenUK nel 2021 ha calcolato che il 90% delle aziende del mondo, grandi o piccole, tech o non tech, utilizzano software Open Source. -GitHub nel 2022 ha pubblicato i seguenti numeri: La piattaforma conta 94 milioni di sviluppatori che hanno effettuato 413 milioni di contributi. Dallo stesso report si evince che il 90% delle aziende Fortune 100 utilizza GitHub in qualche forma. - -## I temi - -Che tu sia developer, designer, project manager, tester, product owner o semplicemente una persona curiosa, ricordati che diventare ed essere developer non significa solo scrivere codice. - -Essere developer significa creare una carriera che sia appagante, di lavorare in progetti che ti permettano di esprimere la tua creatività, di avere a che fare con persone che condividono la tua passione e di costruire un futuro migliore per te e per gli altri. - -Essere developer vuol dire andare oltre il codice, oltre la tecnologia, oltre il lavoro. Vuol dire essere parte di una comunità, di un ecosistema, di un mondo in cui la collaborazione e la condivisione sono alla base di tutto. - -Che tu voglia occuparti di DevOps, di UX, di testing, di data science o di qualsiasi altra branca, ricorda che ognuno di noi è partito da zero, e speriamo che queste pagine possano aiutarti a trovare la tua strada. - -## Il viaggio - -A te che hai deciso di intraprendere questo viaggio, sappi che non sei parte passiva in questa avventura cosmica; tu sei una parte vitale della narrazione. Insieme, esploreremo il percorso per lavorare nel mondo dello sviluppo, qualsiasi cosa questo voglia dire, e ovunque questo possa portarci. - -Chi ti accompagnerà in questo viaggio? Chiunque tu voglia. Questo libro è per tutti. Questo libro è per te. Mentre lo leggi, lascia un commento sul nostro [repository su GitHub](https://github.com/Il-Libro-Open-Source/book) e dicci cosa ne pensi. - -Se vuoi contribuire, puoi farlo. Se vuoi tradurre questo libro nella tua lingua, puoi farlo. Se vuoi creare un fork di questo libro e creare una versione personalizzata, puoi farlo. Questo libro è tuo. Questo libro è nostro. Questo libro è di tutti. - -_Ed ora che sei a bordo con noi, ci vediamo dall'altra parte._ diff --git a/docs/it/testing.md b/docs/it/testing.md index 9469675f..d978f294 100644 --- a/docs/it/testing.md +++ b/docs/it/testing.md @@ -13,7 +13,7 @@ Il testing è una parte fondamentale di ogni progetto software. In questo capito Esistono diversi tipi di test, ognuno con un suo scopo ben preciso. Si fa spesso riferimento alla piramide del testing, che rappresenta la proporzione tra di essi: -Piramide del testing +![Piramide del testing](/book/assets/images/piramide.png) Nel resto del capitolo li vedremo nel dettaglio. diff --git a/index.md b/index.md index 1ce77e07..51ac50e1 100644 --- a/index.md +++ b/index.md @@ -1 +1,52 @@ +--- +layout: default +title: Introduzione +nav_order: 1 +permalink: / +--- + # Il Libro Open Source + +## Benvenuto + +Chiunque tu sia, da qualunque posto tu provenga, benvenuto in un viaggio incredibile nel mondo dello sviluppo software. + +In queste pagine approfondiremo assieme l'essenza del developer, non puntando alla padronanza tecnica di un linguaggio di programmazione o di uno specifico framework, ma a una comprensione più profonda dei valori che sono alla base di questo mestiere. + +Questo libro è per chiunque voglia intraprendere un percorso nel mondo dello sviluppo, migliorare le proprie competenze, scoprire nuovi orizzonti. + +Da dove nasce questo libro? Da una comunità di persone che hanno deciso di condividere le proprie esperienze, le proprie conoscenze, le proprie storie. Ed è proprio la comunità il cuore pulsante di questo libro, e speriamo che, una volta terminata la lettura, tu possa e voglia sentirti parte di questa comunità. + +## Open Source e collaborazione + +Al centro di questo viaggio c'è un profondo impegno nei confronti dei principi dell'**Open Source**. Crediamo che la conoscenza debba essere condivisa liberamente, che il codice debba essere aperto e che la saggezza collettiva di una comunità allargata sia una potente forza di progresso. Nello spirito di apertura, questo libro è esso stesso un progetto Open Source, che è disponibile oggi e per sempre in maniera gratuita, a testimonianza della nostra convinzione che insieme possiamo creare qualcosa di più grande della somma delle sue parti. + +Ma l’Open Source è solo l’inizio. Sosteniamo inoltre gli ideali di **Open Governance**, riconoscendo che la vera collaborazione prospera in un ambiente di trasparenza, responsabilità e inclusività. Proprio come nel mondo del software, dove il miglior codice emerge da diverse prospettive e idee, noi adottiamo un modello di governance che invita tutte le voci al tavolo. Il nostro team di "Ambassador" incarna questa etica, lavorando fianco a fianco con la comunità per plasmare il futuro di questo libro. + +Questo libro non è un monologo; è una **sinfonia collaborativa**. Ogni capitolo, paragrafo e frase è stato realizzato con cura, con il contributo di persone che hanno dedicato la propria esperienza e il proprio tempo a servizio di chiunque leggerà queste pagine, condividendone la visione. Come membro di questo mondo, anche tu sei invitato a prendere parte a questa conversazione in continua evoluzione. + +Proseguendo con questa lettura tieni sempre a mente quanto segue: il nostro progresso è saldamente ancorato a questi principi fondamentali per tutte le persone coinvolte. Open Source, Open Governance e collaborazione non sono soltanto parole, ma fari che illuminano le acque in cui navighiamo. Abbracciamo quindi questi ideali, rendiamoci disponibili ad imparare gli uni dagli altri e costruiamo, assieme, un futuro in cui lo sviluppo sarà accessibile a tutti e le cui porte rimarranno aperte per chiunque voglia entrare. + +L'Open Source è ovunque. Non ci credi? +OpenUK nel 2021 ha calcolato che il 90% delle aziende del mondo, grandi o piccole, tech o non tech, utilizzano software Open Source. +GitHub nel 2022 ha pubblicato i seguenti numeri: La piattaforma conta 94 milioni di sviluppatori che hanno effettuato 413 milioni di contributi. Dallo stesso report si evince che il 90% delle aziende Fortune 100 utilizza GitHub in qualche forma. + +## I temi + +Che tu sia developer, designer, project manager, tester, product owner o semplicemente una persona curiosa, ricordati che diventare ed essere developer non significa solo scrivere codice. + +Essere developer significa creare una carriera che sia appagante, di lavorare in progetti che ti permettano di esprimere la tua creatività, di avere a che fare con persone che condividono la tua passione e di costruire un futuro migliore per te e per gli altri. + +Essere developer vuol dire andare oltre il codice, oltre la tecnologia, oltre il lavoro. Vuol dire essere parte di una comunità, di un ecosistema, di un mondo in cui la collaborazione e la condivisione sono alla base di tutto. + +Che tu voglia occuparti di DevOps, di UX, di testing, di data science o di qualsiasi altra branca, ricorda che ognuno di noi è partito da zero, e speriamo che queste pagine possano aiutarti a trovare la tua strada. + +## Il viaggio + +A te che hai deciso di intraprendere questo viaggio, sappi che non sei parte passiva in questa avventura cosmica; tu sei una parte vitale della narrazione. Insieme, esploreremo il percorso per lavorare nel mondo dello sviluppo, qualsiasi cosa questo voglia dire, e ovunque questo possa portarci. + +Chi ti accompagnerà in questo viaggio? Chiunque tu voglia. Questo libro è per tutti. Questo libro è per te. Mentre lo leggi, lascia un commento sul nostro [repository su GitHub](https://github.com/Il-Libro-Open-Source/book) e dicci cosa ne pensi. + +Se vuoi contribuire, puoi farlo. Se vuoi tradurre questo libro nella tua lingua, puoi farlo. Se vuoi creare un fork di questo libro e creare una versione personalizzata, puoi farlo. Questo libro è tuo. Questo libro è nostro. Questo libro è di tutti. + +_Ed ora che sei a bordo con noi, ci vediamo dall'altra parte._