weekly update

_posts/mini_posts/2024-10-15-links-checker.md

@@ -0,0 +1,15 @@
+---
+layout: post
+title: Проверка ссылок в Markdown
+tags: [markdown, docs, cli]
+tg_id: 558
+---
+Наткнулся на довольно [неплохую утилиту](https://lychee.cli.rs/introduction/), которой просто проверить папку с ворохом .md и/или HTML файлов на наличие битых ссылок. Для маленького количества файлов проще проверить глазами, да и вряд ли там будет много кросс-ссылок, для большой документации скорее всего будет использоваться что-то вроде [MkDocs](https://www.mkdocs.org/) со встроенными средствами и/или плагинами. А вот для среднего количества — самое то.
+
+Онлайн запросы скорее всего вряд ли будут иметь смысл (а если репозиторий публичный, то это еще и дырка потенциальная). Одна из киллерфич — проверка якорей (`/blabla#header`). Поэтому проверка выглядит примерно так:
+```sh
+lychee --offline --include-fragments '**/*.md'
+```
+Если есть сгенерированный контент, то лучше запускать на отрендеренном сайте.
+
+Есть и [GitHub Action](https://github.com/lycheeverse/lychee-action/), пример на моем репозитории [тут](https://github.com/ov7a/ov7a.github.io/blob/874eb018f30e48857474d00aa422f83b29303a1a/.github/workflows/check-links.yml) — при подключении [нашлось](https://github.com/ov7a/ov7a.github.io/pull/1/files) аж 3 ошибки.

_posts/mini_posts/2024-10-17-git-lost-file.md

@@ -0,0 +1,11 @@
+---
+layout: post
+title: Поиск файла в git
+tags: [git]
+tg_id: 559
+---
+В продолжение предыдущего [поста](/2024/10/15/links-checker.html) и борьбы с мертвыми ссылками. Если содержимое известно, то найти файл в истории можно, [уже проходили](/2020/07/21/git-grep.html). Но что делать если известен только (устаревший) путь к файлу?
+```sh
+git log --all --full-history --no-merges -- your/broken/file.path
+```
+Тут идет поиск по всему логу изменений за исключением мержей (вы ведь не делаете ничего странного с файлами во время мержа?). Можно поиграться с флагом `--diff-filter=D`, но надо железно знать, что файл удален. В моем случае это было не так.