I have been looking for an alternative to Github to host my private repos,
Github provides only 1 private repo and for more you have to pay. So I
found this.

https://gitlab.com/

Gitlab has all the features of Github with additional advantages that is
completely free and you can have as many private repos as you want. Also in
terms of space , its unlimited with a limit of 10 GB per repo which makes
it an excellent choice for binary files. You can have unlimited repos (the
hard limit is at 100.000 repos per user which you wont reach any time soon
)

A recent advantage that I discovered is that like Github , Gitlab allows
you to host your own website via Gitlab pages

https://pages.gitlab.io/

The cool thing about this is that it comes with CI , which is highly
configurable which means you can even make it work with Pillar. The website
part can mix with existing code, meaning you can keep on the same repo the
code of your pharo projects and documentation in form of website. Gitlab
pages support a wide variety of static website generators , the on the
interests me is gitbook

https://www.gitbook.com/

Gitbook is interesting because it comes with its own Editor you can
download as a native client that handles the writing of the book /
documentation and pushing and committing to the repo

https://www.gitbook.com/editor

Both Gitlab and Gitbook are free software that means they can be installed
in any Pharo server and customised to whatever you want

I made an example here.
https://gitlab.com/Kilon/testbook

The gitbook documentation is hosted in the pages branch which is a nice
clean way to isolate documentation from project's code but also you could
alternative have everything in master and put documentation in a doc
folder. You can fine tune such setup with the corresponding yaml setup file
as can see here

https://gitlab.com/Kilon/testbook/blob/pages/.gitlab-ci.yml

The website generated by this repo can be viewed here

https://kilon.gitlab.io/testbook/

obviously you can also add anything that is in HTML/JS which make this
ideal for blog, main websites, application frontends and pretty much
everything you can imagine and because GitLab allows for unlimited amount
of repos you can have unlimited amount of websites.

Have fun :)

Reply via email to