🔄 synced local 'docs' with remote 'cheatsheets'

Author: HansRobo

docs/AIとの付き合い方.md

@@ -4,7 +4,7 @@ created: 2025-01-14 04:48:47
 
 ## 完璧を求めない
 
-人間なら間違えても許されるようなタスクでも、AIになった途端に完璧を求めて「使えない」という人も多い。
+人間なら間違えても許されるようなタスクでも、AIが相手になった途端完璧を求めて「使えない」という人も多い。
 完璧かそうじゃないか、という解像度の低い使い方はせずに、人間相手にそうやっているように、性能に応じた期待値を自分の中で適切に設定して使う。
 
 ## 得意なことを把握して使う

docs/CMake.md

@@ -12,8 +12,8 @@ intro: CMake
 
 ### パッケージの探索結果で分岐する
 
-`find_package(pkg_name)`の結果は`pkg_name_FOUND`に出力されるのを利用する.
-REQUIRED指定すると見つからなかった場合にビルドエラーになっていしまうので注意
+`find_package(pkg_name)`の結果は`pkg_name_FOUND`に出力されるのを利用する。
+REQUIRED指定すると見つからなかった場合、ビルドエラーになっていしまうので注意
 
 ```CMakeLists.txt
 find_package(Boost)
@@ -26,7 +26,7 @@ endif()
 
 #### 基礎
 
-- 名前をつけた引数は`${引数名}`の形で関数内で参照可能
+- 名前をつけた引数は`${引数名}`の形で関数内参照可能
 - ↑からはみ出た引数は`${ARGN}`にセミコロン区切りで詰め込まれる
 
 ```cmake

docs/GNOME 拡張機能.md

@@ -38,6 +38,8 @@ intro: おすすめGNOME拡張機能
 
 ### CPUFreq
 
