a travel, windsurf and livestyle blog
- posts/2019/morocco-marokko/MM-DD-safi-oualidia-el-jadida
- posts/2019/morocco-marokko/MM-DD-moulay-bouzerktoun
- posts/2019/morocco-marokko/MM-DD-essaouria
- posts/2019/morocco-marokko/MM-DD-sidi-kaouki
- posts/2019/morocco-marokko/MM-DD-marrakesch-taghazout
- posts/2019/ireland-irland/MM-DD-Dingle-Peninsula
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/04-25-adjustable-bed
- posts/2019/bavaria-bayern/MM-DD-winter-at-Brombach-Lake
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/04-25-mercedes-sprinter-spier-aero-box
- posts/2018/canarian-islands-kanarisch-inseln-gran-canaria/MM-DD-pozo-izquierdo-Small-Armaggedon
- posts/2018/Canarian-Islands-Kanarisch-Inseln-Gran-Canaria/MM-DD-Pozo-Izquierdo-PWA-Pros
- posts/2018/Canarian-Islands-Kanarisch-Inseln-Gran-Canaria/MM-DD-Pozo-Izquierdo-Training
- posts/2018/Canarian-Islands-Kanarisch-Inseln-Gran-Canaria/MM-DD-Pozo-Izquierdo-Arrival-Ankunft
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/04-25-vw-bus-transport-t4-syncro
- posts/2018/France-Frankreich/MM_DD_Week2
- posts/2018/France-Frankreich/MM_DD_Week1
- posts/2018/balticSea-Ostsee/MM_DD_dazendorf
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/02-29-opel-vectra-b-caravan
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/02-15-opel-kadett-e-cc
- posts/2018/balticSea-Ostsee/03_17_dahmeshoeved
- posts/2020/surf-van-bus-campervan-motorhome-expedition-reise-mobil/07-25-opel-blitz
- posts/2017/ireland-irland/11-12-portrane-dublin
- posts/2017/ireland-irland/11-10-magheroarty-beach-donegal-II
- posts/2017/ireland-irland/11-09-magheroarty-beach-donegal-I
- posts/2017/ireland-irland/11-07-spanish-point-cliffs-of-moher-mullaghmore
- ireland-irland/11-06-brandon-bay-stradbally
- pages
- info
- about
- authors
- contact
- e-mail-newsletter
- sticker
- legal-information
- privacy policy
- info
- posts
- 2017
- northSea-nordsee/09_13_cuxhaven-sahlenburg-irma
- ireland-irland/11-05-arrival-ankunft-brandon-bay
- 2017
The first thing you should do, before writing a new blogpost is creating a new ticket on github. This ticket is needed to track all changes which are made during the creation of this blogpost. To create a ticket go to :
https://github.com/stormy-stories-surf/stormy-stories.surf/issues/new
Here you can add :
- A title, which could be for example "Add blogpost : <NAME_OF_YOUR_BLOG_POST>"
- An assignee, which is the person who is working on this ticket, which is most probably you.
- A label, here you have to select new blogpost
- A project, which should be Write .md files for STORMY-STORIES.SURF
- And finally a milestone, which should be the milestone of the version in which this blogpost shall be released.
After the ticket is complete you can click on Submit new issue. Your new ticket is created and opened. Besides this your new ticket has a number that is displayed after the title of the ticket with a # in front of it. Please remember this number. You will need it in the next steps.
If you need some photos for your blog-post, please go through your photos select the ones which you you want for your post and copy them into a temporary folder. Go through all of these photos and review them for the following points:
- Are there any faces of people that you don't want to publish
- Are there any plates of cars that you don't want to publish
- Are there any dirt dots in the picture because of a dirty lense
- Is there a slate / non horizontal horizon
- Is the picture to bright or to dark
- Are there color errors because of a too high light sensitivity / ISO value
If one or more of these points are matching with one of your photos you should consider to not use it or to rework it, before using it.
At stormy-stories.surf we have one repository which is storing all original photos without any compression or watermark, but which are already in a reworked publication worthy status. Now as you have selected and reworked your photos you have to add this photos to this repository. For this follow the next steps:
- Clone the stormy-stories-media-base repository by opening the terminal and typing
git clone gitlab@dev.sum7.eu:mezorian/stormy-stories-media-base.gitor
git clone https://dev.sum7.eu/mezorian/stormy-stories-media-base.git- Go into the new directory
cd stormy-stories-media-base- Create a new branch which is based on the development branch. Use the number of your github ticket / issue as the new branch name. For example if your ticket / issue number was #54 name the new branch #54.
git checkout development
git checkout -b <TICKET_NUMBER>- Create a new directory for your blog post. For this please keep up with the already existing directory structure which is as follows:
.
├── pages
│ └── ......
│
├── posts
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
For example if your post is about the Brandon Bay Stradbally in Ireland at the 06. November 2017 your directory structure has to look like :
.
├── posts
│ ├── 2017
│ │ ├── ireland-irland
│ │ │ ├── 11-06-brandon-bay-stradbally
│ │ │ │ ├── DSC09040.JPG
│ │ │ │ ├── DSC09042.JPG
│ │ │ │ ├── DSC09050.JPG
- Copy all photos into the directory.
- Add the new photos to the version control system by opening the terminal in the new directory and typing the following commands. For this please replace #<TICKET_NUMBER> by your github ticket / issue number (for example #54 ) and replace <POST_TITLE> by name of your blog-post.
git status
git add -A
git commit -m "#<TICKET_NUMBER> : Added photos for <POST_TITLE>"
git push -u origin #<TICKET_NUMBER>Now as you added and pushed your new photos to the stormy-stories-media-base repository you can merge your changes from the ticket-branch into the development branch. For this open
https://dev.sum7.eu/mezorian/stormy-stories-media-base/merge_requests/new?merge_request
and select your recently created new ticket-branch as source and "development" as target branch, after this click "Compare branches and continue". On the next page scroll to the back and click to "Submit merge request". On the next page click on "Merge".
If you want to write a blog post you most likely will need both photos and text. At stormy-stories.surf we publish everything with a CC BY-NC-SA license. This means every one is free to copy and redistribute the material in any medium or format and also adapt — remix, transform, and build upon the material. But this usage is only allowed for non-commercial purpose, if we as the initial authors are mentioned and if the newly created material is also published with the same license.
To ensure that our photos refer back to us, even if they are used without mentioning us as the creator, we add watermarks to all published photos.
To not make this an annoying task we developed a command-line tool which can automatically run through all photos and add a watermark to them. The usage of this tool is explained in a later part of this README.
As most of the modern cameras create photos with sizes > 5MB and also often > 20MB it is important to reduce the file sizes of all photos. The compression and scaling of the photos can also be done with the command-line tool which is used for watermarking.
Before you can use your photos for your new blogpost you have to reduce the file size and add a watermark to them. For this you can use the command-line tool PhotoPrep as follows:
- Download it, by opening the terminal and typing
git clone git@github.com:stormy-stories-surf/PhotoPrep.gitor
git clone https://github.com/stormy-stories-surf/PhotoPrep.git- Go into the new directory
cd PhotoPrep- Copy all your pictures ......
TODO anon42
At stormy-stories.surf we have one main repository which stores all blog posts and all photos which are used in the post. The repository consists mainly of two directories:
- markdown
- mediaLibrary
The blog post itself is written in markdown and is stored in the markdown directory. The photos are stored in the mediaLibrary directory.
To create a new blogpost. You have to :
- Download the repository by opening the terminal and typing:
git clone git@github.com:stormy-stories-surf/stormy-stories.surf.gitor
git clone https://github.com/stormy-stories-surf/stormy-stories.surf.git- Go into the new directory
cd stormy-stories-media-base- Create a new branch which is based on the development branch. Use the number of your github ticket / issue as the new branch name. For example if your ticket / issue number was #54 name the new branch #54.
git checkout development
git checkout -b <TICKET_NUMBER>- Create a new directory for the photos of your post. For this please keep up with the already existing directory structure which is as follows:
mediaLibrary
├── pages
│ └── ......
│
├── posts
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── XX.JPG
│ │ │ │ ├── YY.JPG
│ │ │ │ ├── ZZ.JPG
For example if your post is about the Brandon Bay Stradbally in Ireland at the 06. November 2017 your directory structure has to look like :
mediaLibrary
├── posts
│ ├── 2017
│ │ ├── ireland-irland
│ │ │ ├── 11-06-brandon-bay-stradbally
│ │ │ │ ├── DSC09040.JPG
│ │ │ │ ├── DSC09042.JPG
│ │ │ │ ├── DSC09050.JPG
- Copy all prepared photos into the new directory.
- Add the new photos to the version control system by opening the terminal in the new directory and typing the following commands. For this please replace #<TICKET_NUMBER> by your github ticket / issue number (for example #54 ) and replace <POST_TITLE> by name of your blog-post.
git status
git add -A
git commit -m "#<TICKET_NUMBER> : Added photos for <POST_TITLE>"
git push -u origin #<TICKET_NUMBER>Now as you already created a new ticket branch for adding the photos, we can also use this branch for adding the text. But before you can do this, you have to add a new directory for the text of your blog post in the markdown directory For this please keep up with the already existing directory structure which is as follows:
markdown
├── pages
│ ├── .....
│
├── posts
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── de
│ │ │ │ │ └── content.md
│ │ │ │ └── en
│ │ │ │ └── content.md
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── de
│ │ │ │ │ └── content.md
│ │ │ │ └── en
│ │ │ │ └── content.md
│ ├── year
│ │ ├── countryInEnglish-countryInGerman
│ │ │ ├── Month-Day-NameOfPostInEnglishAndGerman
│ │ │ │ ├── de
│ │ │ │ │ └── content.md
│ │ │ │ └── en
│ │ │ │ └── content.md
For example if your post is about the Brandon Bay Stradbally in Ireland at the 06. November 2017 your directory structure has to look like :
markdown
|
├── posts
│ ├── 2017
│ │ ├── ireland-irland
│ │ │ ├── 11-06-brandon-bay-stradbally
│ │ │ │ ├── de
│ │ │ │ │ └── content.md
│ │ │ │ └── en
│ │ │ │ └── TODO
For every language in which you write your text you have to create a directory (e.g. de and en) and put a markdown file called content.md into it. Always create at least the directories for German and English and put a empty TODO file into the directory if you have no translation yet. The aim for this blog is to have as many translated blog posts as possible.
Now as the necessary files are created you can edit the content.md file and add your text and photos into it.
As soon as you are finished with your text (or maybe (even better) also within the writing process) you have to add your changes to the version control. For this use the following commands and replace #<TICKET_NUMBER> by your github ticket / issue number (for example #54 ) and replace <POST_TITLE> by name of your blog-post.
git status
git add -A
git commit -m "#<TICKET_NUMBER> : Added photos for <POST_TITLE>"
git push -u origin #<TICKET_NUMBER>To provide you from publishing a blog post full of typos and grammar errors share your idea with someone who has the honor to review your text and also the quality of your photos. This can be easily done with creating a pull-request at github. For this open https://github.com/stormy-stories-surf/stormy-stories.surf/compare , select development as base branch and your ticket branch as compare branch and click on Create pull request . Add a title to your new pull-request, add yourself as assignee and add someone else as a reviewer and click again on Create pull request. This someone now has the task to review your blog post and give you the approval to merge it into the development branch.
If a reviewer reviewed and approved your blog post you can merge your new blog post into the development branch by clicking on Merge pull request. After the successful merge, you can delete your ticket branch. Do this by scrolling to the very end of the pull-request and click on Delete branch.
You now successfully added your new blog post including text and photos. You should be proud of your self! :D Time to party!