minima

Minima is a one-size-fits-all Jekyll theme for writers. It’s Jekyll’s default (and first) theme. It’s what you get when you run jekyll new.

Theme preview

minima theme preview

Installation

Add this line to your Jekyll site’s Gemfile:

gem "minima"

And add this line to your Jekyll site:

theme: minima

And then execute:

$ bundle

Contents At-A-Glance

Minima has been scaffolded by the jekyll new-theme command and therefore has all the necessary files and directories to have a new Jekyll site up and running with zero-configuration.

Layouts

Refers to files within the _layouts directory, that define the markup for your theme.

  • default.html — The base layout that lays the foundation for subsequent layouts. The derived layouts inject their contents into this file at the line that says `<article itemscope itemtype="http://schema.org/BlogPosting">

    Vericus Software as a Service (SaaS) — Terms and Conditions

These “Terms and Conditions” are related to the SaaS subscription between Vericus Pty Ltd (“Vericus”) and the customer identified in the letter (“Customer”) signed by Vericus and the Customer for the provision of the Services (“Letter”). These Terms and Conditions, together with the Documentation and the Letter, form the “Agreement” between the Customer and Vericus.

1. INTERPRETATION

1.1 The definitions and rules of interpretation in this clause apply in this Agreement.

Business Day: a day other than a Saturday, Sunday or public holiday when banks in Victoria, Australia, are open for business.

Change of Control: any change in the ability to control or direct, directly or indirectly, the board, executive body, decision making process or management of an entity by virtue of ownership, right of appointment, right to control election or appointment, voting rights, or the ability to control the exercise of voting rights, management agreement or any other agreement.

Confidential Information: any information that is proprietary or confidential by its nature or is either clearly labelled as such. Confidential Information includes details of the Services, and the results of any performance tests of the Services.

Configuration Fees: the fees payable by the Customer to Vericus for the Configuration Services, as set out in the Letter.

Configuration Services: the configuration services (if any) as more particularly described in the Letter.

Customer Data: the data inputted by the Customer, Users, or Vericus on the Customer’s behalf for the purpose of using the Services or facilitating the Customer’s use of the Services.

Customer PI: means Personal Information contained in Customer Data.

Data Subject: an identifiable individual or individual who is reasonably identifiable.

Documentation: the Letter, the documentation made available to the Customer by Vericus online via this link or such other web address notified by Vericus to the Customer from time to time, which sets out a description of the Services and the user instructions for the Services, and the Service Standards.

Effective Date: the date set out in the Letter.

Fees: the Configuration Fees, the Subscription Fees and any other fees and charges payable by the Customer to Vericus.

Initial Subscription Term: the initial term set out in the Letter.

Personal Information: has the meaning given to that term in the Privacy Laws.

Privacy Laws: all applicable privacy and data protection laws and regulations relating to or impacting on the handling, processing and/or privacy of Personal Information, including the Privacy Act 1988 (Cth), the Australian Privacy Principles (APPs) and Spam Act 2003 (Cth), in each case as such laws may be amended, repealed or superseded from time to time.

Renewal Period: has the meaning given to it in clause 13.1.

Services: the subscription services provided by Vericus to the Customer and the Configuration Services, each as more particularly described in the Documentation.

Service Standards: the service standards applicable to the Services from time to time, as made available here.

Software: any online software applications provided by Vericus as part of the Services.

Subscription Fees: the subscription fees payable by the Customer to Vericus for the User Subscriptions, as set out in the Letter.

Term: the Initial Subscription Term together with any Renewal Periods.

Users: any employees, agents and independent contractors of the Customer who are authorised by the Customer to use the Services and the Documentation, as further described in clause 3.

User Subscriptions: the user subscriptions set out in the Letter purchased by the Customer which entitle Users to access and use the Services and the Documentation in accordance with this Agreement.

1.2 Unless the context otherwise requires, words in the singular shall include the plural and in the plural shall include the singular

2. SERVICES

2.1 Subject to the Customer paying the Subscriptions Fees, the restrictions set out in clause 3 and the other terms and conditions of this Agreement, Vericus grants to the Customer a non-exclusive, non-transferable right, without the right to grant sublicences, to permit the Users to use the Services and the Documentation during the Term solely for the Customer’s internal business operations.

2.2 Vericus shall, during the Term, provide the Services to the Customer in accordance with the Service Standards

2.3 Vericus will, as part of the Services and in consideration of the support fees set out in the Letter, provide the Customer with Vericus’ standard support services in accordance with the Documentation.

3. USAGE RIGHTS AND LIMITATIONS

3.1 The Customer shall ensure that:

3.1.1 the maximum number of Users accessing and using the Services shall not exceed the number of User Subscriptions; and

3.1.2 it will not allow or suffer any User Subscription to be used by more than one individual User

3.2 The Customer shall permit Vericus (or its designated representative) to audit the Customer’s records in order to establish compliance with this Agreement. If any such audits reveals that:

3.2.1 access has been provided to any individual who is not a User, then without prejudice to Vericus’ other rights, the Customer shall promptly disable such access and Vericus shall not issue any further access to any such individual; and

3.2.2 the Customer has underpaid Subscription Fees to Vericus, then without prejudice to Vericus’ other rights, the Customer shall pay to Vericus an amount equal to such underpayment as calculated in accordance with the rates set out in the Letter within 5 Business Days of the date of the audit.

3.3 The Customer shall not (and shall procure that the Users shall not) use the Services to access, store, distribute or transmit any viruses, or allows any denial of service attacks, and Vericus reserves the right, without liability or prejudice to its other rights to the Customer, to disable the Customer’s access to any material that breaches the provisions of this clause 3.3.

3.4 The Customer shall not:

3.4.1 except as may be allowed by any applicable law:

3.4.1.1 attempt to copy, modify, duplicate, create derivative works from, frame, mirror, republish, download, display, transmit, or distribute all or any portion of the Software and/or Documentation (as applicable) in any form or media or by any means; or

3.4.1.2 attempt to de-compile, reverse compile, disassemble, reverse engineer or otherwise reduce to human-perceivable form all or any part of the Software;

3.4.2 access all or any part of the Services and Documentation in order to build a product or service which competes with the Services and/or the Documentation; or

3.4.3 license, sell, rent, lease, transfer, assign, distribute, display, disclose, or otherwise commercially exploit, or otherwise make the Services and/or Documentation available to any third party except the Users.

3.5 The Customer shall use all reasonable endeavours to prevent any unauthorised access to, or use of, the Services and/or the Documentation and, in the event of any such unauthorised access or use, promptly notify Vericus.

4. ADDITIONAL USERS

The Customer may, during the Term, purchase additional User Subscriptions. If the Customer wishes to purchase additional User Subscriptions, the Customer shall notify Vericus in writing. Vericus shall evaluate such request for additional User Subscriptions and respond to the Customer accordingly. Where Vericus approves the request, Vericus shall activate the additional User Subscriptions as soon as reasonably practicable and the Subscription Fees will be increased accordingly.

5. DATA AND PROPRIETARY RIGHTS

5.1 The Customer shall own all right, title and interest in and to all of the Customer Data that is not Customer PI and shall have sole responsibility for the legality, reliability, integrity, accuracy and quality of all such Customer Data.

5.2 Vericus own the rights in the data generated by the Service (the “Vericus Data”).

5.3  Vericus grants the Customer a licence to access the Vericus Data for the Term solely for the Customer’s internal business purposes. The Customer’s right to use the data does not include the right to sub-licence it, nor to sell or otherwise exploit it.

5.4 The Customer agrees that Vericus and/or its licensors own all intellectual property rights in the Services and the Documentation. Except as expressly stated herein, this Agreement does not grant the Customer any rights to, under or in, any patents, copyright, database right, trade secrets, trade names, trademarks (whether registered or unregistered), or any other rights or licences in respect of the Services or the Documentation.

5.5 Vericus confirms that it has all the rights in relation to the Services and the Documentation that are necessary to grant all the rights it purports to grant under, and in accordance with, the terms of this Agreement.

5.6 The Customer warrants and represents on a continuing basis that:

5.6.1 it complies with, has done and will continue to do all things necessary to ensure and maintain its compliance with Privacy Laws in relation to (i) the: collection, use and disclosure Customer PI, and (ii) disclosure of Customer PI to Vericus for the purposes permitted by and contemplated under this Agreement; and

5.6.2 it has collected Customer PI by lawful and fair means and otherwise in accordance with the Privacy Laws.

5.7 Vericus will take reasonable steps to protect Customer Data from unauthorised access, processing, disclosure or loss.

5.8 Customer acknowledges that Vericus uses third party service providers to provide storage and hosting services in connection with the Services, which involves the processes and storage of Customer Data (including Customer PI). As at the Effective Date, such third party is Amazon Web Services, whose privacy policy is available here.

6. THIRD PARTY PROVIDERS

6.1 The Customer agrees that the Services may access or make available the website content of third parties and that the Customer’s access will be solely at its own risk. Vericus makes no representation, warranty or commitment and, subject to clause 12.1, shall have no liability or obligation whatsoever in relation to the content or use of, or correspondence with, any such third-party website, or any transactions completed, and any contract entered into by the Customer, with any such third party.

7 VERICUS’ OBLIGATIONS

7.1 The Services will be provided substantially in accordance with the Documentation, except to the extent of any non-conformance which is caused by use of the Services contrary to Vericus’ instructions, or modification or alteration of the Services by any party other than Vericus (or persons duly authorised by Vericus).

7.2 If the Services do not conform with the foregoing undertaking, Vericus will, at its expense, use reasonable endeavours to correct any such non-conformance promptly, or provide the Customer with an alternative means of accomplishing the desired performance. Such correction or substitution constitutes the Customer’s sole and exclusive remedy for any breach of the undertaking set out in clause 7.1.

7.3 Notwithstanding the foregoing, Vericus:

7.3.1 does not warrant that the Customer’s use of the Services will be uninterrupted or error-free; or that the Services, Documentation and/or the information obtained by the Customer through the Services will meet the Customer’s requirements; and

7.3.2 is not responsible for any delays, delivery failures, or any other loss or damage resulting from the transfer of data over communications networks and facilities, including the internet, and the Customer agrees that the Services and Documentation may be subject to limitations, delays and other problems inherent in the use of such communications facilities.

8. CUSTOMER’S OBLIGATIONS

The Customer shall:

8.1 provide Vericus with all necessary co-operation in relation to this Agreement, and all necessary access to such information as may be required in order to provide the Services, including but not limited security access information and configuration services;

8.2 comply with all applicable laws and regulations with respect to its activities under this Agreement, including data privacy laws;

8.3 ensure that the Users use the Services and the Documentation in accordance with the terms and conditions of this Agreement and shall be responsible for any User’s breach of this Agreement;

8.4 obtain and shall maintain all necessary licences, consents, and permissions necessary for Vericus to perform its obligations under this Agreement, including those required by Privacy Laws;

8.5 ensure that its network and systems comply with the relevant specifications provided by Vericus from time to time; and

8.6 be solely responsible for procuring and maintaining its network connections, notably the internet connection, and all problems, conditions, delays, delivery failures and all other loss or damage arising from or relating to its network connections or telecommunications links or caused by the internet.

9. FEES

9.1 In order to access the Service, the Customer shall pay the Fees to Vericus in accordance with this clause 9 and the Letter.

9.2 The Subscription Fees in respect of the Initial Subscription Term shall be payable in full in advance within 30 Business Days of the Effective Date. The Subscription Fees in respect of any Renewal Period shall be payable in advance on each anniversary of the Effective Date.

9.3 If Vericus has not received payment within 5 days after the due date, and without prejudice to any other rights and remedies of Vericus, Vericus may immediately disable the Customer’s access to the Services whilst the invoice(s) concerned remain unpaid; and interest shall accrue on a daily basis on such due amounts at an annual rate equal to 3% over the then current base lending rate, commencing on the due date and continuing until fully paid, whether before or after judgment.

9.4 The Configuration Fees (if any) shall be payable as set out in the Letter.

9.5 All amounts and fees stated or referred to in this Agreement:

9.5.1 shall be payable in Australian Dollars;

9.5.2 are, subject to clause 11.2, non-cancellable and non-refundable;

9.5.3 are exclusive of GST, which shall be added to Vericus’ invoice(s) at the appropriate rate.

10 CONFIDENTIALITY

10.1 Each party may be given access to Confidential Information from the other party in order to perform its obligations under this Agreement. A party’s Confidential Information shall not be deemed to include information that:

10.1.1 is or becomes publicly known other than through any act or omission of the receiving party;

10.1.2 was in the other party’s lawful possession before the disclosure;

10.1.3 is lawfully disclosed to the receiving party by a third party without restriction on disclosure; or

10.1.4 is independently developed by the receiving party, which independent development can be shown by written evidence.

10.2 Subject to clause 10.3, each party shall hold the other’s Confidential Information in confidence and not make the other’s Confidential Information available to any third party, or use the other’s Confidential Information for any purpose other than the implementation of this Agreement.

10.3 A party may disclose Confidential Information to the extent such Confidential Information is required to be disclosed by law, by any governmental or other regulatory authority or by a court or other authority of competent jurisdiction, provided that, to the extent it is legally permitted to do so, it gives the other party as much notice of such disclosure as possible and, where notice of disclosure is not prohibited and is given in accordance with this clause 10.3, it takes into account the reasonable requests of the other party in relation to the content of such disclosure.

10.4 Neither party shall be responsible for any loss, destruction, alteration or disclosure of Confidential Information caused by any third party.

10.5 Vericus agrees that the Customer Data is the Confidential Information of the Customer.

10.6 No party shall make, or permit any person to make, any public announcement concerning this Agreement without the prior written consent of the other parties, except as required by law, any governmental or regulatory authority (including, without limitation, any relevant securities exchange), any court or other authority of competent jurisdiction.

10.7 This clause 10 shall survive termination of this Agreement, however arising.

11 INDEMNITY

11.1 Vericus shall defend the Customer, its officers, directors and employees against any claim that the Services or Documentation infringes any copyright or trademark effective as of the Effective Date, and shall indemnify the Customer for any amounts awarded against the Customer in judgment or settlement of such claims, provided that:

11.1.1 Vericus is given prompt notice of any such claim;

11.1.2 the Customer provides all reasonable co-operation to Vericus in the defence and settlement of such claim; and

11.1.3 Vericus is given sole authority to defend or settle the claim.

11.2 In the defence or settlement of any claim, Vericus may procure the right for the Customer to continue using the Services, replace or modify the Services so that they become non-infringing or, if such remedies are not reasonably available, terminate this Agreement immediately on notice to the Customer and refund the Customer any Subscription Fees for the unexpired Term as at the date of termination without any additional liability or costs to the Customer.

11.3 In no event shall Vericus, its employees, agents and sub-contractors be liable to the Customer to the extent that the alleged infringement is based on:

11.3.1 a modification of the Services or Documentation by anyone other than Vericus;

11.3.2 the Customer’s use of the Services or Documentation in a manner contrary to the instructions given to the Customer by Vericus; or

11.3.3 the Customer’s use of the Services or Documentation after notice of the alleged or actual infringement from Vericus or any appropriate authority.

11.4 The remedies under this clause 11, constitute the Customer’s sole and exclusive rights and remedies, and Vericus’ (including Vericus’ employees’, agents’ and sub-contractors’) entire obligations and liability, for infringement of any copyright or trade mark.

11.5 The Customer shall defend, indemnify and hold harmless Vericus against claims, actions, proceedings, losses, damages, expenses and costs (including without limitation court costs and reasonable legal fees) arising out of or in connection with the Customer’s use of the Services and/or Documentation.

12 LIABILITY

12.1 Nothing in this Agreement excludes the liability of Vericus:

12.1.1 for death or personal injury caused by Vericus’ negligence; or

12.1.2 for fraud or fraudulent misrepresentation.

12.2 Except as expressly and specifically provided in this Agreement:

12.2.1 the Customer assumes sole responsibility for results obtained from the use of the Services and the Documentation by the Customer, and for conclusions drawn from such use. Vericus shall have no liability for any damage caused by errors or omissions in any information, instructions or scripts provided to Vericus by the Customer in connection with the Services, or any actions taken by Vericus at the Customer’s direction;

12.2.2 all warranties, representations, conditions and all other terms of any kind whatsoever implied by statute or common law are, to the fullest extent permitted by applicable law, excluded from this Agreement; and

12.2.3 the Services and the Documentation are provided to the Customer on an “as is” basis.

12.3 Subject to clauses 12.1 and 12.2:

12.3.1 Vericus shall not be liable, whether in tort (including for negligence or breach of statutory duty), contract, misrepresentation, restitution or otherwise for any loss of profits, loss of business, depletion of goodwill and/or similar losses or loss or corruption of data or information, or pure economic loss, or for any special, indirect or consequential loss, costs, damages, charges or expenses however arising under this Agreement; and

12.3.2 Vericus’ total aggregate liability in contract (including in respect of the indemnity at clause 11.1), tort (including negligence or breach of statutory duty), misrepresentation, restitution or otherwise, arising in out of or in connection with this Agreement shall be limited to the annual Subscription Fees paid by the Customer.

13 TERM AND TERMINATION

13.1 The Term shall, unless otherwise terminated as provided in this clause 13, commence on the Effective Date and shall continue for the Initial Subscription Term and, thereafter, this Agreement shall be automatically renewed for successive periods of 12 months (each a “Renewal Period”), unless:

13.1.1 either party notifies the other party of termination, in writing, at least 60 days before the end of the Initial Subscription Term or any Renewal Period, in which case this Agreement shall terminate upon the expiry of the applicable Initial Subscription Term or Renewal Period; or

13.1.2 otherwise terminated in accordance with the provisions of this Agreement.

13.2 Without affecting any other right or remedy available to it, either party may terminate this Agreement with immediate effect by giving written notice to the other party if the other party:

13.2.1 fails to pay any amount due under this Agreement on the due date for payment and remains in default not less than 30 days after being notified in writing to make such payment;

13.2.2 commits a material breach of any other term of this Agreement which breach is irremediable or (if such breach is remediable) fails to remedy that breach within a period of 30 days after being notified in writing to do so;

13.2.3 repeatedly breaches any of the terms of this Agreement in such a manner as to reasonably justify the opinion that its conduct is inconsistent with it having the intention or ability to give effect to the terms of this Agreement; or

13.2.4 has a liquidator being appointed in respect of it or ceases, or indicates that it is about to cease, carrying on business.

13.3 On termination of this Agreement for any reason:

13.3.1 all licences granted under this Agreement shall immediately terminate and the Customer will immediately cease all use of the Services and/or the Documentation; and

13.3.2 any rights, remedies, obligations or liabilities of the parties that have accrued up to the date of termination, including the right to claim damages in respect of any breach of the Agreement which existed at or before the date of termination shall not be affected or prejudiced.

14 SUSPENSION

Without prejudice to any other right or remedy that Vericus may have, Vericus may suspend the Services at any time immediately by giving notice to the Customer:

14.1 for any actual or alleged breach of this Agreement;

14.2 if Vericus has not received payment of any Fees within 5 days of the due date; or

14.3 if Vericus considers that suspension is reasonably required to protect the security, confidentiality or integrity of the services provided by Vericus to any of its customers or the data of Vericus or any of its customers.

15 FORCE MAJEURE

Vericus shall have no liability to the Customer under this Agreement if it is prevented from or delayed in performing its obligations under this Agreement, or from carrying on its business, by acts, events, omissions or accidents beyond its reasonable control, including, without limitation, strikes, lock-outs or other industrial disputes (whether involving the workforce of Vericus or any other party), failure of a utility service or transport or telecommunications network, act of God, war, riot, civil commotion, malicious damage, compliance with any law or governmental order, rule, regulation or direction, accident, breakdown of plant or machinery, fire, flood, storm or default of suppliers or sub-contractors, provided that the Customer is notified of such an event and its expected duration.

16 MISCELLANEOUS

16.1 No failure or delay by a party to exercise any right or remedy provided under this Agreement or by law shall constitute a waiver of that or any other right or remedy, nor shall it prevent or restrict the further exercise of that or any other right or remedy. No single or partial exercise of such right or remedy shall prevent or restrict the further exercise of that or any other right or remedy.

16.2 Except as expressly provided in this Agreement, the rights and remedies provided under this agreement are in addition to, and not exclusive of, any rights or remedies provided by law.

16.3 If any provision or part-provision of this Agreement is or becomes invalid, illegal or unenforceable, it shall be deemed deleted, but that shall not affect the validity and enforceability of the rest of this Agreement. If any provision or part-provision of this Agreement is deemed deleted under this clause 16.3 the parties shall negotiate in good faith to agree a replacement provision that, to the greatest extent possible, achieves the intended commercial result of the original provision.

16.4 This Agreement constitutes the entire agreement between the parties and supersedes and extinguishes all previous agreements, promises, assurances, warranties, representations and understandings between them, whether written or oral, relating to its subject matter. Each party acknowledges that in entering into this Agreement it does not rely on and shall have no remedies in respect of any statement, representation, assurance or warranty (whether made innocently or negligently) that is not set out in this Agreement. Each party agrees that it shall have no claim for innocent or negligent misrepresentation based on any statement in this Agreement.

16.5 The Customer shall not, without the prior written consent of Vericus, assign, transfer, charge, sub-contract or deal in any other manner with all or any of its rights or obligations under this Agreement. Vericus may at any time assign, transfer, charge, sub-contract or deal in any other manner with all or any of its rights or obligations under this Agreement.

16.6 This Agreement may be executed in any number of counterparts, and by the parties as separate counterparts, but will not be effective until each party has executed at least one counterpart. Each counterpart shall constitute an original of this Agreement, but all the counterparts shall together constitute one and the same agreement.

17 NOTICES

17.1 Any notice required to be given under this Agreement shall be in writing and shall be delivered by hand or sent by pre-paid first-class post or recorded delivery post to the other party at its address set out in the Letter, or such other address as may have been notified by that party for such purposes.

17.2 A notice delivered by hand shall be deemed to have been received when delivered (or if delivery is not in business hours, at 9am on the first business day following delivery). A correctly addressed notice sent by pre-paid first-class post or recorded delivery post shall be deemed to have been received at the time at which it would have been delivered in the normal course of post.

18 LAW AND JURISDICTION

This Agreement and any dispute or claim arising out of or in connection with it or its subject matter or formation (including non-contractual disputes or claims) shall be governed by and construed in accordance with the law of Victoria, Australia and Each party irrevocably agrees that the courts of Victoria, Australia, shall have non-exclusive jurisdiction to settle any dispute or claim arising out of or in connection with this Agreement or its subject matter or formation (including non-contractual disputes or claims).

    <div class="u-spacer-lg"></div>
  </div>
</div>

</div>

</article> ` and are linked to this file via FrontMatter declaration layout: default.

  • home.html — The layout for your landing-page / home-page / index-page. [More Info.]
  • page.html — The layout for your documents that contain FrontMatter, but are not posts.
  • post.html — The layout for your posts.

