theme init

.gitlab-ci.yml

-image: alpine:latest
+image: elecnix/ikiwiki
+
+before_script:
+  - apt-get install -y git
+  - git submodule init
+  - git submodule update
+
+test:
+  stage: test
+  script:
+  - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib
+  only:
+  - branches
+  - tags
 
 pages:
   stage: deploy
   script:
-  - echo 'Nothing to do...'
+  - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib
   artifacts:
     paths:
     - public
   only:
   - master
-  tags:
-  - pages

LICENSE

+The MIT License (MIT)
+
+Copyright (c) 2016 pages
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

-![Build Status](https://gitlab.com/pages/plain-html/badges/master/build.svg)
+![Build Status](https://gitlab.com/pages/ikiwiki/badges/master/build.svg)
 
 ---
 
-Example plain HTML site using GitLab Pages.
+Example [ikiwiki] website using GitLab Pages.
 
 Learn more about GitLab Pages at https://pages.gitlab.io and the official
 documentation https://docs.gitlab.com/ce/user/project/pages/.
@@ -14,6 +14,7 @@ documentation https://docs.gitlab.com/ce/user/project/pages/.
 **Table of Contents**  *generated with [DocToc](https://github.com/thlorenz/doctoc)*
 
 - [GitLab CI](#gitlab-ci)
+- [Building locally](#building-locally)
 - [GitLab User or Group Pages](#gitlab-user-or-group-pages)
 - [Did you fork this project?](#did-you-fork-this-project)
 - [Troubleshooting](#troubleshooting)
@@ -25,13 +26,26 @@ documentation https://docs.gitlab.com/ce/user/project/pages/.
 This project's static Pages are built by [GitLab CI][ci], following the steps
 defined in [`.gitlab-ci.yml`](.gitlab-ci.yml):
 
-```
-image: alpine:latest
+```yaml
+image: elecnix/ikiwiki
+
+before_script:
+  - apt-get install -y git
+  - git submodule init
+  - git submodule update
+
+test:
+  stage: test
+  script:
+  - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib
+  only:
+  - branches
+  - tags
 
 pages:
   stage: deploy
   script:
-  - echo 'Nothing to do...'
+  - ikiwiki --setup ikiwiki.setup --libdir themes/ikistrap/lib
   artifacts:
     paths:
     - public
@@ -39,7 +53,20 @@ pages:
   - master
 ```
 
-The above example expects to put all your HTML files in the `public/` directory.
+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. 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][].
 
 ## GitLab User or Group Pages
 
@@ -58,10 +85,15 @@ unless you want to contribute back to the upstream project.
 
 ## Troubleshooting
 
-1. CSS is missing! That means that you have wrongly set up the CSS URL in your
-   HTML files. Have a look at the [index.html] for an example.
+1. CSS is missing! That means two things:
+
+    Either that you have wrongly set up the CSS URL in your templates, or
+    your static generator has a configuration option that needs to be explicitly
+    set in order to serve static assets under a relative URL.
 
 [ci]: https://about.gitlab.com/gitlab-ci/
-[index.html]: https://gitlab.com/pages/plain-html/blob/master/public/index.html
+[ikiwiki]: https://ikiwiki.info/
+[install]: https://ikiwiki.info/install/
+[documentation]: https://ikiwiki.info/
 [userpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#user-or-group-pages
 [projpages]: https://docs.gitlab.com/ce/user/project/pages/introduction.html#project-pages

content/Bootstrap_features.mdwn

+# 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 <http://v4-alpha.getbootstrap.com/getting-started/introduction/>.
+
+<div class="jumbotron" markdown="1">
+## Jumbotron
+
+It's big and in your face.
+
+---
+
+You can still use Markdown syntax inside HTML blocks, if you are careful.
+
+<a class="btn btn-primary btn-large" href="#">Button</a>
+</div>
+
+## Labels <span class="label label-info">Hi!</span>
+
+Span elements work inside Markdown headings.
+
+<div class="card card-block" markdown="1">
+## Cards
+
+Put a border with soft round corners around your content.
+</div>
+
+
+## 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.
+
+<div class="card-deck">
+<div class="card-deck-wrapper">
+<div class="card">
+[[!img Lemonshark.jpg alt="Lemon shark" class="card-img-top"]]
+<div class="card-block">
+<p class="card-text">
+A lemon shark and his little friends are out for a swim.
+</p>
+<p><a href="#" class="btn btn-danger">Escape</a></p>
+</div>
+</div>
+<div class="card">
+[[!img Anemones.jpg alt="Anemones" class="card-img-top"]]
+<div class="card-block">
+<p class="card-text">
+Anemones look really nice and are much less dangerous than lemon sharks.
+</p>
+<p><a href="#" class="btn btn-success">Admire</a></p>
+</div>
+</div>
+<div class="card">
+[[!img Sea_Star.jpg alt="Sea star" class="card-img-top"]]
+<div class="card-block">
+<p class="card-text">
+Sea stars are also less dangerous than lemon sharks, but they are slightly more dangerous than
+anemones, <em>especially</em> when stepped on.
+</p>
+<p><a href="#" class="btn btn-warning">Sidestep</a></p>
+</div>
+</div>
+</div>
+</div>
+
+## 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.
+
+<div class="card-columns">
+[[!inline pages="sample_text/* and !*/Discussion" template="simplecard" feeds="no"]]
+</div>
+
+
+## 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.
+
+<p>
+<div id="carousel-example-pages" class="carousel slide" data-ride="carousel">
+<ol class="carousel-indicators"></ol>
+<div class="carousel-inner" role="listbox">
+[[!inline pages="sample_text/* and !*/Discussion" template="carouselpage" feeds="no"]]
+</div>
+<a class="left carousel-control" href="#carousel-example-pages" role="button" data-slide="prev">
+<span class="icon-prev" aria-hidden="true"></span>
+<span class="sr-only">Previous</span>
+</a>
+<a class="right carousel-control" href="#carousel-example-pages" role="button" data-slide="next">
+<span class="icon-next" aria-hidden="true"></span>
+<span class="sr-only">Next</span>
+</a>
+</div>
+</p>
+
+If you only want to show images, use `template="carouselimage"`, and select your images directly with the `pages` parameter.
+
+<p>
+<div id="carousel-example-images" class="carousel slide" data-ride="carousel">
+<div class="carousel-inner" role="listbox">
+[[!inline pages="*.jpg" template="carouselimage" feeds="no"]]
+</div>
+<a class="left carousel-control" href="#carousel-example-images" role="button" data-slide="prev">
+<span class="icon-prev" aria-hidden="true"></span>
+<span class="sr-only">Previous</span>
+</a>
+<a class="right carousel-control" href="#carousel-example-images" role="button" data-slide="next">
+<span class="icon-next" aria-hidden="true"></span>
+<span class="sr-only">Next</span>
+</a>
+</div>
+</p>
+
+## 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.
+

content/Calendars.mdwn

+# 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"]]

content/Comments.mdwn

+# Comments
+
+This is an example of a page where comments are allowed.

content/Comments/comment_1._comment

+[[!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!
+"""
+]]

content/Comments/comment_2._comment

+[[!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.
+"""
+]]

content/Inline_pages.mdwn

+# 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"]]

content/index.mdwn

+# 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.
+
+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 <https://gitlab.com/pages/ikiwiki>.
+
+[gitlab pages]: https://pages.gitlab.io
+[ikistrap]: https://github.com/gsliepen/ikistrap

content/inlinetest.mdwn

+[[!inline pages="sample_text/*"]]

content/sample_text/Donec_dapibus.mdwn

+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.

content/sample_text/Donec_semper.mdwn

+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.

content/sample_text/Lorem_ipsum.mdwn

+[[!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.

content/sample_text/Nulla_facilisi.mdwn

+[[!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.

content/sample_text/Sed_eget.mdwn

+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.