Cloud Haiku is an open-source repository that collects haikus about the cloud and cloud technology and publishes these haikus to its website.
All of our user-submitted haikus are available via the /_haikus
directory.
To contribute a haiku to this repository, read about submitting a pull request in the DigitalOcean tutorial "How To Create a Pull Request on GitHub" and then compose a haiku in Markdown (.md
).
Note: Due to the popularity of this repository, especially around Hacktoberfest, we will only accept one haiku contribution per user.
You should name your Markdown file your_haiku_title.md
and put it in the /_haikus
directory of this project.
Because this is a Jekyll site, you'll also need to include some boilerplate at the top of the file:
---
layout: haiku
title:
author:
---
Keep the layout as haiku
. Next to the title:
put the title of your haiku. Next to the author:
put your name (this can be just your first name or a pseudonym if you would like).
Under this heading, you'll put your haiku.
In the spirit of open source, we would like you to write an original haiku rather than submit one that someone else has written.
Your haiku should be fun and challenging to write. You must ensure that it fits into the poetic guidelines of what a haiku is, which you can read about in the next section.
Haikus are a traditional form of Japanese poetry. They are made up of three lines and have a total of 17 syllables. These poems follow the 5-7-5 format of syllables across the three lines.
Syllables are a unit of organization for speech sounds that typically include a vowel. For example, the word computer is composed of three syllables: com - put - er.
Let's look at an example haiku from this repository:
Distributed cloud
Like the octopuses' minds
Across the network
Above, we see that the haiku is composed of 3 lines.
The first line is 5 syllables long, the second line is 7 syllables long, and the third line is 5 syllables long.
Dis-trib-ut-ed cloud # 5 syllables
Like the oc-to-pus-es' minds # 7 syllables
A-cross the net-work # 5 syllables
In order to verify that you're using the right number of syllables, you can use a tool such as http://www.haikusyllablecounter.com.
Many forms of poetry have specific aesthetic rules to follow. This challenge makes writing poetry an enjoyable art form.
To ensure that there are proper line breaks, you will need to put two blank spaces after each line of your haiku. Alternately, you can use HTML line breaks, like so:
---
layout: haiku
title: Octopus Cloud
author: Sammy
---
Distributed cloud<br>
Like the octopuses' minds<br>
Across the network<br>
For example, Sammy the Shark's haiku is called "Octopus Cloud," and they wrote their name as just "Sammy." Sammy named their file octopus_cloud.md
.
---
layout: haiku
title: Octopus Cloud
author: Sammy
---
Distributed cloud
Like the octopuses' minds
Across the network
This repository includes a test script that will be run on every pull request. To run the tests locally, you'll need Node.js installed. You should then be able to install the dependencies and run the tests.
First clone the repo, if you haven't done so already:
$ git clone https://github.com/do-community/cloud_haiku.git
Then change into the new directory and install the dependencies with npm
:
$ cd cloud_haiku
$ npm install
Finally, run the tests:
$ npm test
Note that due to the "creativity" of the English language it's possible for the syllable counting library to be off. If your pull request fails a test and you think that's in error, please follow up with a comment.
We're happy to merge valid pull requests to this repository! Any pull request that follows the formatting guidelines above will be brought into this project.
Keep your haikus related to cloud infrastructure technology, and have fun contributing to this project!
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. ๐๐๐
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google โค๏ธ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.