All Posts

pre-commit テンプレートを更新(mypy 対応と default Python 指定)

以前紹介した pre-commit のテンプレートに対し、以下のアップデートを行った。

Read more ...


Poetry環境でのnumpyビルドエラーとバージョン制約による解決メモ

Windows上で、Gitから取得したPythonプロジェクトを poetry install した際に、numpy のビルドに失敗する事象に遭遇した。Poetry環境でのエラーでありながら、原因は numpy のビルド処理にあった。

Read more ...


Rancher利用後に壊れたWSL環境を再構築した手順

過去に Windows 上で Rancher を導入していた影響で、wsl install が正常に動作せず、WSL2 を利用できない状態が続いていた。今回、その WSL 環境を完全に初期化し、再構築することに成功したので、その手順を記録しておく。

Read more ...


ChatGPT「プロジェクト」機能の実践ノート

このページでは、 ChatGPT-4o / o3 系の「プロジェクト」機能 を Python 開発を中心とした問題解決ワークフローに組み込む方法を整理します。 機能の概要からモデル選定、巨大リポジトリの取り扱い、限界と対策まで 自分用メモ+ブログ記事を兼ねた備忘録です。

Read more ...


Markdown導入の検討と、reStructuredText継続の判断

Sphinx + ablog において、記事を reStructuredText ではなく Markdown で書く運用を検討した。

Read more ...


blockdiagの代替手段を模索したが断念した記録

sphinxcontrib.blockdiagについて、Pillow 9.5 依存がボトルネックだったので、諸々の移行対応を試みたが、最終的に移行を断念した記録です。

Read more ...


dotfiles管理における Rye 環境構築の整備ポイント

Poetry から Rye への移行を機に、bare-repo方式の dotfiles 管理で Python 開発環境の構築手順を再整理しました。

Read more ...


PoetryからRyeへの移行と、Netlifyビルドの完全対応

Poetryで管理していたPythonプロジェクトを、最近注目されているRyeに移行し、 さらにNetlifyでのデプロイまでを通して構成を整えた。この記事では、その手順と要点を記録しておく。

Read more ...


PoetryとRyeの比較と使い分け:Pythonプロジェクト管理の選択肢

Pythonプロジェクトにおいて、依存管理やパッケージ公開を行うためのツールとして、長らく Poetry が人気を集めてきました。しかし最近では、より高速かつシンプルな運用を可能とする Rye という新しいツールが注目されています。

Read more ...


Neovimで選択範囲をコメントアウト:comment.nvimをvim-plugで導入する

Neovimを使用していると、特にコードの一定範囲をコメントアウトしたい場面は多いです。 本記事では、Lua製の軽量プラグイン comment.nvimvim-plug で導入し、 ファイルタイプに応じたコメントのON/OFFをスムーズに行う方法を紹介します。

Read more ...


Python開発環境での poethepoet → doit への移行とベストプラクティス

Poetry を使った Python プロジェクトで、これまで poethepoet を使ってタスク管理をしていたが、以下の理由から doit への移行を行った。

Read more ...


Sphinxドキュメントのビルド性能を改善する

Sphinxを使った多言語ドキュメントの構築において、ビルド時間が長くなってきたことをきっかけに、性能改善を行いました。この記事では、改善前後の状況や、試行錯誤のプロセス、そして得られた成果を整理しておきます。

Read more ...


Sphinxビルド時間の計測手段(timeコマンドとMeasure-Command)

Sphinxで多言語サイトを構築・運用していると、ドキュメントビルドの所要時間が徐々に伸びてくることがあります。性能改善の第一歩として重要なのが、 現状のビルド処理にどの程度時間がかかっているのか を把握することです。

Read more ...


gh-pagesブランチで運用するドキュメント公開とその比較知識の整理

GitHub Pages の gh-pages ブランチを活用したドキュメント公開の仕組みについて、学びの多かった内容を整理する。

Read more ...


Python製タスク自動化ツール「doit」の基本

