HN 日本語サマリー

← 一覧へ戻る
プログラミング

Bashblog – ブログを作成するための単一のBashスクリプト

Bashblog – a single bash script to create blogs (github.com)

79 pointsby ludicrousdispla59 コメント

要約

Bashblogは、特別な要件や依存関係なしに、サーバー上の公開フォルダを使用してブログエントリを投稿するための非常にシンプルなBashスクリプトです。GNU/Linux、OSX、BSDで動作し、MarkdownやDisqusコメント、Twitter連携などの機能をサポートしています。すべてのコンテンツは静的で、単一のBashスクリプトファイルで管理されます。

全文翻訳

bashblog

ブログを作成するための単一のBashスクリプト。

サーバー上の公開フォルダを使用して、特別な要件や依存関係なしにブログエントリを投稿するための、非常に非常にシンプルな方法が欲しかったので作成しました。GNU/Linux、OSX、BSDで動作します。

どれくらいシンプルか? ./bb.sh post とタイプして、ブログ記事の執筆を開始するだけです。

[画像: asciinema](https://asciinema.org/a/4nr44km9ipow4s7u2w2eabeik)

サンプルはこちらで確認できます: 最初のブログ投稿を読む。そのページはbashblogのみを使用して100%生成されており、追加の調整は一切行っていません。

[画像: demo](https://raw.githubusercontent.com/cfenollosa/bashblog/gh-pages/images/demo.png)

他のbashblogユーザーをチェックしてみてください。

使用方法

コードをダウンロードし、bb.sh を公開フォルダ(例: $HOME/public_html/blog)にコピーして実行します。

./bb.sh

これにより、利用可能なコマンドが表示されます。ファイルが実行可能でない場合は、chmod +x bb.sh とタイプして再試行してください。

最初の投稿を作成する前に、ブログの設定(タイトル、著者など)を構成しておくと良いでしょう。詳細については、以下の「設定」セクションをお読みください。

最初の投稿を作成するには、次のように実行します。

./bb.sh post

インストールされていればMarkdownを使用しようとします。HTMLを強制するには:

./bb.sh post -html

スクリプトが残りを処理します。

完了したら、そのフォルダの公開URL(例: http://server.com/~username/blog)にアクセスすると、インデックスファイルと新しい投稿ページが表示されるはずです!

特徴

  • 超シンプルな使用法: お気に入りのエディタで投稿を入力するだけで、スクリプトが残りを処理します。テンプレート不要。
  • インストール不要。bb.sh をダウンロードしてブログを開始できます。
  • 依存関係ゼロ。ベースユーティリティ(date、basename、grep、sed、head など)のみで実行されます。
  • GNU/Linux、BSD、OSXと互換性があり、すぐに使用できます。MacでGNU coreutils を必要としません。システムに応じて必要なコマンドスイッチを自動検出するマジックを実行します。
  • すべてのコンテンツは静的です。公開Webフォルダを持つマシンへのシェルアクセスのみが必要です。ヒント: 上級ユーザーは、ftpfs を介してリモートの公開フォルダをマウントし、ローカルでこのスクリプトを実行できます
  • 下書きを許可し、シンプルでクリーンなスタイルシートを含み、RSSファイルを自動生成します。
  • タグ/カテゴリのサポート
  • Markdown、Disqusコメント、Twitter、Feedburner、Google Analyticsのサポート。
  • プロジェクトは2016年現在もメンテナンスされています。バグは修正され、新機能も検討されています(「貢献」を参照)。
  • すべてが約1k行の単一のbashスクリプトに格納されています。どうクールでしょう?! ;)

設定

テストドライブには設定は不要ですが、bashblogでブログを実行する予定がある場合は、デフォルトのタイトル、著者名などを自分に合わせて変更したくなるでしょう。

ブログ文字列を設定するには、2つの方法があります。

  • bb.sh を編集し、global_variables() 関数内の変数を変更します。
  • 設定値を記述した .config ファイルを作成します。これは、スクリプトを直接変更したくない場合や、gitで定期的に更新したい場合に便利です。

ソフトウェアはスクリプト内の値を最初にロードし、次に .config ファイルの値で上書きします。これは、設定ファイルにすべての変数を定義する必要はなく、デフォルトからオーバーライドしたいものだけを定義すればよいことを意味します。

.config ファイルの形式は、global_variables() 関数と同様に、1行に1つの variablename="value" です。覚えておいてください: 値は引用符で囲み、ドル記号で変数を宣言せず、等号の周りにスペースを使用しないでください。

bashblogはテキストエディタを開くために $EDITOR 環境値を 100% 使用します。

詳細機能

  • ブログ投稿のみで構成される、シンプルで美しく読みやすいデザイン。
  • 2.0の新機能 サードパーティライブラリによるMarkdownサポート。
    最も簡単な方法は、Gruberの Markdown.pl をダウンロードすることです。
  • 投稿プレビュー。
  • 投稿を下書きとして保存し、後で編集を再開できます。
  • 各投稿のHTMLページ。タイトルをURLとして使用します。
  • フロントページに表示する投稿数を設定可能。
  • RSSファイルの自動生成、Feedburnerサポート。
  • すべての投稿のインデックスを含む追加ページ。
  • 各タグのページを自動生成します。
  • 元のデータを保持しながら、すべてのファイルを再構築します。
  • コメントはTwitterに委任され、Disqusサポートも追加されています。
  • EU Cookie Law に準拠するための、クッキーレスTwitter共有オプション。
  • Google Analyticsコードサポート。
  • デフォルトで合理的にスタイル設定されたCSSが含まれています。
  • ヘッダー、フッター、および一般的に適切に構造化されたHTMLファイルに必要なすべての要素。
  • 各ページの上部に追加コンテンツ(バナー、画像など)を追加するサポート。
  • XHTML検証、CSS検証、W3CによるRSS検証。
  • サイトの自動バックアップ(投稿ごとに .backup.tar.gz として保存)。

さらに多くのアップデートについては、Changelogセクションを読むか、私のブログのニュースをチェックしてください。

貢献

Bashblogは500 SLOCで始まり、現在1000 SLOCの壁を突破しました。コードを最小限かつ理解しやすい状態に保つためには、機能を追加しすぎないようにする難しい努力が必要です。バグ修正は歓迎しますが、新しい機能はメインツリーに取り込まれるためには強く正当化される必要があります。すべての新しいリクエストは、コメントで正直かつ丁寧に議論されます。ガイドラインとして、プルリクエストは以下を行うべきです。

  • 一部のユーザーのユースケース(例: 国際化)を修正する。
  • 明らかに非常に一般的なユースケース(例: コメントのためのDisqus統合)を追加する。
  • 可能な限り小さくする(数行のコード)。
  • コードの大幅な書き直しを必要としない(create_html_file() や write_entry() などを壊さない)。
  • Linux、BSD、Macで動作すること。GNU coreutilsの非POSIXフラグ(例: date または grep)の使用には注意してください。
  • UNIX哲学に従う: 1つのことをうまく行い、外部機能にはサードパーティソフトウェアに依存する。
  • 常にデフォルト設定を使用する際に後方互換性を維持する。

Changelog

  • 2.11 staticpage_tag を追加。

  • 2.10 global_twitter_card_image を追加。

  • 2.9 body_begin_file_index を追加。

  • 2.8 バグ修正。
    Tomasz Jadowski氏によるスラブ語サポート。
    廃止されたTwitter JSON APIシェアカウントを削除。
    bashblogで管理されていない静的ファイルサポート。

  • 2.7 投稿日をHTMLファイルのコメントに保存(#96)。
    再構築時に、投稿日はコメントの日付とファイルの日付の間で同期され、コメントの日付が優先されます。

  • 2.6 複数著者のサポート、それぞれに異なる .config を使用。

  • 2.5 Martijn Dekker氏による大規模なコードクリーンアップ。
    'tags' コマンド。
    タグリスト(ウェブサイトとコマンドの両方)の単語 'posts' に単数形が追加されました。template_tags_posts_singular を確認してください。

  • 2.4 投稿用のTwitterサマリーメタデータを追加(#36)。

  • 2.3.3 大きなコメントヘッダーを削除。
    インデックスページでカットされた記事のタグを表示するオプションを追加(#61)。
    「すべての投稿」ページをクリーンアップ(#57)。

  • 2.3.2 トゥイッターの代わりにトップシーをリファレンスに使用するオプション。

  • 2.3.1 クッキーレスTwitterオプション。

  • 2.3 インテリジェントなタグ再構築とデフォルトでのMarkdown。

  • 2.2 柔軟な投稿タイトルからファイル名への変換。

  • 2.1 タグ/カテゴリのサポート。
    'delete' コマンド。

  • 2.0.3 他のアナリティクスコードのサポート(外部ファイル経由)。

  • 2.0.2 $body_begin_file が空の場合のバグを修正。
    GitHubプロジェクトへのリンクをフッターに追加。

  • 2.0.1 パーソナライズされたヘッダー/フッターファイルの使用を許可。

  • 2.0 Markdownサポートを追加。
    BSD dateを完全にサポート。

  • 1.6.4 ローカライズされた日付のバグを修正。

  • 1.6.3 BSD dateをサポート。

  • 1.6.2 重複情報を避けるために一部の関数と変数を簡略化。

  • 1.6.1 時間が1桁の場合の 'date' の修正。

  • 1.6.0 Disqusコメント。外部設定ファイル。'date' コマンドバージョンのチェック。

  • 1.5.1 その他バグ修正とパラメータチェック。

  • 1.5 Đurađ Radojičić (djura-san) がコードをリファクタリングし、柔軟性と国際化を追加。

  • 1.4.2 問題はGithubで処理されるようになりました。

  • 1.4 コードのリファクタリング。

  • 1.4 コメントにTwitterを使用、'rebuild' コマンドを改善。

  • 1.3 'edit' コマンド。

  • 1.2.2 Feedburnerサポート。

  • 1.2.1 タイムスタンプのバグを修正。

  • 1.2 'list' コマンド。

  • 1.1 下書きとプレビューのサポート。

  • 1.0 http://is.gd/Bkdoru を読む。

ライセンス

このプログラムはフリーソフトウェアです。GNU General Public License バージョン3、または(オプションで)それ以降のバージョンに基づき、再配布および/または改変することができます。

このプログラムは有用であることを期待して配布されていますが、いかなる保証もありません。商品性や特定目的への適合性の黙示的な保証も含まれません。詳細については、GNU General Public License を参照してください。

このプログラムは、GNU General Public License のコピーとともに配布されているはずです。そうでない場合は、http://www.gnu.org/licenses/ を参照してください。