インターステラ株式会社の技術ブログです
こんにちは。阿形です。 しばらく前にオフィスの気温や湿度を記録しようと買ったRaspberry Piと気温・湿度・気圧センサーのBME280をそろそろ動かそうかなとやってみました。 ただ、最近炎上案件を抱えているので余裕が無いので、あまり時間をかけずやってみます。 Raspberry PiとBME280の接続と設定 この記事の主眼はBigQueryにデータを投げるところなので、このあたりは以下の記 […]
こんにちは。阿形です。今回の記事は特殊な事情でちょっとややこしいので状況を説明しておきます。 弊社のドキュメント作成環境 弊社ではドキュメント作成にSphinxを使用し、GitLabでバージョン管理を行っています。さらにGitLabとNetlifyと連携させ、Netlify上でSphinxのドキュメントをビルド、そのままWebに公開することがあります。 更に追加条件で、Sphinxのドキュメント上 […]
こんにちは。阿形です。 先日SphinxでLaTeX経由でPDFを出力できるように設定しました。 ところが困ったことに、Webで表示するのに都合がいいようにSVGで埋め込んでいた画像が原因で、エラーになってPDFが生成されません。これはLaTeXの処理系がSVGに対応していないためです。例えばPNGの画像を埋め込んだ場合は問題なくPDF出力が可能です。 さてどうしたものかと思い調べてみると、やはり […]
OpenIconsによるPixabayからの画像 こんにちは。阿形です。 弊社社内では、各種ドキュメントをSphinxで書いてGitLab経由でNetlifyでビルドしWebブラウザで見られるようにしています。通常はこれで十分なんですが、諸般の事情でメール等で添付したり、紙に出力しなければならない場合、少々不便なこともあります。 SphinxでHTML出力したものをPDF化してもいいと思うのですが […]
こんにちは。阿形です。最近Sphinxでドキュメントを作成するようになっていますが、Sphinx自体の環境以外にも、いくつかやっておきたいことがあったので、メモ代わりにまとめておきます。なお、以下の説明はすべてmacOS High Sierraを使用する前提です。 フォントの追加 プログラミングやSphinxでドキュメント作成するとなるとどうしても全角文字と半角文字の混在が気になってきます。等幅フ […]
インターステラの阿形です。 最近仕様書を書くのにもSphinxを使っています。 reStructuredTextで文章を書くのはなかなかサクサク書けていいんですが、図は悩みどころ。 そこで簡単な図を挿入したいときに便利なblockdiag拡張を使ってみたので、その設定方法を書いていこうと思います。 blockdiagとは blockdiagとは、テキストからブロック図などの画像を生成するツール群で […]
こんにちは、國分です。 今回はGitLab環境のCI/CDに必要なGitLab Runnerの構築方法を説明します。 公式ドキュメントはこちら バイナリのダウンロード $ sudo curl --output /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/g […]
前回のsphinxで作成したHTMLをGitLab上で閲覧できるようにするまでの過程 GitLabにプロジェクトを作る。 https://gitlab.com/dashboard/projectsのNew projectからProject nameを決め、Create projectする。 Pushするには $ git config --global user.name "ユーザー名" $ git […]
こんにちは、國分です。 本日はドキュメント生成ツール「Sphinx」の試用について報告していきたいと思います。 チュートリアル通りにインストールから $ sudo pip install sphinx Cannot uninstall 'pyparsing'. It is a distutils installed project and thus we cannot accurately det […]
岩佐です. MacでPython3のプログラミングを始められるようにしましょう. 初心者向けです. 作業はターミナルで行います. ターミナルを開く [Finder]→[アプリケーション]→[ユーティリティ]と移動すると, ターミナルがあると思います. 開きます. すると, なにやら出てきましたよね. これがターミナルです. これをDock(画面下のアプリケーション一覧)に追加しておきましょう. タ […]
