概要

  • GRAV: DBいらずでmarkdown配置するだけでブログ作れるいいやつ
  • やり方: git clone or unzipする.

立て方

Nginx の場合、実行ユーザーがwww-dataなんでそれにする(/etc/nginx/nginx.confに書いてある)

sudo git clone https://github.com/getgrav/grav /var/www/html/grav
sudo chmod -R www-data:www-data /var/www/html/grav
cd /var/www/html/grav
bin/grav install admin
sudo cp /var/www/html/grav/webserver-configs/nginx.conf /etc/nginx/sites-enabled/grav.conf

webserver-configs/nginx.conf -> /etc/nginx/sites-enabled/blog.home.neso.tech.confの設定例

c.f. https://ssl-config.mozilla.org/

server{
    listen 80;
    listen [::]:80;
    server_name blog.home.neso.tech;
    return 301 https://$host$request_uri;
}

server{
    listen 443 ssl http2;
    listen [::]:443 ssl http2;

    index index.php index.html;

    root /var/www/html/grav;
    server_name   blog.home.neso.tech;

    ssl_certificate /etc/letsencrypt/live/blog.home.neso.tech/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/blog.home.neso.tech/privkey.pem;
    ssl_session_timeout 1d;
    ssl_session_cache shared:MozSSL:10m;  # about 40000 sessions
    ssl_session_tickets off;

    # modern configuration
    ssl_protocols TLSv1.3;
    ssl_prefer_server_ciphers off;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~* /(\.git|cache|bin|logs|backup|tests)/.*$ {
        return 403;
        }

    location ~* /(system|vendor)/.*\.(txt|xml|md|html|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ {
        return 403;
        }

    location ~* /user/.*\.(txt|md|yaml|yml|php|pl|py|cgi|twig|sh|bat)$ { return 403; }

    location ~ /(LICENSE\.txt|composer\.lock|composer\.json|nginx\.conf|web\.config|htaccess\.txt|\.htaccess) {
        return 403;
        }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock;
#       fastcgi_pass 127.0.0.1:9000;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root/$fastcgi_script_name;
    }
}

sudo nginx -t してokならsudo service nginx restart

こうなったら成功

おすすめプラグイン

  • Auto Date
    item.mdに執筆日が自動で挿入される
  • Git Sync
    githubのリポジトリの更新を検知してGRAVが自動で取得してくる
    = 記事書いてgit pushするだけで投稿できる

FAQ

聞かれたら書く

  • 500系エラーで動かない
    -> 大体割とパーミッションの問題だったりする.
    -> c.f. https://learn.getgrav.org/16/troubleshooting/permissions
  • 記事内で同じ画像が2枚出る
    -> item.mdのヘッダーにheader_image: "0"を追記するか、WebUIのDisplay Header ImageをDisableにする.
  • item.md の時刻表記がわからん
    dd-mm-yyyy MM:HH もしくは mm/dd/yyyy
    https://learn.getgrav.org/16/content/headers#date

    Dates in the m/d/y or d-m-y formats are disambiguated by looking at the separator between the various components: if the separator is a slash (/), then the American m/d/y is assumed; whereas if the separator is a dash (-) or a dot (.), then the European d.m.y format is assumed.

  • リプサムの消し方
    user/themes/テーマ名/templates/partials/sidebar.html.twig にあるらしい。
    c.f. https://kinformation.sakura.ne.jp/20170628-01
    まあリプサムが消えたところで、表示領域は増えないんだけど。