Pythonで書けるタスク自動化ツール「doit」について、基本的な考え方と導入方法、簡単な使用例までを整理した作業メモです。

Read more ...


MkDocs + mkdocstrings で Python コード連動のドキュメントを公開

Python のコードから自動で API ドキュメントを生成し、それを MkDocs を使って GitHub Pages 上に公開するまでの体験を行ったので、その手順と感想をまとめておきます。

Read more ...


Poetry と MkDocs を使って GitHub Pages に自己紹介ページを公開する手順メモ

Poetry でパッケージ管理しながら、MkDocs を使って簡単な静的ページを作成し、GitHub Pages に公開するまでの手順を整理した実践メモです。

Read more ...


Supabaseで無料のPostgreSQL環境を入手する

クラウドで無料のリレーショナルデータベースを使いたいと考えたとき、Supabaseは非常に有力な選択肢のひとつです。この記事では、Supabaseを用いてPostgreSQLの無料環境をすばやく、安全に利用開始するための基本的なポイントをまとめます。

Read more ...


tmuxでvi操作でコピーするcopy-modeまとめ

SSH経由でリモートのUbuntuに接続し、tmux上で作業しているときに、 Vimのような操作感でコピーができる ととても便利です。 本記事では、tmuxでの copy-mode を使って、マウスを使わずにキーボードだけで文字列を選択・コピーする方法 を紹介します。

Read more ...


REST APIのStubを手早い立上げにMockoonを使った記録

REST APIの本実装が遅れてたり、昔作ったスタブが動かなくなっていたり、ともかく急ぎで、フロントエンド開発や結合テストを行う必要性に迫られるケースという局面に最近よく遭遇します。 とにかく「今すぐ」「最低限のStubが必要」という状況でMockoonが便利そうなので導入手順をまとめました。

Read more ...


pre-commit フックを GitHub Actions で自動更新する

pre-commit autoupdate を定期的に自動実行し、フックのバージョン更新PRを GitHub Actions 経由で作成する仕組みを紹介します。

Read more ...


pre-commit フックの設定網羅テンプレート

本記事では、Git のコミット前に自動実行できる pre-commit のフックを幅広く網羅し、設定例(テンプレート)として整理しておきます。 「まずはすべて入れて、不要なものを削る」という使い方を想定しています。

Read more ...


pre-commit 導入メモ

本記事では、Git コミット前にコードやドキュメントの整形・チェックを自動で行うツール pre-commit について、導入方法と活用を整理します

Read more ...


iPadでのキーボード操作を快適にする工夫

普段Windowsで作業している人がiPadにキーボードをつないで本格作業をしたい場合、キー配列の違いやショートカット操作のギャップに戸惑うことがあります。 この記事では、iPadでの作業効率を高めるための修飾キーの入れ替え方法と、覚えておくと便利なキー操作をまとめました。

Read more ...


iPad上でSSH環境を無料で整える方法(iSH + OpenSSH)

無料アプリ iSH を使って、iPad上にSSH環境を構築する手順 をまとめました。 ここまででLinuxにzsh + neovim + tmux での環境を整えてきたのでSSH接続さえ確立できれば、いつでも作業が可能になります。

Read more ...


Windows Terminal の便利操作集

Windows Terminal 上での操作は、シェルの種類に関わらず共通して使えるものが多く、習得しておくと非常に効率が上がります。 特に便利なものは意識的に使って体にしみ込ませてしまいたいものですが、使わないと忘れてしまうのでまとめておきます。

Read more ...


Oracle Cloud上の開発用HTTPサーバにSSHトンネルでアクセスする方法

Sphinx + ablog による静的サイトを Oracle Cloud 上の Ubuntu サーバで管理しているとき、 git push 前にローカルでの表示確認を行いたいケースがあります。 外部からHTTPで直接アクセスできない状況でも、SSHトンネルを活用すれば開発中のサイトの確認が可能です。

Read more ...


最小構成で導入する Zsh プラグイン

