diff --git a/.gitignore b/.gitignore index edf0e29..d4541a1 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,2 @@ -/.ikiwiki +content/.ikiwiki public/ diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index 736cb0c..6511ea1 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -1,15 +1,22 @@ image: elecnix/ikiwiki +before_script: + - apt-get install -y git + - git submodule init + - git submodule update + test: stage: test - script: ikiwiki --setup .ikiwiki/ikiwiki.setup + script: + - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib only: - branches - tags pages: stage: deploy - script: ikiwiki --setup .ikiwiki/ikiwiki.setup + script: + - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib artifacts: paths: - public diff --git a/.gitmodules b/.gitmodules new file mode 100644 index 0000000..4c26f58 --- /dev/null +++ b/.gitmodules @@ -0,0 +1,3 @@ +[submodule "themes/ikistrap"] + path = themes/ikistrap + url = https://github.com/gsliepen/ikistrap.git diff --git a/README.md b/README.md index d8bce20..9c2c4d7 100644 --- a/README.md +++ b/README.md @@ -29,28 +29,41 @@ defined in [`.gitlab-ci.yml`](.gitlab-ci.yml): ```yaml image: elecnix/ikiwiki +before_script: + - apt-get install -y git + - git submodule init + - git submodule update + test: stage: test - script: ikiwiki --setup .ikiwiki/ikiwiki.setup - except: - - master + script: + - ikiwiki --setup .ikiwiki/ikiwiki.setup --libdir themes/ikistrap/lib + only: + - branches + - tags pages: stage: deploy - script: ikiwiki --setup .ikiwiki/ikiwiki.setup + script: + - ikiwiki --setup .ikiwiki/ikiwiki.setup --libdir themes/ikistrap/lib artifacts: paths: - public only: - master ``` + +We are using a theme based on Bootstrap 4 using submodules, and in order to +enable the theme plugin, we must pass the `libdir` parameter. + ## Building locally To work locally with this project, you'll have to follow the steps below: 1. Fork, clone or download this project 1. [Install][] ikiwiki -1. Generate the website: `ikiwiki --setup .ikiwiki/ikiwiki.setup` +1. Clone the submodules: `git submodule init && git submodule update` +1. Generate the website: `ikiwiki --setup .ikiwiki/ikiwiki.setup --libdir themes/ikistrap/lib` 1. Preview your project: open `public/index.html` in a browser Read more at ikiwiki's [documentation][]. @@ -83,4 +96,4 @@ unless you want to contribute back to the upstream project. [install]: https://ikiwiki.info/install/ [documentation]: https://ikiwiki.info/ [userpages]: http://doc.gitlab.com/ee/pages/README.html#user-or-group-pages -[projpages]: http://doc.gitlab.com/ee/pages/README.html#project-pages \ No newline at end of file +[projpages]: http://doc.gitlab.com/ee/pages/README.html#project-pages diff --git a/content/Anemones.jpg b/content/Anemones.jpg new file mode 100644 index 0000000..7151241 Binary files /dev/null and b/content/Anemones.jpg differ diff --git a/content/Bootstrap_features.mdwn b/content/Bootstrap_features.mdwn new file mode 100644 index 0000000..12c3a08 --- /dev/null +++ b/content/Bootstrap_features.mdwn @@ -0,0 +1,136 @@ +# Bootstrap features + +This page will contain a display of various features from Bootstrap. +They require some manual HTML tags. +Note that not all Markdown parsers allow Markdown markup inside all HTML tags. +In the case of ikiwiki, adding `markdown="1"` to `div` elements usually allows markup to be used inside them. +For a full list of features provided by Bootstrap 4, go to . + +
+## Jumbotron + +It's big and in your face. + +--- + +You can still use Markdown syntax inside HTML blocks, if you are careful. + +Button +
+ +## Labels Hi! + +Span elements work inside Markdown headings. + +
+## Cards + +Put a border with soft round corners around your content. +
+ + +## Card decks + +These require some more work. +You can use the `\[[!img]]` directive, but make sure to add `class="card-img-top"` or `class="card-img-bottom"` where appropriate. +For images in cards to work properly, they need to have their width forced to 100% of their container. +This is done in the `style.css` file that comes with ikistrap. + +Another issue is that due to all the nested HTML tags, even with `markdown="1"`, Markdown markup does not get parsed anymore. + +
+
+
+[[!img Lemonshark.jpg alt="Lemon shark" class="card-img-top"]] +
+

