s7fy's blog

Yuruhuwa Develop

article_script2


メディアやコールアウトの挿入を楽にしよう！！

このブログで使用しているテーマでは、各種メディアとコールアウトをサポートしています。

  • 画像
  • Github Gist
  • Youtube
  • X Post(Tweet)
  • Vimeo
  • Instagram
  • コールアウト

嬉しい機能ですが、マークダウンで記述する性質上、ショートコードを覚えている必要があり、めんどくさいのです。 そこで、またスクリプトを用意しました。


import argparse
import shutil
import re
from pathlib import Path


def main():
    parser = argparse.ArgumentParser(
        description="Insert media into article"
    )

    parser.add_argument("article_name", help="Target article name")

    subparsers = parser.add_subparsers(
        dest="mode",
        required=True
    )

    # picture
    pic = subparsers.add_parser("picture", help="Insert picture")
    pic.add_argument("picture_name", help="Picture file name")
    pic.add_argument("-l", "--line", type=int, required=True)

    # callout
    callout = subparsers.add_parser("callout", help="Insert callout")
    callout.add_argument(
        "callout_type",
        choices=["alert", "warning", "tip"],
        help="Callout type"
    )
    callout.add_argument("-l", "--line", type=int, required=True)

    # youtube
    yt = subparsers.add_parser("youtube", help="Insert YouTube embed")
    yt.add_argument("url", help="YouTube URL")
    yt.add_argument("-l", "--line", type=int, required=True)

    # tweet
    tw = subparsers.add_parser("tweet", help="Insert tweet embed")
    tw.add_argument("url", help="Tweet URL")
    tw.add_argument("-l", "--line", type=int, required=True)

    args = parser.parse_args()
    handle(args)


def handle(args):
    article_path = resolve_article(args.article_name)

    insert_text = build_insert_text(args)
    new_content = insert_at_line(article_path, insert_text, args.line)

    safe_write(article_path, new_content)

    print(f"Inserted {args.mode} into {article_path} at line {args.line}")


# --------------- #
# Core functions  #
# --------------- #

def resolve_article(article_name: str) -> Path:
    candidates = [
        Path(f"/yout/path/content/posts/{article_name}/index.md")
    ]
    for p in candidates:
        if p.exists():
            return p
    raise FileNotFoundError("Article not found")


def insert_at_line(path: Path, insert_text: str, line_no: int) -> str:
    lines = path.read_text(encoding="utf-8").splitlines(keepends=True)

    if line_no < 1 or line_no > len(lines) + 1:
        raise ValueError("line number out of range")

    lines.insert(line_no - 1, insert_text + "\n")
    return "".join(lines)


def safe_write(path: Path, new_content: str):
    backup = path.with_suffix(path.suffix + ".bak")
    tmp = path.with_suffix(path.suffix + ".tmp")

    shutil.copy2(path, backup)
    tmp.write_text(new_content, encoding="utf-8")
    tmp.replace(path)


def build_insert_text(args) -> str:
    if args.mode == "picture":
        return f'{{{{< figure src="{args.picture_name}" title="" >}}}}'

    if args.mode == "callout":
        return f'{{{{< callout type="{args.callout_type}" text="" >}}}}\n' # {{< callout type="alert" text="" >}}


    if args.mode == "youtube":
        video_id = extract_youtube_id(args.url)
        return f'{{{{< youtube {video_id} >}}}}' # https://www.youtube.com/watch?v=w7Ft2ymGmfc → w7Ft2ymGmfc

    if args.mode == "tweet":
        tweet_id = extract_tweet_id(args.url)
        return f'{{{{< tweet {tweet_id} >}}}}' # https://x.com/GoHugoIO/status/877500564405444608 → user="GoHugoIO" id="877500564405444608"

    raise ValueError("Unknown mode")


def extract_youtube_id(url: str) -> str:

    m = re.search(r"v=([^&]+)", url)
    if m:
        return m.group(1)
    raise ValueError("Invalid YouTube URL")

def extract_tweet_id(url: str) -> str:
    m = re.search(r"https://x\.com/([^/]+)/status/([0-9]+)", url)
    if m:
        user = f'user="{m.group(1)}"'
        tweet_id = f'id="{m.group(2)}"'
        tweet = f"{user} {tweet_id}"
        return tweet

    raise ValueError("Invalid tweet URL")




if __name__ == "__main__":
    main()

主に使う機能として

…
Read more ⟶

vimrc_mac


Macでyy + pが使えない！！

Macでvimで作業するときの基礎コマンドであるヤンクとペーストですが、 Macでは.vimrcに設定をしないとペーストができないようです。 以下のように設定をしたら解決しました。

set clipboard=unnamed,unnamedplus
⚠️ Warning
以下の設定では、システムクリップボードレジスタが使えないので機能しなかったです。 
set clipboard=unnamedplus

念の為、unnamedとunnamedplusを指定しました。 どうやら、unnamedplusというのはunix系のレジスタで扱うシステムクリップボードのレジスタのようです。
なので、Macはunnamedを指定するとうまくいくみたいです。
vimでのヤンクとOSでのクリップボードでは格納されるレジスタや参照されるレジスタが違うので、うまく機能しなかったのかなと思います。
参考にした記事: .vimrcの設定

参考にした記事: レジスタ一覧

参考にした記事: レジスタ一覧(英語ソース)

…
Read more ⟶

article_script


記事のテンプレートを自動生成させる

hugoでは、Front Matterと呼ばれる機能をサポートしています。
ただ、これを書くのがめんどくさいんですよね。
そこで、記事を書く際に情報を自動的に記入するシェルスクリプトを書きました。

#!/bin/zsh
set -e

cd ~/blog

if [ -z "$1" ]; then
  echo "usage: $0 article_name"
  exit 1
fi

POST="/your/path/content/posts/$1.md"

DATE=$(date "+%Y-%m-%dT%H:%M:%S+09:00")
TAG_Y=$(date "+%Y")
TAG_YM=$(date "+%Y-%m")

if [ -e "$POST" ]; then
  echo "already exists: $POST"
  exit 1
fi

cat <<EOF > "$POST"
+++
date = '$DATE'
title = '$1'
tags = ['$TAG_Y', '$TAG_YM']
draft = true
+++

EOF

echo "made it : $POST"

vim $POST

シェルスクリプトの動きを簡単に紹介します。

  • 記事名を入力する
  • 決められたディレクトリに記事名.mdを作成する。
  • dateコマンドで現在時刻を整形して取得 → Front Matterに埋め込む
  • vimコマンドを実行し、即座に記事が書き始められます。

このようにテンプレートが挿入されて、悩まずに書き始められるようになりました。

…
Read more ⟶