syocy / Honoka

Honoka is one of the original Bootstrap theme.

Home Page:http://honokak.osaka/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Honoka

Build Status

http://honokak.osaka/

honoka

"Honoka" は日本語も美しく表示できるBootstrapテーマです。

About "Honoka"

通常のBootstrapでは,日本語のフォント指定や文字サイズは最適とはいえません。"Honoka"はそんなBootstrapをベースに,日本語表示に適したフォント指定や,文字サイズに関するコードを追記したBootstrapテーマの一つです。

Live Demo

Usage

Honokaは単なるBootstrapテーマにしか過ぎないため,基本的な使い方は本家Bootstrapとほとんど変わりません。よって以下に書くことは本家Bootstrapからの引用,もしくはその一部を変更したものです。用意されたCSSクラスやコンポーネントなど,より詳細な使い方のドキュメントは本家Bootstrapの各種リファレンスページをご覧になることを推奨します。

Package

配布しているzipファイルの内容物は以下のとおりです。bootstrap.min.*といったように,ファイル名にminがつくファイルは,改行やインデント・スペーシングをなくした(minifyされた)コードで,ユーザがウェブページを読み込む際の転送量を少なくすることができます。通常はこのbootstrap.min.*を使うことをおすすめします。

honoka/
├─ bootstrap.html
├─ css/
│   ├─ bootstrap.css
│   └─ bootstrap.min.css
├─ fonts/
│   ├─ glyphicons-halflings-regular.eot
│   ├─ glyphicons-halflings-regular.svg
│   ├─ glyphicons-halflings-regular.ttf
│   ├─ glyphicons-halflings-regular.woff
│   └─ glyphicons-halflings-regular.woff2
└─ js/
    ├─ bootstrap.js
    └─ bootstrap.min.js

Basic Template

Bootstrapをつかってウェブページを作成する際に基本となるHTML部分は以下のようになります。CSSやJavaScriptのファイルパスは環境に合わせて変更する必要があります。

<!DOCTYPE html>
<html lang="ja">
  <head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
    <title>Bootstrap 101 Template</title>

    <!-- Bootstrap -->
    <link href="css/bootstrap.min.css" rel="stylesheet">

    <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
    <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
    <!--[if lt IE 9]>
      <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
      <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
  </head>
  <body>
    <h1>Hello, world!</h1>

    <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script>
    <!-- Include all compiled plugins (below), or include individual files as needed -->
    <script src="js/bootstrap.min.js"></script>
  </body>
</html>

Do you hate "YuGothic"?

もしあなたが日本語フォントに游ゴシックを指定したくない場合,その要素に対して.no-thank-yu(※youではなくyu)を指定することで游ゴシックの指定はされなくなり,Windowsであればメイリオ,Mac OS Xであればヒラギノ角ゴを優先的に使用するようになります。

例えばページ全体に対して游ゴシックを用いたくない場合は,<body>に対して.no-thank-yuを指定(<body class="no-thank-yu">)することで,ページ全体で游ゴシックは使用されなくなります。

Grunt

このリポジトリはGruntを使った自動タスクによって,テストや配布用パッケージを生成することができます。

Attention

Using Git Submodule

src/bootstrap/以下についてはGitのSubmodule機能を使ってtwbs/bootstra-sass(BootstrapのSass版コード)を読み込んでいるため,ReleaseページでダウンロードできるSource Codeというアーカイブの中に含まれていません。よってtwbs/bootstra-sassを直接ダウンロードしてファイルを配置する必要があります。

一番いいのは,Honokaのリポジトリ自体をgit cloneし,以下のコマンドを実行することです。

% git submodule update --init src/bootstrap

Using Compass

SassコードのコンパイルにCompassの機能の一部を使用しています。よってSassとは別にコンピュータへCompassがインストールされているする必要があります。

% gem install compass

Test

grunt server

テスト用サーバを起動します。localhost:8000に接続することでdist/以下のディレクトリをプレビューすることができます。また起動中にscssファイルを更新した場合,自動的にビルドされます(だがLive Reloadはされない)。

Build

grunt build

Bootstrapに関連するファイルのビルドを行います。

Package

grunt package

配布用パッケージを作成します。作成したファイルはdata/ディレクトリ(.gitignoreで無視ディレクトリに指定)のbootstrap-honoka-dist.zipへ出力されます。

License

MIT License

Author

About

Honoka is one of the original Bootstrap theme.

http://honokak.osaka/

License:MIT License


Languages

Language:HTML 69.0%Language:CSS 28.9%Language:JavaScript 1.8%Language:Ruby 0.2%