+<!-- cspell:ignore cpufreq -->
+
 [cpufreq - GNOME Shell Extensions](https://extensions.gnome.org/extension/1082/cpufreq/)
 
 ![panel](https://extensions.gnome.org/extension-data/screenshots/screenshot_1082_8G7gjUt.png)
@@ -51,22 +53,22 @@ intro: おすすめGNOME拡張機能
 ### Extension Sync
 
 GitHubのgist経由でGNOME拡張機能の設定ファイルを同期できるプラグイン  
-拡張機能の同期はありそうでなかった機能だったのでとても便利に使わせてもらっている．
+拡張機能の同期はありそうでなかった機能だったのでとても便利に使わせてもらっている。
 
 現在、Ubuntu24.04では使えないので残念
 
 同期するには設定で以下の2点が必要  
 
 - GitHub GistのID  
-  - 初めての場合[ここ](https://gist.github.com/)から作る  
+  - はじめての場合[ここ](https://gist.github.com/)から作る  
   - 入力するのは`https://gist.github.com/username/XXXXX`の`XXXX`  
 - GitHubのパーソナルアクセストークン  
 ![](https://camo.githubusercontent.com/4c0e0828590709add17450112c0e65a9b053f7aef2f6c24df274c3ff263404ae/68747470733a2f2f692e696d6775722e636f6d2f345376334a75732e706e67)
 
 ### Tactile
 
 [Tactile - GNOME Shell Extensions](https://extensions.gnome.org/extension/4548/tactile/)
-キーボードでウインドウレイアウトを自由自在に操れるように！
+キーボードでウインドウレイアウトを自由自在に操れる！
 
 ![](https://extensions.gnome.org/extension-data/screenshots/screenshot_4548_Xf0qiGj.gif)
 

docs/GitHub Actions.md

@@ -11,7 +11,7 @@ intro: GitHub Actions
 ## ファイルを同期したい
 
 [Repo File Sync Action · Actions · GitHub Marketplace · GitHub](https://github.com/marketplace/actions/repo-file-sync-action)
-これを使う．同期するファイルは`sync.yaml`という設定ファイルで管理．
+これを使う。同期するファイルは`sync.yaml`という設定ファイルで管理。
 同期先のパスが変わってもOK
 
 ## ファイルの変更監視
@@ -27,12 +27,14 @@ pull_request
 
 - 同時に両方使えない
 - pathsでは！が使える
-  - paths-ignoreで書けてpathsで書けない表現は無く，逆は成り立たない
+  - paths-ignoreで書けてpathsで書けない表現は無く、逆は成り立たない
 
 参考：[GitHub Actionsにおけるpathsとpaths-ignoreをベン図で理解する - Qiita](https://qiita.com/nacam403/items/3e2a5df5e88ba20aa76a)
 
 ### GitHub Actionsの中でsshを使ったgit cloneがしたい
 
+<!-- cspell:ignore MrSquaare -->
+
 ```yaml
 - name: Setup SSH
   uses: MrSquaare/ssh-setup-action@v1

docs/KDE.md

@@ -31,6 +31,8 @@ reboot
 
 ### KDEのWalletの無効化
 
+<!-- cspell:ignore kwallet kwalletrc -->
+
 KDE付属のパスワード管理ソフト「kwallet」
 
 ~/.config/kwalletrcに

docs/ROS Message.md

@@ -19,6 +19,6 @@ intro: ROS Message
   - シリアライズ・デシリアライズ関数
 - xx\_\_struct.h/hpp
   - structの定義、equal/ not equal演算子の定義
-- xx\_\_traitshpp
+- xx\_\_traits.hpp
   - yamlへの変換関数の定義
 - xx\_\_type_support.h/hpp/c

docs/ROS News.md

@@ -22,7 +22,7 @@ void spin_until_timeout(rclcpp::node_interfaces::NodeBaseInterface::SharedPtr no
 
 - [提案Issue](https://github.com/ros2/rclcpp/issues/1821)
 - [PullRequest #1874](https://github.com/ros2/rclcpp/pull/1874)
-  - 2022/01/24に`rolling`にマージ
+  - 2022/01/24に`rolling`へマージ
 - [デグレ発覚によりリバート #1956](https://github.com/ros2/rclcpp/pull/1956)
   - 2022/01/25
 - [現在再マージに向けて調整中 #1957](https://github.com/ros2/rclcpp/pull/1957)
@@ -51,10 +51,10 @@ std_msgs/msg/Int64MultiArray
 プルリク：[Pull Request #2041 · ros2/rclcpp · GitHub](https://github.com/ros2/rclcpp/pull/2041)  
 議論：[Issue #831 · ros2/rclcpp · GitHub](https://github.com/ros2/rclcpp/issues/831#issue-486100658)
 
-ROS1時代に逆行しようと言うのではなく，使いにくかったインタフェースを直すという意味
+ROS1時代に逆行しようと言うのではなく、使いにくかったインタフェースを直すという意味
 
 Nodeクラスのインタフェースは適切に分離されて提供されている
-しかし，複数の機能を必要とする関数などにはやや冗長な以下のような書き方を強要していた
+しかし、複数の機能を必要とする関数などにはやや冗長な以下のような書き方を強要していた
 
 ```c++
 create_service(
@@ -67,7 +67,7 @@ auto service = create_service(
   // ...
 ```
 
-そこで，コンセプトの考え方を取り入れて適切に権限管理されたNodeHandleを使ってこれを以下のように簡素化しようというのが今回のプルリク
+そこで、コンセプトの考え方を取り入れて適切に権限管理されたNodeHandleを使ってこれを以下のように簡素化しようというのが今回のプルリク
 
 ```c++
 create_service(
@@ -82,4 +82,6 @@ auto service = create_service(
 
 ### `ros2 topic echo`での `--timeout <sec>`オプション
 
+<!-- cspell:ignore arjo -->
+
 [Adds a timeout feature to rostopic echo by arjo129 · Pull Request #792 · ros2/ros2cli · GitHub](https://github.com/ros2/ros2cli/pull/792)

docs/ROS Packages.md

@@ -30,12 +30,12 @@ logger.debug("DEBUG MESSAGE");
 グリッドマップを扱う強力なライブラリ  
 [ANYbotics/grid_map](https://github.com/ANYbotics/grid_map)
 
-ROS2対応はゆっくりなので，TIERIVフォークの方が良い  
+ROS2対応はゆっくりなので、TIER IVフォークの方が良い  
 [tier4/grid_map/tree/prepare/humble](https://github.com/tier4/grid_map/tree/prepare/humble)
 
 ### generate_parameter_library
 
-ROS2のパラメータをライブラリに固めて配布したり出来るライブラリ
+ROS2のパラメータをライブラリに固めて配布したりできるライブラリ
 
 [PickNikRobotics/generate_parameter_library](https://github.com/PickNikRobotics/generate_parameter_library)
 
@@ -45,7 +45,9 @@ ROS1/2の統一的Pythonインタフェースを提供するパッケージ
 <https://github.com/suurjaak/rosros>
 
 環境変数からROSバージョンを自動切り替えできる！
-以下のようにpub/subはもちろんのこと，serviceやparameterなどにも対応する
+以下のようにpub/subはもちろんのこと、serviceやparameterなどにも対応する
+
+<!-- cspell:ignore rosros -->
 
 ```python
 import rosros
@@ -54,8 +56,8 @@ def on_trigger(req):
     pub.publish(True)
     return {"success": True, "message": "Triggered!"}
 
-rosros.init_node("mynode")
-params = rosros.init_params(service="/trigger", topic="/triggerings")
+rosros.init_node("my_node")
+params = rosros.init_params(service="/trigger", topic="/triggering")
 srv = rosros.create_service(params["service"], "std_srvs/Trigger", on_trigger)
 pub = rosros.create_publisher(params["topic"], "std_msgs/Bool", latch=True, queue_size=2)
 rosros.spin()
@@ -65,5 +67,5 @@ rosros.spin()
 
 [GitHub - ros-controls/realtime\_tools](https://github.com/ros-controls/realtime_tools)
 
-色々ツールがあるが，実装を見て何がリアルタイムになって何がリアルタイムにならないか把握し上で使ったほうが良さそう．
-例えば，RealTimePublisherはpublish関数にブロックされる時間が短くなるだけで通信がリアルタイムになったりする効果はない
+色々ツールがあるが、実装を見て何がリアルタイムになって何がリアルタイムにならないか把握し上で使ったほうが良さそう。
+たとえば、RealTimePublisherはpublish関数にブロックされる時間が短くなるだけで通信がリアルタイムになったりする効果はない

docs/ROS Tips.md

@@ -11,12 +11,14 @@ intro: ROS Tips
 ## vcstool
 
  OSRFでROS 2プロジェクトを引っ張ってきたDirk Thomas氏によって作られたメタリポジトリなどでのvcs操作をかんたんにするツール。
-  ただし、氏がNVIDIAに移籍してからは氏の対応が極端に遅くなり，IssueやPullRequestでは氏へ数多の”Friendly Ping”が送られているがそのほとんどは返信がない。
+  ただし、氏がNVIDIAに移籍してからは氏の対応が極端に遅くなり、IssueやPullRequestでは氏へ数多の”Friendly Ping”が送られているがそのほとんどは返信がない。
 
-  ROSコミュニティの中核の一つをなすこのツールがフリーズする状況は芳しくないため、Steven! Ragnarök氏のフォークやvcstools2を作るものも現れている。
+  ROSコミュニティの中核の1つをなすこのツールがフリーズする状況は芳しくないため、Steven! Ragnarök氏のフォークやvcstools2を作るものも現れている。
 
 ### 参考
 
+<!-- cspell:ignore MaxandreOgeret -->
+
 - [Status of vcstool · Issue #242 · dirk-thomas/vcstool · GitHub](https://github.com/dirk-thomas/vcstool/issues/242)  
 - [GitHub - MaxandreOgeret/vcstool2](https://github.com/MaxandreOgeret/vcstool2/)
 
@@ -35,12 +37,14 @@ intro: ROS Tips
   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 ```
 
+<!-- cspell:ignore jspricke -->
+
   MoveIt2でも使われている他、Autowareでも試用されている
   [Network Dependents · jspricke/ros-deb-builder-action · GitHub](https://github.com/jspricke/ros-deb-builder-action/network/dependents)
 
 ### 公式ツール・パッケージの置き場所
 
-  複数オーガナイゼーションに別れて配置されているので忘れやすいのでメモ
+  複数オーガナイゼーションに別れて配置されているため忘れやすいのでメモ
 
 - [colcon · GitHub](https://github.com/colcon)
   - colcon本体・プラグイン
@@ -57,7 +61,7 @@ intro: ROS Tips
   - [ros2/ros2cli](https://github.com/ros2/ros2cli)
     - `ros2 <verb>`コマンド
   - [ros2/rclcpp](https://github.com/ros2/rclcpp)
-  - サンプル系（demosのほうがサンプルが豊富）
+  - サンプル系（demosのほうがサンプル豊富）
     - [ros2/examples](https://github.com/ros2/examples)
     - [ros2/demos](https://github.com/ros2/demos)
 - [ament · GitHub](https://github.com/ament)
@@ -130,6 +134,8 @@ pkg.evaluate_conditions(os.environ)
 [catkin\_pkg/condition.py L47](https://github.com/ros-infrastructure/catkin_pkg/blob/master/src/catkin_pkg/condition.py#L47)
 `$`付き文字が抽出されて…
 
+<!-- cspell:ignore alphanums -->
+
 ```python
 identifier = pp.Word('$', pp.alphanums + '_', min=2).setName('identifier')
 ```
@@ -163,7 +169,7 @@ return str(context.get(self.value[1:], ''))
 
 #### Goal Critic
 
-- ゴール付近に来たときに各Waypointとゴール座標の差分の平均をとってコストとする
+- ゴール付近に来たとき、各Waypointとゴール座標の差分の平均をとってコストとする
 
 #### Obstacle Critic
 

docs/ROS Tools.md

@@ -34,6 +34,8 @@ Rviz2の上の部分にデータを表示するRviz2プラグイン
 
 ### rqt_embed_window
 
+<!-- cspell:ignore awesomebytes takeshi iwanari -->
+
 任意のウインドウをrqtで表示するプラグイン
 
 [awesomebytes/rqt_embed_window](https://github.com/awesomebytes/rqt_embed_window)
@@ -57,7 +59,7 @@ ROS2のCMakeを楽に書くためのプラグイン
 デフォルトでインストールされている  
 詳細は[ブログ](https://hans-robo.hatenablog.com/entry/2020/12/15/153503)を参照
 
-[amnet_cmake_auto](https://github.com/ament/ament_cmake/tree/rolling/ament_cmake_auto)
+[ament_cmake_auto](https://github.com/ament/ament_cmake/tree/rolling/ament_cmake_auto)
 
 ```CMake
 cmake_minimum_required(VERSION 3.5)
@@ -107,7 +109,7 @@ sudo apt install ros-$ROS_DISTRO-grepros
 ```
 <https://github.com/suurjaak/grepros>
 
-メッセージの型やトピック名，frame_idでフィルタリングしたり…
+メッセージの型やトピック名、frame_idでフィルタリングしたり…
 
 ```bash
 grepros frame_id=map --type geometry_msgs/* --live
@@ -120,7 +122,7 @@ grepros --topic *lidar* --max-per-topic 1 --live
 grepros --max-per-topic 1 --lines-per-message 30 --live --no-console-output --write my.bag
 ```
 
-現在のフォルダ以下にあるbagファイルの中で文字列検索が出来たり…
+現在のフォルダ以下にあるbagファイルの中で文字列検索ができたり…
 
 ```bash
 grepros -r "keyword"