Zsh での最小構成の Zsh プラグイン導入方法を紹介します。 本記事では、プラグインマネージャを使わずに手動で導入し、必須プラグインの構成を整理します。

Read more ...


tmux 導入メモ

linux環境でセッションが切れても再開できる仕掛けであるtmuxについて導入し利用していきます。インストールと最小限の操作方法をまとめました。

Read more ...


Windows Terminal + WSL メモ

Windows Terminal + WSLの利用の自分用メモです。

Read more ...


Neovimでのプラグイン管理とGitHub Copilot導入メモ

Neovimをインストールした直後の環境に、最小限のプラグインを導入して、自動補完環境を構築した記録です。 最初の段階では vim-plug をプラグインマネージャとして採用し、1つ目のプラグインとして GitHub Copilot を導入しました。

Read more ...


vi と Emacs で迷子にならないために

Linuxの2大エディタ Vi と Emacs。どちらも使う機会は少なく、不慣れな状態で使うと迷子になりがちです。 そこで、最低限の操作だけでも押さえておくことを目的に記事をまとめました。

Read more ...


Neovimの導入と初期設定、sudoeditとの関連と注意点

WindowsでVSCodeという開発スタイルで十分ですが、あえてLinux環境で開発を行うならvi系のエディタを極めるのも一つの選択肢です。 この記事では、Neovimの導入と初期設定を整理します。また、避けるべきsudo nvimコマンドとsudoeditについてもまとめます。

Read more ...


Sphinx + ablog でDraftを自動公開するための自動ビルドの設定

Sphinx + ablog でのブログ運営では「投稿日を未来日にしておく」ことで、ドラフト記事を準備できます。しかし、公開日以降にビルドが走らない限りWebサイトには反映されません。本記事では自動ビルドを実行する方法を考察します。

Read more ...


Linux環境で自分専用環境を再現する

Linux新環境で手早く自分専用の環境を立ち上げる手順と考え方をまとめます。

Read more ...


zsh + starship で始めるモダンシェル環境セットアップ

新しく入手した Linux を “bash のまま” で妥協しない。zsh と高速・多機能プロンプト starship を導入し、最低限押さえておきたい設定を一気に整えモダンなシェル環境を構築します。

Read more ...


Bare‑repo方式ではじめる Linux dotfiles 管理

本記事ではBare-repo方式でのdotfiles管理について整理します。dotbot / yadm / homeshick / chezmoi などdotfile管理マネージャがありますが、初期ではgitだけで完結する Bare‑repo方式で十分です。いつか、困るようなことがあれば、dotfile管理マネージャ への移行を再検討することにします。

Read more ...


Linux環境で行う初回作業

新しくLinux環境を手に入れたとき、毎回行う作業があります。しかし、その作業内容を毎回調べ直すのは非効率です。本記事では、私が行っている初回セットアップと、その後の保守作業についてまとめました。主にUbuntuベースの環境を想定しています。

Read more ...


Oracle Cloud で 無料 Linux 環境を手に入れる

Oracle Cloud Free Tierで無料インスタンスを作成し、WindowsからSSH接続するまでの手順を記録します。

Read more ...


ablogで”/blog.html”と”/blog/index.html”の競合への対処

ablog を使ってブログサイトを構築していたところ、ビルド後の出力で /blog.html/blog/index.html の両方が生成されてしまい、URLの扱いやリンクの挙動で混乱する場面がありました。本記事ではその原因と対処法についてまとめておきます。

Read more ...


ブログ運用にAblogを活用する

純粋なSphinxの機能よりも、もう少しブログっぽく運用したい場合にAblogを活用すると便利

Read more ...


python環境の再構築

sphinx+netlify環境にてpython3.8からpython3.13環境に再構築を行った際の対応のまとめ

Read more ...


netlifyで302リダイレクト

netlifyで302リダイレクトを実現する方法をまとめた。

Read more ...


サイト更新再開にあたり

久しぶりにサイトの更新を再開するにあたって行ったことのまとめ

Read more ...