+A lemon shark and his little friends are out for a swim. +

+

Escape

+
+
+
+[[!img Anemones.jpg alt="Anemones" class="card-img-top"]] +
+

+Anemones look really nice and are much less dangerous than lemon sharks. +

+

Admire

+
+
+
+[[!img Sea_Star.jpg alt="Sea star" class="card-img-top"]] +
+

+Sea stars are also less dangerous than lemon sharks, but they are slightly more dangerous than +anemones, especially when stepped on. +

+

Sidestep

+
+
+
+
+ +## Card columns + +These can be created by writing the outer card-columns `div` elements yourself, +and using `\[[!inline]]` with `template="simplecard"` to generate the cards. + +
+[[!inline pages="sample_text/* and !*/Discussion" template="simplecard" feeds="no"]] +
+ + +## Carousel + +These can be created by writing the outer two carousel `div` elements yourself, +and using `\[[!inline]]` with `template="carouselpage"` to generate the carousel items. + +

+

+

+ +If you only want to show images, use `template="carouselimage"`, and select your images directly with the `pages` parameter. + +

+

+

+ +## Progress bars + +Ikistrap also provides a progress directive which works in the same way as the progress plugin, +but it also allows an extra class to be specified to change the style per bar. + +[[!progress totalpages="* and !*/Discussion" donepages="*/Discussion"]] +[[!progress percent="33%"]] +[[!progress percent="66%" class="progress-success progress-striped"]] + +## Other stuff + +Goes here. + diff --git a/content/Calendars.mdwn b/content/Calendars.mdwn new file mode 100644 index 0000000..5d8e152 --- /dev/null +++ b/content/Calendars.mdwn @@ -0,0 +1,10 @@ +# Calendar + +This is an example of the ikiwiki calendar function. +Here is a monthly calendar: + +[[!calendar type="month"]] + +And this is a yearly calendar: + +[[!calendar type="year"]] diff --git a/content/Comments.mdwn b/content/Comments.mdwn new file mode 100644 index 0000000..24cc744 --- /dev/null +++ b/content/Comments.mdwn @@ -0,0 +1,3 @@ +# Comments + +This is an example of a page where comments are allowed. diff --git a/content/Comments/comment_1._comment b/content/Comments/comment_1._comment new file mode 100644 index 0000000..ab9901d --- /dev/null +++ b/content/Comments/comment_1._comment @@ -0,0 +1,9 @@ +[[!comment format=mdwn +username="Anonymous Coward" +subject="Indeed" +date="2009-06-02T19:05:00Z" +content=""" +Hi, I just want to say that I totally agree with you. +Have a nice day! +""" +]] diff --git a/content/Comments/comment_2._comment b/content/Comments/comment_2._comment new file mode 100644 index 0000000..5b29715 --- /dev/null +++ b/content/Comments/comment_2._comment @@ -0,0 +1,9 @@ +[[!comment format=mdwn +username="Pseudonymous Person" +subject="I am disagree" +date="2009-06-02T19:05:01Z" +content=""" +I don't think so. Eggs should neither be capped at the top or at the bottom. +Symmetry is only attained by slicing it in half in a plane spanned by the line between the top and bottom. +""" +]] diff --git a/content/Inline_pages.mdwn b/content/Inline_pages.mdwn new file mode 100644 index 0000000..46d540e --- /dev/null +++ b/content/Inline_pages.mdwn @@ -0,0 +1,9 @@ +# Inline pages + +Here is an example of inline pages using the default inlining theme: + +[[!inline pages="sample_text/* and !*/Discussion" reverse="yes" limit="3"]] + +Here is an example of inlining with actions enabled: + +[[!inline pages="sample_text/* and !*/Discussion" reverse="yes" skip="3" limit="2" actions="1"]] diff --git a/content/Lemonshark.jpg b/content/Lemonshark.jpg new file mode 100644 index 0000000..e568a5b Binary files /dev/null and b/content/Lemonshark.jpg differ diff --git a/content/Sea_Star.jpg b/content/Sea_Star.jpg new file mode 100644 index 0000000..5fb9001 Binary files /dev/null and b/content/Sea_Star.jpg differ diff --git a/content/index.mdwn b/content/index.mdwn new file mode 100644 index 0000000..b471dc7 --- /dev/null +++ b/content/index.mdwn @@ -0,0 +1,31 @@ +# Welcome to Ikiwiki hosted by GitLab Pages + +This is an example wiki to show off how Ikiwiki is deployed with [GitLab Pages]. + +It uses the [Ikistrap] theme which provides a fully-featured, modern looking +HTML5 theme for ikiwiki. It uses Bootstrap 4 and Fonts Awesome. + +## Features + +Ikistrap has the following features: + +* Good use of HTML5 semantic elements. +* Responsive layout. +* Standards-compliant. +* Compatible with text-only browsers. +* Header supporting parentlinks, wiki actions, search form, language selection and trails. +* Sidebar styled as a Boostrap 4 card, using the Bootstrap 4 grid system. +* Footer that is pushed down to the bottom of the screen with tags, backlinks, copyright, license and modification date. +* [[Inline pages]] that are by default styled as Bootstrap 4 cards. +* [[Comments]] +* [[Calendars]] + +Note that ikistrap doesn't add any special support for Bootstrap to the Markdown language. +If you want to make use of [[Bootstrap features]] inside your text, you will have to manually add the appropriate HTML tags. + +## Contribute + +If you want to contribute to this website, visit . + +[gitlab pages]: https://pages.gitlab.io +[ikistrap]: https://github.com/gsliepen/ikistrap diff --git a/content/inlinetest.mdwn b/content/inlinetest.mdwn new file mode 100644 index 0000000..95cebf2 --- /dev/null +++ b/content/inlinetest.mdwn @@ -0,0 +1 @@ +[[!inline pages="sample_text/*"]] diff --git a/content/sample_text/Donec_dapibus.mdwn b/content/sample_text/Donec_dapibus.mdwn new file mode 100644 index 0000000..b995fa6 --- /dev/null +++ b/content/sample_text/Donec_dapibus.mdwn @@ -0,0 +1 @@ +Donec dapibus orci sit amet elit. Maecenas rutrum ultrices lectus. Aliquam suscipit, lacus a iaculis adipiscing, eros orci pellentesque nisl, non pharetra dolor urna nec dolor. Integer cursus dolor vel magna. Integer ultrices feugiat sem. Proin nec nibh. Duis eu dui quis nunc sagittis lobortis. Fusce pharetra, enim ut sodales luctus, lectus arcu rhoncus purus, in fringilla augue elit vel lacus. In hac habitasse platea dictumst. Aliquam erat volutpat. Fusce iaculis elit id tellus. Ut accumsan malesuada turpis. Suspendisse potenti. Vestibulum lacus augue, lobortis mattis, laoreet in, varius at, nisi. Nunc gravida. Phasellus faucibus. In hac habitasse platea dictumst. Integer tempor lacus eget lectus. Praesent fringilla augue fringilla dui. diff --git a/content/sample_text/Donec_semper.mdwn b/content/sample_text/Donec_semper.mdwn new file mode 100644 index 0000000..bdcb1ab --- /dev/null +++ b/content/sample_text/Donec_semper.mdwn @@ -0,0 +1 @@ +Donec semper, sem nec tristique tempus, justo neque commodo nisl, ut gravida sem tellus suscipit nunc. Aliquam erat volutpat. Ut tincidunt pretium elit. Aliquam pulvinar. Nulla cursus. Suspendisse potenti. Etiam condimentum hendrerit felis. Duis iaculis aliquam enim. Donec dignissim augue vitae orci. Curabitur luctus felis a metus. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. In varius neque at enim. Suspendisse massa nulla, viverra in, bibendum vitae, tempor quis, lorem. diff --git a/content/sample_text/Lorem_ipsum.mdwn b/content/sample_text/Lorem_ipsum.mdwn new file mode 100644 index 0000000..f0199bc --- /dev/null +++ b/content/sample_text/Lorem_ipsum.mdwn @@ -0,0 +1,4 @@ +[[!meta author="Cicero"]] +[[!meta date="45 B.C."]] + +Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed at ante. Mauris eleifend, quam a vulputate dictum, massa quam dapibus leo, eget vulputate orci purus ut lorem. In fringilla mi in ligula. Pellentesque aliquam quam vel dolor. Nunc adipiscing. Sed quam odio, tempus ac, aliquam molestie, varius ac, tellus. Vestibulum ut nulla aliquam risus rutrum interdum. Pellentesque lorem. Curabitur sit amet erat quis risus feugiat viverra. Pellentesque augue justo, sagittis et, lacinia at, venenatis non, arcu. Nunc nec libero. In cursus dictum risus. Etiam tristique nisl a nulla. Ut a orci. Curabitur dolor nunc, egestas at, accumsan at, malesuada nec, magna. diff --git a/content/sample_text/Nulla_facilisi.mdwn b/content/sample_text/Nulla_facilisi.mdwn new file mode 100644 index 0000000..0e8a0b9 --- /dev/null +++ b/content/sample_text/Nulla_facilisi.mdwn @@ -0,0 +1,2 @@ +[[!tag Cicero Latin typesetting]] +Nulla facilisi. Nunc volutpat. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Ut sit amet orci vel mauris blandit vehicula. Nullam quis enim. Integer dignissim viverra velit. Curabitur in odio. In hac habitasse platea dictumst. Ut consequat, tellus eu volutpat varius, justo orci elementum dolor, sed imperdiet nulla tellus ut diam. Vestibulum ipsum ante, malesuada quis, tempus ac, placerat sit amet, elit. diff --git a/content/sample_text/Sed_eget.mdwn b/content/sample_text/Sed_eget.mdwn new file mode 100644 index 0000000..d360de3 --- /dev/null +++ b/content/sample_text/Sed_eget.mdwn @@ -0,0 +1 @@ +Sed eget turpis a pede tempor malesuada. Vivamus quis mi at leo pulvinar hendrerit. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Pellentesque aliquet lacus vitae pede. Nullam mollis dolor ac nisi. Phasellus sit amet urna. Praesent pellentesque sapien sed lacus. Donec lacinia odio in odio. In sit amet elit. Maecenas gravida interdum urna. Integer pretium, arcu vitae imperdiet facilisis, elit tellus tempor nisi, vel feugiat ante velit sit amet mauris. Vivamus arcu. Integer pharetra magna ac lacus. Aliquam vitae sapien in nibh vehicula auctor. Suspendisse leo mauris, pulvinar sed, tempor et, consequat ac, lacus. Proin velit. Nulla semper lobortis mauris. Duis urna erat, ornare et, imperdiet eu, suscipit sit amet, massa. Nulla nulla nisi, pellentesque at, egestas quis, fringilla eu, diam. diff --git a/content/sidebar.mdwn b/content/sidebar.mdwn new file mode 100644 index 0000000..06f20e8 --- /dev/null +++ b/content/sidebar.mdwn @@ -0,0 +1,9 @@ +This is the sidebar. + +* [[/index]] +* [[ikiwiki]] +* [[sandbox]] +* [[shortcuts]] +* [[templates]] + +``Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam tortor augue, lacinia eget libero eget, imperdiet scelerisque neque. Nam pretium dui sit amet rhoncus commodo. Sed eget faucibus purus, vel vulputate nulla. Sed accumsan odio ac dui vulputate, non venenatis velit iaculis. Quisque efficitur orci in tellus tincidunt, non maximus nisi finibus. Vestibulum tristique id eros ut dictum. Integer congue euismod metus, at feugiat nunc sagittis quis. Curabitur iaculis mi eget volutpat sodales. Ut nec dui et mi cursus tempor ac et sem. Nulla felis neque, congue tristique ultricies a, vehicula a ante.'' diff --git a/content/tag/Cicero/index.mdwn b/content/tag/Cicero/index.mdwn new file mode 100644 index 0000000..1db90cd --- /dev/null +++ b/content/tag/Cicero/index.mdwn @@ -0,0 +1,4 @@ +[[!meta title="pages tagged Cicero"]] + +[[!inline pages="tagged(Cicero)" actions="no" archive="yes" +feedshow=10]] diff --git a/content/tag/Latin/index.mdwn b/content/tag/Latin/index.mdwn new file mode 100644 index 0000000..eb55a31 --- /dev/null +++ b/content/tag/Latin/index.mdwn @@ -0,0 +1,4 @@ +[[!meta title="pages tagged Latin"]] + +[[!inline pages="tagged(Latin)" actions="no" archive="yes" +feedshow=10]] diff --git a/content/tag/typesetting/index.mdwn b/content/tag/typesetting/index.mdwn new file mode 100644 index 0000000..b017ffd --- /dev/null +++ b/content/tag/typesetting/index.mdwn @@ -0,0 +1,4 @@ +[[!meta title="pages tagged typesetting"]] + +[[!inline pages="tagged(typesetting)" actions="no" archive="yes" +feedshow=10]] diff --git a/.ikiwiki/ikiwiki.setup b/ikiwiki.setup similarity index 97% rename from .ikiwiki/ikiwiki.setup rename to ikiwiki.setup index d1ccd0d..b1ac831 100644 --- a/.ikiwiki/ikiwiki.setup +++ b/ikiwiki.setup @@ -16,7 +16,7 @@ adminuser: [] # users who are banned from the wiki banned_users: [] # where the source of the wiki is located -srcdir: ./ +srcdir: ./content # where to build the wiki destdir: ./public # base url to the wiki @@ -38,13 +38,23 @@ only_committed_changes: 0 # rcs backend to use rcs: '' # plugins to add to the default configuration -add_plugins: [] +add_plugins: +- 404 +- goodstuff +- favicon +- google +- sidebar +- highlight +- typography +- ikistrap # plugins to disable disable_plugins: [] # additional directory to search for template files -templatedir: /usr/share/ikiwiki/templates +templatedir: ../ikistrap/templates +#templatedir: /usr/share/ikiwiki/templates # base wiki source location -underlaydir: /usr/share/ikiwiki/basewiki +#underlaydir: /usr/share/ikiwiki/basewiki +underlaydir: ../ikistrap/basewiki # display verbose messages? verbose: 1 # log to syslog? diff --git a/index.mdwn b/index.mdwn deleted file mode 100644 index 63d4adf..0000000 --- a/index.mdwn +++ /dev/null @@ -1,11 +0,0 @@ -Welcome to [ikiwiki] hosted on [GitLab Pages](https://pages.gitlab.io)! - -[[!toc ]] - -# Heading 1 - -I'm a level 1 heading. - -## Heading 2 - -I'm a level 2 heading. diff --git a/themes/ikistrap b/themes/ikistrap new file mode 160000 index 0000000..16bcffa --- /dev/null +++ b/themes/ikistrap @@ -0,0 +1 @@ +Subproject commit 16bcffa6ed030c62d8a6d0c5b25db6f5ae45999c