Includes

Refers to snippets of code within the _includes directory that can be inserted in multiple layouts (and another include-file as well) within the same theme-gem.

  • disqus_comments.html — Code to markup disqus comment box.
  • footer.html — Defines the site’s footer section.
  • google-analytics.html — Inserts Google Analytics module (active only in production environment).
  • head.html — Code-block that defines the <head></head> in default layout.
  • header.html — Defines the site’s main header section. By default, pages with a defined title attribute will have links displayed here.

Sass

Refers to .scss files within the _sass directory that define the theme’s styles.

  • minima.scss — The core file imported by preprocessed main.scss, it defines the variable defaults for the theme and also further imports sass partials to supplement itself.
  • minima/_base.scss — Resets and defines base styles for various HTML elements.
  • minima/_layout.scss — Defines the visual style for various layouts.
  • minima/_syntax-highlighting.scss — Defines the styles for syntax-highlighting.

Assets

Refers to various asset files within the assets directory. Contains the main.scss that imports sass files from within the _sass directory. This main.scss is what gets processed into the theme’s main stylesheet main.css called by _layouts/default.html via _includes/head.html.

This directory can include sub-directories to manage assets of similar type, and will be copied over as is, to the final transformed site directory.

Plugins

Minima comes with jekyll-seo-tag plugin preinstalled to make sure your website gets the most useful meta tags. See usage to know how to set it up.

