Cloud Haiku è una repository open-source che colleziona haiku riguardo il cloud e la tecnologia e li pubblica sul suo sito.
Data la popolarità di questa repository durante l'Hacktoberfest, per favore rispetta il tempo che impiegano gli amministratori per confermare e unire le pull requests. Potresti aspettare anche una settimana per ricevere una risposta, che potrebbe includere richieste di cambiamento.
Tutti gli haiku inseriti dagli utenti haiku sono disponibili nella cartella /_haikus
.
Per inserire un haiku in questa repository, leggi come inviare una pull request nel tutorial creato da DigitalOcean "How To Create a Pull Request on GitHub" dopodichè componi un haiku in formato Markdown (.md
).
Nota bene: Vista la popolarità di questa repository, specialmente per l'Hacktoberfest, accetteremo un solo haiku per utente.
Dovresti rinominare il tuo haiku titolo_haiku.md
e inserirlo nella cartella /_haikus
di questo progetto.
Poichè questo sito è in formato Jekyll , avrai bisogno anche di una targhetta all'inizio del file:
---
layout: haiku
title: IL TUO TITOLO
author: IL TUO NOME
---
Mantieni il layout come haiku
e:
-Vicino a title:
inserisci il titolo del tuo haiku.
-Vicino author:
inserisci il tuo nome (puoi anche inserire uno pseudonimo se vuoi).
-Si prega di non aggiungere altre righe alla targhetta iniziale.
Nota: Usiamo Travis CI come metodo per testare automaticamente i file in formato markdown. Per favore lascia l'intestazione del tuo file Markdown come descritto sopra in modo da assicurarti che la pull request sia accettata e unita alla repository.
Al di sotto della intestazione scriverai il tuo haiku.
Nello spirito open source, ci piacerebbe che tu scrivessi un haiku originale piuttosto che inviarne uno scritto da altri.
Il tuo haiku dovrà essere divertente da scrivere ma allo stesso tempo troverai il processo di scrittura molto stimolante. Dovrai assicurarti che il tuo haiku rispecchi le linee guida di questo tipo di poesia che troverai qui sotto.
Gli Haiku sono una forma di poesia tradizionale giapponese. Consistono di tre versi e 17 sillabe totali che seguono lo schema di sillabe 5-7-5.
Le Sillabe sono un'unità organizzativa delle parole che di solito contengono una vocale. Per esempio, la parola telefono è composta di quattro sillabe: te - le - fo - no. Consideriamo un esempio di haiku
La nuda foglia <br>
dall'occhio concupita <br>
sentiva caldo <br>
Notiamo che l'haiku è composto da tre versi.
Il primo è di 5 sillabe, il secondo di 7 sillabe, e il terzo di nuovo di 5, seguendo quindi lo schema proposto.
La-nu-da-fo-glia # 5 sillabe
Dall'-oc-chio-con-cu-pi-ta # 7 sillabe
Sen-ti-va-cal-do # 5 sillabe
Per verificare che tu stia usando il numero giusto di sillabe puoi utilizzare il tool http://www.haikusyllablecounter.com.
Molte forme di poesia hanno le proprie regole da seguire. Questa sfida rende la poesia una forma d'arte ancora piu divertente.
Per essere sicuro/a che le righe vengano divise, usa le "line breaks" del linguaggio HTML come segue:
---
layout: haiku
title: Octopus Cloud
author: Sammy
---
Distributed cloud<br>
Like the octopuses' minds<br>
Across the network<br>
Per esempio, l'haiku di Sammy lo Squalo è chiamato "Octopus Cloud", e lui ha scritto il suo nome come "Sammy". Sammy ha rinominato il suo file octopus_cloud.md
.
---
layout: haiku
title: Octopus Cloud
author: Sammy
---
Distributed cloud<br>
Like the octopuses' minds<br>
Across the network<br>
Questa repository contiene uno script di test che verrà effettuato su ogni pull request. Per fare il test in locale avrai bisogno di Node.js installato. Poi potrai installare le dipendenze e fare i tuoi test.
Innanzitutto clona la repository, se non l'hai gia fatto:
$ git clone https://github.com/do-community/cloud_haiku.git
Dopodichè cambia cartella e installa le dipendenze npm
:
$ cd cloud_haiku
$ npm install
Infine, fai i test:
$ npm test
Nota bene che vista la "creatività" della linguà inglese è possibile che la libreria che conta le sillabe sbagli. Se la tua pull request fallisce un test e pensi che ci sia un errore, rispondi con un commento.
Siamo felici di unire una pull request valida a questa repository! Ogni pull request che rispetta le linee guida sopra riportate sarà aggiunta in questo progetto.
Conserva gli haiku riguardo la tecnologia cloud, e divertiti contribuendo a questo progetto!