包简介

Clean blog theme for Spress design by Start Bootstrap

README 文档

README

Clean blog theme is a ported theme to Spress designed by Start Bootstrap.

Live demo.

Features

Fully responsive.
Distraction free blog text optimized for legibility.
Support for tags and categories in posts.
Contact form powered by getsimpleform.
Comments powered by Disqus.
Code highlighted thanks to highlight.js.

Installation

You can create a site based on Clean blog or install this one as a theme of a pre-existing site.

Requirements:

Spress >= 2.2.0

Creating a new site based on this theme

Performs the following command and clean-blog theme will be installed in mysite folder:

$ spress new:site mysite spress-add-ons/clean-blog-theme

Install as a theme

Go to your site folder and performs the following command:

$ spress add:plugin spress-add-ons/clean-blog-theme

And add this line to the config.yml file of your site:

themes:
    name: "spress-add-ons/clean-blog-theme"

How to update?

You can get the latest version of Clean blog theme with just run the following command:

$ spress update:plugin

default.html: The base layout. The derived layouts inject their contents into this file at the line that says {{ page.content }}.
page.html: Layout for pages.
post.html: Layout for posts. They are located at ./src/content/posts.
collection.html: Layout used by collection pages: categories.html and tags.html.

Includes

Refers to snippets of code within the ./src/includes directory. These ones can be inserted in layouts and pages.

head.html: Defines the content of <head></head> in default layout.
footer.html: Defines the default footer section.
nav.html: Defines de top-menu based on pages with title.
paginator.html: Defines the pagination of the content.

Configuration

Comments

Comments are powered by Disqus and they need a disqus shortname. To get it, you need to create an account at this service. It's free.

comments:
  enabled: true
  disqus_shortname: "your-shortname"

Top menu

The top menu is composed by each of pages with title attribute. e.g: ./src/content/about.md:

title: "About me"

Contact form

The contact form is a AJAX form configured in config.yml:

forms:
    contact:
        getsimpleform_api_token:

You need a API key from getsimpleform service. It's free.

Writing a post

To create a new post, runs new:post command from Spress:

$ spress new:post

Each post could has a header and thumbnail image. You can configure your image and some data about it:

header_img:
  url: "assets/img/post-bg-07.jpg"
  author: "Yuri Samoilov"
  author_url: "https://flic.kr/p/mjhDwB"

Thumbnail images

The index.html page can display a thumbnail image for each post. This kind of images must be located at ./src/content/assets/img folder and the image may has the dimentions 100x100 px.

At the thumb_img key you can set the name of the image file like this:

thumb_img: spress.png

License

The theme is available as open source under the terms of the Apache 2.0.

spress-add-ons/clean-blog-theme 适用场景与选型建议

spress-add-ons/clean-blog-theme 是一款基于 JavaScript 开发的 Composer 扩展包，目前已累计 116 次下载、GitHub Stars 达 2，最近一次更新时间为 2015 年 01 月 25 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「blog」「bootstrap」「template」「responsive」「spress」「startbootstrap」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 spress-add-ons/clean-blog-theme 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 spress-add-ons/clean-blog-theme 我们能提供哪些服务？

定制开发 / 二次开发

基于 spress-add-ons/clean-blog-theme 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 spress-add-ons/clean-blog-theme 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

drewroberts/blog 3

Laravel package for opinionated blog implementation

emmanuel/livewire-datatable-bs4 16

Views for the package MedicOneSystems Livewire Datatables with Bootstrap 4

coldtrick/rss_to_blog 4

Import an RSS-feed into blog

gurubob/ascii-table 2

Simple ASCII output of array data

dynamic/bootstrap-select 3

bootstrap select field module implementing http://silviomoreto.github.io/bootstrap-select/

numberninecms/faker 0

Faker provider for NumberNine CMS

spress-add-ons/clean-blog-theme

包简介

关键字：