Usage

Home Layout

home.html is a flexible HTML layout for the site’s landing-page / home-page / index-page.

Main Heading and Content-injection

From Minima v2.2 onwards, the home layout will inject all content from your index.md / index.html before the Posts heading. This will allow you to include non-posts related content to be published on the landing page under a dedicated heading. We recommended that you title this section with a Heading2 (##).

Usually the site.title itself would suffice as the implicit ‘main-title’ for a landing-page. But, if your landing-page would like a heading to be explicitly displayed, then simply define a title variable in the document’s front matter and it will be rendered with an <h1> tag.

Post Listing

This section is optional from Minima v2.2 onwards.
It will be automatically included only when your site contains one or more valid posts or drafts (if the site is configured to show_drafts).

The title for this section is Posts by default and rendered with an <h2> tag. You can customize this heading by defining a list_title variable in the document’s front matter.

Customization

To override the default structure and style of minima, simply create the concerned directory at the root of your site, copy the file you wish to customize to that directory, and then edit the file. e.g., to override the _includes/head.html file to specify a custom style path, create an _includes directory, copy _includes/head.html from minima gem folder to <yoursite>/_includes and start editing that file.

The site’s default CSS has now moved to a new place within the gem itself, assets/main.scss. To override the default CSS, the file has to exist at your site source. Do either of the following:

  • Create a new instance of main.scss at site source.
    • Create a new file main.scss at <your-site>/assets/
    • Add the frontmatter dashes, and
    • Add @import "minima";, to <your-site>/assets/main.scss
    • Add your custom CSS.
  • Download the file from this repo
    • Create a new file main.scss at <your-site>/assets/
    • Copy the contents at assets/main.scss onto the main.scss you just created, and edit away!
  • Copy directly from Minima 2.0 gem
    • Go to your local minima gem installation directory ( run bundle show minima to get the path to it ).
    • Copy the assets/ folder from there into the root of <your-site>
    • Change whatever values you want, inside <your-site>/assets/main.scss

This allows you to set which pages you want to appear in the navigation area and configure order of the links.

For instance, to only link to the about and the portfolio page, add the following to you _config.yml:

header_pages:
  - about.md
  - portfolio.md

Change default date format

You can change the default date format by specifying site.minima.date_format in _config.yml.

# Minima date format
# refer to http://shopify.github.io/liquid/filters/date/ if you want to customize this
minima:
  date_format: "%b %-d, %Y"

Enabling comments (via Disqus)

Optionally, if you have a Disqus account, you can tell Jekyll to use it to show a comments section below each post.

To enable it, add the following lines to your Jekyll site:

  disqus:
    shortname: my_disqus_shortname

You can find out more about Disqus’ shortnames here.

Comments are enabled by default and will only appear in production, i.e., JEKYLL_ENV=production

If you don’t want to display comments for a particular post you can disable them by adding comments: false to that post’s YAML Front Matter.

Social networks

You can add links to the accounts you have on other sites, with respective icon, by adding one or more of the following options in your config:

twitter_username: jekyllrb
github_username:  jekyll
dribbble_username: jekyll
facebook_username: jekyll
flickr_username: jekyll
instagram_username: jekyll
linkedin_username: jekyll
pinterest_username: jekyll
youtube_username: jekyll
googleplus_username: +jekyll
rss: rss

mastodon:
 - username: jekyll
   instance: example.com
 - username: jekyll2
   instance: example.com

Enabling Google Analytics

To enable Google Analytics, add the following lines to your Jekyll site:

  google_analytics: UA-NNNNNNNN-N

Google Analytics will only appear in production, i.e., JEKYLL_ENV=production

Enabling Excerpts on the Home Page

To display post-excerpts on the Home Page, simply add the following to your _config.yml:

show_excerpts: true

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jekyll/minima. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

To set up your environment to develop this theme, run script/bootstrap.

To test your theme, run script/server (or bundle exec jekyll serve) and open your browser at http://localhost:4000. This starts a Jekyll server using your theme and the contents. As you make modifications, your site will regenerate and you should see the changes in the browser after a refresh.

License

The theme is available as open source under the terms of the MIT License.

A better way to do
written assessment

Now available at the following universities...

University of Melbourne Deakin University
Edith Cowan University Queensland University of technology