Форум сообщества Zettelkasten работал с 2021 по 2026 год. Читать можно всё, писать — уже нет. Вся жизнь сообщества теперь — в книжном клубе ККРА: встречи, задания, записи и разговоры.
В книжный клуб →Наткнулся на заметки Энди Матушака и задумался о создании подобной штуки для своих заметок.
Вроде бы, есть возможность делать сайт из простых текстовых файлов и генератора статических страниц, сайтов. У кого-нибудь есть опыт настройки таких сайтов? Что изучить, почитать на эту тему?
Да и вообще, рабочая ли схема? Будут ли вики-линки на маркдаун-документы работать как хтмл-ссылки?
Буду благодарен за советы.
Читая книгу по ZK я тоже наткнулся на упоминание его заметок, показалась удобной такая навигация. Мои поиски в сети на вопрос “Что же на платформа у Энди под капотом?” навели меня на вот это. Кроме того у самого Энди есть репозиторий, скрипт из которого обрабатывает вики-ссылки в маркдаунах. Честно, моих познаний в React/Gatsby не достаточно, чтобы экспериментировать, но может кто из сообщества разберется и нам расскажет в технических подробностях. Если будет что-то наподобие краткой инструкции по публикации, то благодарны думаю будут многие.
PS: Есть еще похожий на заметки Энди проект. Живет на Jekyll, инструкции как развернуть подобное есть там же.
А вообще генераторов статических сайтов много, из самых популярных Hugo и Jekyll, уверен для специалистов реализовать любую математику на них не проблема. Кстати, для Obsidian есть плагин для отображения заметок в стиле Энди 
Давай дружить вместе?!
Я тоже хочу сделать нечто подобное. Изучал ооооочень долго.
Есть куча всякого сейчас на рынке. Но мне больше остальных понравился hugo.
Хочу свой сайт rustamagamaliev.ru переделать.
Знаком чуть-чуть с hugo. Но всё что сделал - это создал блог на готовом шаблоне, и немножко подправил. Достаточно полно хватало материалов с официального сайта. Template можно достаточно смело редактировать. Иметь интерпретатор go необязательно.
Сейчас можно ооочень просто и быстро завести себе симпатичный DG с помощью Quartz, основанный как раз на Hugo. В недавнем обновлении (v3.2) добавили главное: wikilinks support (ну и для меня ещё важен пункт “LaTeX support”). Можно глянуть DG автора кварца (мне очень нравится).
Из достоинств:
Недостатки:
wiki-ссылки кротчайшую запись типа [[Заметка]] понимают в пределах одной папки, т. е., если файл “Заметка 2” находится, например, в подкаталоге /public, то придётся прописывать [[public/Заметка 2]];
для функционирования backlink-ов требуется доп. параметр в YAML (без него все файлы будут как Untitled file отображаться):
title: "Название заметки"
Но если вести из отдельного хранилища — вполне сносный вариант. Пушить изменения для обывателя можно ч/з GitHub Desktop (в 2 клика). Запустил себе пару дней назад всё это дело буквально за 10-15 минут, тестирую.
Ссылки можно преобразовывать в формат Hugo-ссылок при помощи скрипта.
О, вот это здравый подход, два скрипта, каждый под свою задачу, можно по частям собрать нужный велосипед.
Пока ехал в метро, мне тут подумалось, что блог в стилистике Энди прекрасен, в том числе необычным решением, в первую очередь для хозяина блога и его гостей, которые знакомы с принципами ZK. Однако, если блог ориентировать на более широкий охват, то неподготовленный посетитель может слегка потеряться в бесконечных переходах между заметками-статьями. Это чисто мои размышления с точки зрения юзабилити. Что думаете?
Цифровой сад, значительно отличается от привычного блога и тем более от порядком надоевших социальных сетей.
Чтобы случайный прохожий не заблудился, ответственный садовод обязан озаботится указателями, объявлениями и путеводителями.
Уникальность сада в сравнении с блогом и соц сетью, в том что в саду имеется множество точек входа и множество выходов. Когда блог предлагает линейное представление и посты по датам будут улетать в ленте. Социальные сети — это ад. Там вообще ничего не построить.
Так что да, может запутаться, если садовод не развесил таблички и указатели. Тут варими, тут парим, а там натягиваем сову на глобус.
Вот этот вариант вроде годный.
Думаешь переделывать блог в цифровой садик? 
Нет пока, но сам формат digital garden кажется любопытным. На дальнюю перспективу подумываю о своём варианте notes.fedorovpishet.ru.
Изучаю вопрос кароч)
Я вот сколько читаю в последнее время тут обсуждения DG и того, как правильно читать книги, столько у меня в голове витает вопрос «когда уже появится литература в формате ZK/DG»?
Популярных авторов, пишущих за деньги, понятно, ждать не приходится. Но есть ведь достаточно много ценной бесплатной литературы (особенно учебного-просветительского плана), которую в таком виде «потреблять» гораздо эффективнее, чем читая линейно либо по указателю.
Милорад Павич, “Хазарский словарь” — эксперимент с нелинейным чтением и ссылками.
Гарри Гаррисон, “Стань стальной крысой" — популярный в одно время жанр записывания дерева диалогов и принятия решений в виде книги, я думаю, кто-то ещё вспомнит что-то ещё, были книги, в которых можно было ‘бросать кубик’, пролистывая страницы.
И Гессе — “Игра в бисер”. Надо перечитать, чисто из памяти мне кажется, что там заложены идеи, которые были бы здесь интересны. Восстановление большого объёма контекста и сложных правил из небольших намеков.
Мне попался начинающий автор “за деньги” - This is Management - A Roam Book. Там книга в формате Roam Research и Obsidian (zip-файл, который можно в свой ваулт загрузить). Правда дороговато как-то для начинающего автора и нового формата, поэтому, что получилось сказать сложно.
А между тем – это идея. Которую стоило бы рассмотреть как вариант написания собственной книги. Давно витает в голове написать, то что делал с детьми последний год. Разговаривал о критическом мышлении. И учились решать проблемы.
Это хорошо ляжет на книжный формат. А вот как книга DG это будет уникальный эксперимент.
Сейчас подумал, а ведь названия файлов должны быть, наверно, на латинице. А у большинства они на русском. Предполагаю, здесь может быть проблема.
Вот есть клон темы оформления на jekyll. Нашел тут
Вот это классная штука. Я там почитал про ссылки, и вроде хорошо должно работать. Мануал по установке вгоняет в печаль такого гуманитария, как я, но стоит попробовать на каникулах.
У обсуждаемого выше Энди Матущака как раз есть эссе Why books don’t work и написанная им в формате сайта Quantum Country.
Моё личное наблюдение, связанное с предлагаемым форматом книг/работ - отсутствует ощущение завершенности работы с источником. То есть если книгу можно прочитать и быть уверенным, что ничего не пропустил, то те же заметки Энди полностью прочитать не то что сложно - не понятно, как это вообще сделать.
Поэтому мне кажется для автора таких книг нужно будет обязательно рассмотреть именно вопрос полного прохождения материала, иначе без понимания сколько сделано и сколько еще предстоит изучать материал очень тяжело
Мне настолько заинтересовала эта идея, что вопрос написания становится не только более актуальным, но и более привлекательным. Можно постоянно доделывать и докручивать. Даже думаю это делать тут, на нашем форуме.
Даже немного начал уже накидывать про цифровые сады. Нужно только дисциплинированно следовать задуманному.
Зачем? Пусть будут хоть на китайском. Юникод же давно придумали, и он работает как в файловой системе, так и в вебе
Тут, мне кажется, надо автору чуточку постараться, причем вариантов реализации много. Можно разложить заметки по папкам и подпапкам, реализовав таким образом разделы и подразделы книги.
А можно промаркировать заметки в yaml-атрибуте, отражающем структуру, и собирать по этому атрибуту «оглавление» на отдельной странице. И читать «по порядку» с уверенностью, что ничего не пропустишь.
Я гуманитарий, неглубоко знакомый с веб-дизайном, хтмл и цсс, поэтому могу иногда глупые вопросы задавать. Всё сводится к тому, что надо на майских каникулах покурить мануалы и запилить себе тестовый Digital Garden на маркдаун и Хуго или Джекилл.
Примерно раз в пару месяцев задаюсь тем же вопросом и иду смотреть, что придумали на гитхабе и в сообществах. Хорошая отправная точка в поиске технологии — это список цифровых садов с перечислением вариантов генераторов. Hugo, Jekyll, Gatsby — как по мне, потребуют кучу настроек, и все равно — то не работают обратные ссылки, то не синхронизируется, то версия софта не та. Есть еще Obsidian Publish, но он платный и Obsidian пользоваться я не могу совсем. Как итог, я не осилил генераторы из MD c обратными ссылками.
Но нашел альтернативу — генератор HTML файлов, который идет из коробки из десктопного приложения в LogSeq. Минусов вижу несколько:
Пример. Музыкальный проект с того же генератора на Hugo (khabaroff .com/logseq1000) вроде как приятно переносится на LogSeq — https://khabaroff.com/logseq1000/.
Вот ещё есть решения для Obsidian:
Тоже думал делать логсековский вариантик, но в итоге отказался от этой затеи. Обсидиан более гибкий и позволяет делать интересные вещи, которые в принципе не возможны на логсек.
Например, совсем недавно познал прелесть Dataview. Как же я был не прав!. Удивительная штука, которая позволяет крутить и группировать и анализировать заметки как душе угодно.
В целом мы тут недалеко обсуждаем тему Цифровые сады как уникальное явление современного виртуального пространства, а в планах написать книгу и где-то на форуме проскакивала мысль о том, что неплохо было бы книгу написать в формате цифрого сада. Загорелся идеей. Теперь вот думаю как это будет выглядеть. Начал писать с цифрого сада. От нее посмотрим что получится.
Тоже дошёл до списка садов на Гитхабе. А косяки проверены на себе или по отзывам?
Из условно бесплатных вариантов мне нравится ещё WorkFlowy. У них есть опция публичных страниц. Я вот игрался, выглядит очень хорошо и вообще удобно: 🧠 Smart Notes - WorkFlowy
Все устанавливал и проверял, правда, только на базе Roam.
Можешь посоветовать, что стоит попробовать для начала? Где меньше сложностей для гуманитария. Я немного могу в хтмл и цсс, но хотелось бы стартовать с варианта попроще.
Теряюсь, правда. Так как в этих всех генераторах вообще не в HTML и CSS дело. Надо установить и запустить конструкторы, плагины к ним, какие-то библиотеки, которые что-то вытаскивают из гита, потом запускают сборку, все это через консоль и пр. и пр. Для погружения в такие процессы, для знакомства с такого рода разработкой, когда не пишешь вот прямо руками голый HTML, я бы порекомендовал просто по очереди запустить любой из генераторов (Hugo, Jekyll, Gatsby). Найти Quick Start и поиграть, чтобы запустить хоть что-то. Потом поменять шаблон на другой готовый. Потом поправить что-то в шаблоне. Потом добавить-удалить пост. Добавить удалить плагин. И потом уже перейти к плагинам под базы знаний и генерации из MD.
У меня в мае младшие дети к бабушке уезжают. Кажется, у меня теперь есть, чем занять освободившееся время)))
Как идёт тест? Можешь кинуть ссылку на тестовый сад?
Неплохо идёт. Есть какие-то баги со списком бэклинков (в некоторых местах почему-то не все отображаются (предположение: если давать ссылку с нижнего регистра, то он её не видит)) и с лишнем в графе, но в целом мне нравится. Ссылка: тык.
В чате Telegram: Contact @TfT_ROL подсказали еще альтернативу Obsidian Publish
Круто выглядит!
Шрифт текста другой, нежели в демо. Настраивается или просто шрифт в системе не русифицирован?
И превью заметок тоже нет. Отключается или что-то поломалось?
Тоже классная штука. Блин, аж глаза разбегаются, что пробовать первым)))
Да я играюсь с ними (прям сейчас менял, кстати говоря). Для текста подключил Spectral, для заголовков JetBrains Mono. Из коробки там всё как в демо выглядит, один в один, и с кириллицей проблем нигде не было.
Мне тоже эта штука удивительно понравилась, а на чем ваш сайт написан? https://khabaroff.com/
Основной сайт на обычном вордпрессе
Hugo – однозначно лидер в сфере SSG. Нереально быстрый и многофункциональный. Отдельно для меня важно – поддержка org-mode в качестве языка разметки статей.
Как-то писал для него генератор беклинков, чтобы что-то подобное https://notes.andymatuschak.org/ сделать.
Спасибо, что напомнили про эту тему. После того как я отписывался здесь много ранее я не бросил искать на тему Hugo & Andy Matuschak и нашел интересное. Правда пока не щупал лично, потому как с имаксом я только знакомлюсь, а потому и пробовать публиковать нечего. Но судя по всему должно работать как надо.
Я как-то делал простой веб-сайт на hugo. Пришлось немного поломать голову, чтобы сделать нужную структуру, но в общем все было довольно просто, удобно и быстро.
При внесении изменений я генерил на локальном компе сайт, его папка синхронизировалась с домашним Synology, а оттуда автоматически попадала в привязанный AWS bucket (сейчас можно выбрать из ~15 облачных хранилищ, включая Яндекс), где хостился сайт. В таком сетапе обновления сайта были очень быстрыми и удобными.
Я все ещё мучаюсь и думаю себе начать разворачивать хьюго. Что для стартового набора требуется?
Есть доменное имя. Нужно покупать сервер или достаточно обычного хостинга?
Static site generators весьма нетребовательны к хостингам. Можно загрузить файлы - ура, достаточно.
А как сам хьюго разворачивать? Он то на хостинге не расцветет )) Не понянет принцип, как это работает.
То есть вот настроил заливку файликов и потихонечку выгрузил, дальше как он поймет, что из них нужно что-то сгенерить?
Тут есть два варианта ответа, которые я знаю.
Один - у себя на компе.
Второй - это gitlab или github, или кто там ещё continious deployment даёт. Например, Host on GitLab | Hugo, Host on GitHub | Hugo.
Да, это пример для org, я хотел сделать универсально, для markdown тоже.
Но тот проект сдулся и не добил я до конца. Может, когда-нибудь допинаю и опубликую.
В случае гитхаба, гитлаба, нетлифая не обязательно обзаводиться hugo у себя.
Host on Netlify | Hugo, про гитхаб и гитлаб ссылки выше.
В целях отладки не помешает, конечно.
А просто выложить можно и без гита, вон, бегет, например, тож гиг места бесплатно даёт: Заказать хостинг. Бесплатный хостинг. LTD Beget
А если что-то обновить в файлах? Заново сайт пересобиркть?
Да, сборка нужна каждый раз.
Если запуск через hugo serve (локально), то будет автоматически пересобираться при каждом запуске.
Для прода обычно автоматизируют, вешают запуск сборки на пуш в гитхаб/гитлаб.
Почитать можно подробнее:
извиняюсь, за глупый вопрос: я правильно понимаю, что такая механика позволит вести совместную работу надо заметками? понятно, что раздать права и пр.
Beget - 
Пользуюсь двумя платными аккаунтами, все отлично
Через гитхаб и контроль версий, конечно, такое можно организовать, но вариант не самый удобный.
Мы на одном из проектов ведём доку в Hugo.
Хорошо обстоит вопрос с историей изменений, коллективными правками.
С разграничением прав доступа плохо. Можно, конечно, git submodule использовать, но кажется, не самый удобный вариант.
У нас все для всей команды открыто.
Потратил часочек, чтобы развернуть небольшую страницу на Hugo. Получилось, но пока непонятно что)
https://fedorovpishet.ru/notes/
А вот quartz не получилось развернуть.
Таааак, слежу с преогромным интересом. Пока, к сожалению, не могу самостоятельно сесть и начать заниматься своей страницей. Возможно где-нибудь ближе к лету это сделаю.
Нашел простую, как две копейки инструкцию по развертыванию цифрового садика.
Мне кажется, у нас уже был описана этот репозиторий гитхаба.
Тогда эту тему отлично дополнит видео описание процесса.
@fedorovpishet не думал о таком, ну очень простом решении? Я так понимаю, что можно коммитить на гитхаб и в каждом файле делать еще разметку, где прописывать, что публиковать, а что нет.
Я уже понял, что все эти «простые решения» простые только для тех, кто шарит за гит, коммит и командную строку. Мне же это очень тяжело понять)))
Так и есть, я посмотрел самые популярные SSG и они все требуют доработки под разметку Обса, а значит нужен опыт в разработке или вложение в разработку на стороне 
А если я не пользуюсь Obsidian?
В бесплатном варианте если использовать github pages, как я понимаю, годится только публичный репозиторий.
Тогда всё закоммиченное в git - публично, даже если на сайте не видно.
Ну, если используешь для публичных заметок, то это вроде и не страшно)
Я свой сад публикую из своей единственной картотеки, которую не готова делать полностью публичной.
Правда, мне и в маркдаун переводить - отдельный шаг, на котором можно отделить публикуемое от непубликуемого.
Но как-то… С одной стороны думаю, что может, оно бы и неплохо на гитхабе и именно с публичным репозитории сделать. Типа, заодно можно будет смотреть, что менялось каждый отдельный раз.
У меня там есть попытка 2016 года завести сайтик (ladykosha.github.io, ессно), дело не то, чтоб совсем незнакомое.
А с другой стороны, у меня есть мой работающий способ, стоит ли метаться
Я себе представляю такой формат. Есть некоторое количество заметок, которые у меня готовы к публикации — заливаю их в отдельную папочку на компе и синхронизирую из в Гитхаб. А оттуда они превращаются в сайт.
А свой домен можно прикрутить к гитхабовскому сайту?
Managing a custom domain for your GitHub Pages site - GitHub Docs - прикрутить можно, разумеется.
Меня в этой истории заранее удручает синхронизация изменений с оригиналом из картотеки. А неизменность меня не устраивает.
Так вроде из командной строки всё делается быстро.
Я тут прикрутил Quartz к гитхабу: Quartz | quartz. Оказалось проще, чем думал. Но описание ещё не понял, как поправить. Пока не работают ссылки, хотя файл про заметки Матушка кинул в папку notes.
Я так понял, к гитхабу можно какое угодно решения для digital garden прикрутить, это проще, чем на своём хостинге. А потом можно просто субдомен назначить вместо кривого гитхабовского. Звучит обнадёживающе, хотя уверен, подвохов куча)))
Это потому что индексная заметка у тебя, скорее всего, лежит в папке content. Чтобы сослаться на заметки в папке notes, надо прописать [[notes/Заметка]]. Либо просто перенеси всё в корень (т. е. в папку content) и ссылки заработают.
Так, пойду попробую)
Да. Ссылки заработали. Но 404 показывают. Title прописал, пробовал с кавычками и без, всё равно 404. Есть понимание, почему?
У тебя в YAML атрибут title с большой буквы прописан.
Заработало. Это единственное, что у меня заработало без сбоев. Буду дальше настраивать.
Навёл лоск, разобрался почти со всем. Осталось только научиться публиковать не через сайт Гитхаба и «добавить файл», а через консоль, чтобы все файлы сразу обновлялись с компа. Ещё с доменом разобраться. Ну и пока не понял, как добавить список последних добавленных файлов. Чтобы ниже основного текста добавлялись. Наверно, в твиттер чуваку напишу)
Пушить можно и через Github Desktop для простоты и удобства. Клонируете себе форкнутый репозиторий, а дальше всё привычно и несложно.
Докладываю) Наловчился пушить изменения через десктопный гитхаб, реально удобно. Надо только в копии файлов тайтлы не забывать прописывать.
Поморочился с привязкой собственного домена, но оказалось всё просто. Это я дурак) Заметки открываются по красивому адресу: https://notes.fedorovpishet.ru, и даже сертификат есть.
Слетали цсс, но вроде маленько погодя всё наладилось.
Но проблема есть. При переходе по ссылкам выдаёт 404 ошибку. Пока не понял, в чём проблема. Может подожду до вечера. Если само не починится, буду курить мануал или поддержку мучить)
Какая крутотенечка начала получатся. Пора самому у себя такое разворачивать
Поправил файл конфигурации, вроде всё заработало вообще как надо. Но, опять же, не без нюансов.
В Хроме всё открывается отлично. А в Сафари ссылки, почему-то, идут на файлы из папки content/notes. Проверил на рабочем макбуке, айфоне и айпаде.
Посмотрите плз, как у вас? Норм — это у ссылок есть предпоказ, на главной работает граф, и ссылки Daily Notes и Библиография открываются. Или нет? Какой браузер?
Дейлики и библиография не открыаются (
Хром и сафари.
А так очень прикольно выглядет.
Хм, значит надо думать дальше, что подкрутить)))
404 по ссылке из поста.
Я попала в неудачный момент?
Я там кое-что крутил. Вот сейчас должно открыться. Но наверно тоже Дейли и Библиография не откроется.
А вот нет!!! Заработало!!!
UPD. Наблюдаю странный глюк. Когда что-то делаю с файлами сайта: правлю файл конфига, текст заметки, добавляю заметку, то слетает custom domain и его снова надо прописывать в настройках. Странная фигня, тоже надо думать, как побороть. Ох.
Кстати, если у меня есть страница с датавью форматирование, она будет отражаться или нужно генерить и заливать в ручную, если вообще такое возможно.
А я не знаю, что это значит) Я ж датавью не пользуюсь.
В Quartz в датавью обязательно тайтл прописывать, в кавычках. Ещё можно теги проставить и они будут отображаться на странице.
Оказывается, проблема частая.
Теперь всё работает без сбоев. Можно наводить финальную красоту с текстами и ссылками)))
Так, запоминай последовательность своих действий, я буду тоже разворачивать на своем домене ))
Как только раскидаю дела, может на майские Буду стучаться в личку.
А я уже начал. В соответствии с методологией цифрового сада, кстати)
Интересная штука. Кажется, то ли Гит, то ли Quartz видят разницу между буквами Й. У меня не работала ссылка на страницу с названием [[Создать репозиторий для цифрового сада]]. Причём на одной странице работала, а на другой – нет. Ломал голову, что не так. В итоге плюнул, открыл в Гите файл с рабочей ссылкой, скопировал её и вставил в файл, где не работала эта ссылка. И, о чудо, всё заработало.
А потом посмотрел в приложении Гитхаба для десктопа, а он показывает, что именно буква Й изменилась. Как это вообще может быть? Ума не приложу. Вообще, чую, наплачусь я ещё с кириллицей в ссылках.
Картинки ты встраиваешь в маркдаун файл, а он их автоматов встраивает на страницу, правильно? Как раз там где про репозиторий ты описываешь?
Ну картинки тоже в папку с маркдаун-файлами закидываю.
В Nota я просто делаю скрин и вставляю в заметку. Оригинальный файл падает в папку Attachment, которую я настроил для файлов — есть в Nota такая опция.
И потом закидываю в папку с контентом и текст, и фотки. Из этого Кварты собирает хтмл-страницу.
То есть картинка у тебя в той же папке что и заметка или в папке аттачментс?
В Nota заметки и картинки в разных папках. Заметки в своих, а картинки – в папке аттачментс.
А вот на Гите в одной папке.
Можно и на Гите складывать картинки в отдельную папку, но тогда в ссылках надо прописывать путь, то есть (images/photo.png). А у меня везде, и в iA Writer, и в Obsidian, и в Nota настроен кратчайший путь к файлу, а не абсолютный. Так что выбирая между сменой всего рабочего процесса и складированием всех файлов в одной папке на гите, я выбрал второе)))
Он это делает автоматом, в смысле собирает на гитхабе?
Ага. Там простая ссылка и он её обрабатывает. Вот такая разметка, те же двойные квадратные скобки:
Все больше убеждаюсь, что мне такая балалайка нужна.
Теперь вопрос. Может ли квартц понимать ямл разметку.
Например публиковать только файлы в которых есть свойство ‘publish’ ну или еще какой?
Не тот подход немного. Он не может публиковать или не публиковать. Если есть док в папке, он его всё равно сгенерирует. Но можно поставить в мета-данных надпись, чтобы скрывать запись.
Опять же, я yaml не пользуюсь, особо не вникал. Title обязателен, теги можно указывать в разметке, скрывать запись тоже. Больше не помню, надо документацию смотреть.
Понимает, тот же title из YAML берёт, теги. Но публиковать по такому принципу, вроде бы, пока что нельзя. А вот наоборот сделать можно: по свойству
draft: true
заметка будет игнорироваться. Источник.
В общем, если поместить все заметки в диджитад гарден, проставить им тэг draft:: true то и отображаться они не будут.
Очень удобно. Сижу сейчас кручу, понемножечко всякое, нравится возится, по мне так это очень крутая альтернатива родному.
@fedorovpishet А ты тему менял у своего сайта? Как это делается? Можешь поделиться. У тебя появилась кнопочка ночь/день, и всякие прелести.
Ты имеешь в виду notes.fedorovpishet.ru?
Это тема из коробки. Я только лупу убрал, а всё остальное не трогал.
Аааа, все понятно, я сделал не ту, а джекиловскую, кварцовский репозиторий, другой, правильно?
Наверно. Скинь ссылку на гит исходника, который ты себе ставишь?
Да, разворачиваю, своих всех отправил в Астрахань сказал, буду разворачивать себе цифровой сайтик 
В общем, сейчас попробую твою темку развернуть. Ты через netlify делал?
А эта. Знаю. Но у меня не взлетело. Пошёл деплой и неудачно.
А кварц развернул на гитхабе и всё. Самый простой вариант из всех, что мне попадался.
У меня взлетело, но такое себе ощущение, не понравилось, кварц сильно приятней.
Тоже через netlify разворачивал?
Нет, просто на гитхабе.
А ты уже расписал как это делать, у тебя вроде заметка на эту тему еще не полностью собрана.
Хочу запуститься уже и начать крутить всякие штучки. И еще вопрос ты как добавил доменное имя. У меня вроде как тоже рег.ру, но что-то не могу в настройках найти куда там тыкать.
Нет, я только вчера начал. Как раз сейчас пишу.
Надо создать запись CNAME и прописать там твоё доменное имя и домен на netlify.
И тут полнотекстовому поиску досталось O_o
@Rustam, посмотри их инструкцию, у них в принципе понятно и просто написано (да и в целом всё несложно):
ctrl+enter, ctrl+p).Если хочешь скрестить с основным хранилищем, то я бы лучше рассмотрел вариант переноса всех заметок из корня в какую-нибудь папку, а всё что на публикацию — кидал бы в корень. Проблема в том, что помеченные таким образом в YAML заметки не будут публиковаться в сад, но в репозиторий гитхаба они всё равно попадут, если все в одном месте будут лежать, а репозиторий публичный. Поэтому лучше всё приватное в какой-нибудь папке держать, чтобы просто в .gitignore этот каталог добавить. К тому же, таким же макаром можно настроить исключения и в самом саду, чтобы не возиться с прописыванием YAML для всех заметок. Хотя, всё-равно придётся title как минимум прописывать в тех, что на публикацию пойдут)
P.S. если что непонятно, спрашивай. Разберёмся, поможем.
Да он всё равно как-то странно искал. Забил «корова», а он мне выдал заметку про «Энди Матушака»)))
Это он как бы намекает
@mojo_risin
Я вроде все прописал, вот так:
и на гитхабе вот такой cname получился:
Пока ничего не взлетело. Но может прописал что не так.
В общем развернул, но есть одно но, постоянно вылетает ошибка
Action failed with “The process ‘/usr/bin/git’ failed with exit code 128”
Из-за этого сайт работает некорректно. Что делать ума не приложу. Попробовал и с нового акка, и со старого, под разными соусами, что только не сотворил
https://rustamaga.github.io/notes/
У @fedorovpishet таких ошибок не было. Только вчера с ним разговаривали на эту тему. Но когда он попытался снова сделать похожее у себя, то у него ничего не вышло. Сайт развернулся, но по ссылкам не гулял. Мне кажется, там автор что-то коммитит, и видимо навертел всякого, что теперь не запускается.
Скажу больше, я склонировал репозиторий Алексея к себе полностью, перезалил вместо своего – не запустилось. Те же ошибки. Не деполится и все. Хоть ты тресни.
Быть может у меня что-то не так с action workflow в мануале про это говорилось. Но у меня action открыты в чем проблема не понятно. Другое предположение что я не форкнул а сделал use template.
У меня после множества попыток вообще руки опускаются(
Вот даже это попробовал: Digital Garden. Вроде бы вообще всё должно быть просто. Но в результате получается страница без стилей вообще: https://fedorovpishet.github.io/jekyll-garden/.
P.S. А нет, что-то заработало)))
После подобных мытарств, начинаешь ценить решения из коробки.
Но это все дело рук, не более. уверен, остальные легко и просто смогли бы реализовать цифровой сад, а мы вот имеем то что имеем )
Попробовал развернуть по новой всё — действительно, не выходит. А я вам расхвалил, как всё просто и легко) Так что ваши руки не при чём, ребята.
Я бы очень хотел поднять вот эту штуку: GitHub - aravindballa/gatsby-theme-andy: A Gatsby theme to build Andy style websites. 📑. Но там прям дико тяжело. Думаю, снести пока всё, что есть, и потихоньку разобраться с Gatsby и темами. А то с нуля тяжело всё это проглотить.
Ну вот мне тоже показалось, что это разраб что-то намутил нового и всё поломалось.
Он там коммитит как не в себя, может что-то поломал и сейчас накатывает обновления.
@fedorovpishet
Тут лучшие SSG движки на 2022 год
https://snipcart.com/blog/choose-best-static-site-generator
Может будет полезно. Парочку даже не встречал и не слышал.
Да я сейчас с пацанами из Nota договорюсь)
Короче, ну нафиг эту статику. А я то думаю, чего люди массово не пользуются генераторами статических сайтов. Да потому что это не для людей делают, а для программистов.
Нормальный подход, когда продукт сделан как сервис. Нажал кнопочку, всё заработало. В Ношу или Воркфлоуи нажал поделиться, всё — заметка в сети. В Обсидиан паблиш заплатил 20 баксов, работает.
А с этой статикой, Хуго, Гэтсби, Джеккил одна морока. Причём даже вроде всё когда по уму делаешь, всё равно какое-то г***но вылезает. Ничего, вот прям ничего из коробки не взлетело.
Ну нафиг. Найду другой способ)))
Еще один вариант для тех, кто использует Obsidian.
3D-граф, это что-то новенькое.
Я сам не использую Obsidian. Попробовал свои какие-то старые заметки из Obsidian запустить. Запустилось, можно сказать, с первого раза. Сначала только ошибка вылезла (встречается на маках)
obsidianhtml.lib.DuplicateFileNameInRoot: Two or more files with the name “.DS_Store” exist in the root folder.
Решается такой командой в Terminal
find . -name ".DS_Store" -delete
Вместо точки после find должен быть указан путь до папки Obsidian.
Из новостей от техписов, Stripe выложили свой движок для документации и публикации.
Markdoc is a powerful, flexible, Markdown-based authoring framework.
Свои заморочки само собой, но может быть кому-то понравится 
Примерно такой же путь прошла с Gatsby Мне ваше сообщение навеяло завиральный метод определения того, стоит ли что-то новое изучать, и сколько времени это займет.
Допустим, задача создать digital garden с помощью Gatsby.
Смотрим на Udemy:
а) Есть ли по этом теме тьюториал с большим количеством отзывов и хорошим рейтингом (это значит, что люди более-менее чего-то добились с помощью этого тьюториала)? В нашем случае есть, к примеру Gatsby.js Tutorial and Projects Course. Отмечаем длину курса в часах - 22 часа в этом случае.
б) Смотрим, какие там пререквизиты. В случае этого курса, нужно “базовое знание React”.
Находим курс по React. К примеру React - The Complete Guide (incl Hooks, React Router, Redux). Длина курса - 48 часов, пререквизиты: “JavaScript + HTML + CSS fundamentals are absolutely required”.
в) Ну и если вы не занимаетесь веб-разработкой каждый день, то в этом месте можно уже, в принципе, заканчивать, но можно еще добавить часы по JavaScript + HTML + CSS fundamentals. Я думаю, там будет часов 100 еще.
г) 22+48+100 = 170 часов. Потом смотрим (можно на том же Udemy) топик, к которому эта задача относится, в этом примере Programming Languages. И, по шкале от 1-5, оцениваем, насколько часто мы этим топиком занимаемся в нашем постоянной деятельности, где 1 - каждый день; 2 - еженедельно; 3 - ежемесячно-чаще чем раз в год; 4 - ежегодно и реже; 5 - вообще никогда. Умножаем часы на получившееся число: 170 x 5 = 850.
д) получается, что сделать самостоятельно более-менее нормальный сайт на Gatsby (и поддерживать его в случае проблем) у человека не из сферы IT и не программиста получится примерно за 850 часов или ~106 рабочих дней по 8 часов. Это будет сайт “для себя”, без UI/UX, основ дизайна, сетевого администрирования и т.д. 
е) но это может быть хорошим началом и пет-проектом для карьеры будущего веб-разработчика. 
Не смотрел на подобные вещи с точки зрения трудочасов, а может и стоило бы. Потому как правильней.
Прочёл два раз и понял, что натурально много. Других проектов хватает ) лучше 850 часов на что-то иное, например начать писать книжку ))
И всё-таки я это сделал: https://fedorovpishet.netlify.app
Закинул свою папку «Тестовая картотека». Стек — GitHub+Netlify+Jekyll. Пока особо не лазил в настройках ЦСС и прочих визуальных штук, собственный домен не прикрутил ещё. Так, немного поигрался.
Как картинки добавлять, тоже пока не понял. Кажется, что маркдаун теги картинок там не работают.
Подробности потом, а то уже спать охота)))
Мыши плакали, кололись, но продолжали #### кактус Gatsby, в надежде сделать себе публичные заметки как у Матушака. 
А ты пока только на локал хосте поднял и там ковыряешь?
Ну пока да. Дома вечером попробую развернуть уже публичную ссылку и прикрутить CNAME.
Мне этот шаблон очень понравился, но у меня с Gatsby ничего не получалось. Случайно пришла идея, установить Gatsby не через npm, как советовали во всех гайдах, а через brew. И сработало блин!
Вот что значит, не тупо копировать инфу, а разбираться с ней, кстати. Неожиданный инсайт)
Вот так и получаются веб-девелоперы из писателей
Я хоть сам и программист, но до сих пор не нашёл рабочего решения. Хотя как мне кажется у меня запрос довольно тривиальный
Казалось бы не сильно замысловатый запрос, но ничего толкового не находится.
Я бы давно сам написал такой генератор, но боженька не дал мне чувство прекрасного, так что юзабельный UI я родить не могу.
А так хотелок у меня море. Например, полнотекстовый поиск ещё прикрутить.
Obsidian Publish стоит грабительски дорого, и даже к нему полнотекстовый поиск прикрутить пока что невозможно.
Я решил это по другому.
Первое что мне нужно – это возможность и место выгружать свои файлики марк даун. Второй, чтобы можно было строить систему отдельную от основной базы. Долго каначертыхался со всем что есть на рынке, в итоге отошел от решений типа цифровой сад и статические сайты и посмотрел на то что у меня есть и привычно, без костылей и прочего.
Взор упал на вордпресс, попробовал и до сих пробую, получается вполне себе сносно. Есть парочка нюансов, которые не решил еще. Это обратные ссылки. У меня там многие вещи друг с другом пересекаются, и приходиться вручную прописывать ссылки. Это немного раздражает, но добавляет осмысленности.
От обратных ссылок я категорически против отказаться
Мне вот тоже эта история не нравиться, но не получается найти ни плагина, ни какого-то решения. Но уверен, оно есть, просто ищу не там. Вордпресс – сильный инструмент. Зайди ко мне на сайт, посмотри как там все устроено, в шапке моего профиля есть ссылка.
Хотел опять про ghost написать, может у вас получится в статику ) но и там садоводы плачут Adding Bidirectional Links to Ghost (like Roam, Notion, etc) - Themes - Ghost Forum
Я все ищу решение для подобных ссылок для вордересса. Пока все такое себе 
Пока искал технические варианты, накинулся на Backlinking Is Not Very Useful -- Often Even Harmful • Zettelkasten Method . Прямо смуту наводят:
Backlinking is just linking notes without connecting knowledge.
Так и есть. Связи и тем более обратные связи — очень опасная штука. С ними нужно быть очень осторожным.
Вот что я об этом думаю: Связи это поэзия
Emanote не смотрели?
Поддержку embed pdf еще не реализовали, но генерация ссылок на разные файлы уже есть.
Полнотекстовый поиск в работе.
Проблема состоит не в том, что это сложно, а в том, что это так просто, что от пользователя это спрятали и заставляют пользоваться “костылями”.
Что такое “сайт”. Это значит, что вы как-то договариваетесь с “хостингом” (хранилищем файлов) отправляете куда-то свой “файл” - текст или картинку. Затем любой пользователь Сети говорит своему “браузеру”, что хочет именно этот “файл”, и “браузер” его получает у “хостинга” и выдает на экран в меру своего понимания “языка файла”. Более того, обнаружив, что вы, как-то реагируете на содержимое “файла”, браузер может что-то перезапросить или перевывести…
По идее, имея контроль над ключевыми точками “хостинга” и “браузера” я могу на лету подменять содержимое файла в любой из этих точек. Точнее, написать “программы”, которые могут это сделать без вашего участия. Упомянутые выше “костыли”, и есть такие “программы”, имеющие наглость утверждать, что справятся лучше вас.
С чем же они справятся?
Программы (на обычных Linux-языках) будут, в основном, состоять из набора “команд”
s/строка1/строка2/
Т.е. “заменить строку1 на строку2”. Чаще всего, с какими-либо “обобщениями”. Например, “все буквы” на “заглавные”, или “номер символа” на “сам символ”. Придумав набор “команд s///” на вашу самодельную “систему разметки”, вы сможете прогонять свои “заготовки” одну за другой.
Но вдруг вам захочется добавить в “разметку” что-то особенное? Linux умеет и это. s/// можно включать прямо в “заготовку” и путем простейших преобразований “программы” добавлять их к списку (1).
Итак на “хостинге” получается “файл”, готовый к выгрузке “пользователю”. А, если вы хотите его еще подправить в зависимости от запроса “пользователя”? Это тоже просто. Вместо адреса “файла” вы подсовываете пользователю адрес “файла-программы”. Это называется CGI-программированием. Если “хостинг” его разрешает, вы пишете точно те же “программы”, что в (1) и (2). На тех же или очень похожих языках. Разворачивание “заготовок” происходит до передачи “файлов” “браузеру”.
Наконец, когда “браузер” честно рисует “файл” на экране и встречает “Java Script”, он запускает его, как “программу”. Опять те же s/// только с двумя заморочками. Язык JS, в отличие от простых Linux-языков, которые можно изучить за 5 минут, вещь жутко убогая и по-идиотски-устроенная (это - “костыль”! и броузер - “костыль”!). Это первое. А второе, следствие первого, состоит в том, что “место вставки строки в документ” это вам не “строка в файле”, и придется попрыгать. Зато, вы можете переписать “документ” практически полностью, что может превратить ваш “текст” в настоящую рисованную игрушку реального времени.
Еще одно отличие (4) от (1-3) состоит в том, что вам здесь недоступны все “файлы” вашего “сайта” разом и вы должны их подкачивать. И наш “JS-костыль” опять сделает все, чтобы вам не было скучно. JS - это, вообще, набор рецептов, передающихся из рук в руки.
Ну, еще вам может захотеться иметь “макет сайта” у себя на машине. В случае (1-3) это, опять просто. Ставите Apache и все работает, как в Сети. В случае (4) все и так работает у вас на машине, ничего менять не надо. А, вот, в случае (5) придется еще попрыгать.
Итак, чем меньше “костылей”, тем проще. Программки из 10-100 строк будут исправно работать за вас годами (у меня они проработали лет 17, невзирая на то, что я писал их на коленке). Но кто же это допустит? Фиг вам доступ к (1-6)! Только “костыли”! Каждый только на одну стадию процесса и совместим с другим, в лучшем случае, через “костыль-посредник”.
Самое страшное, что продавцы костылей сами давно уже забыли, что речь идет о простейших вещах, что я описал выше. И вас просто не поймут, объясняя одни “костыли” через другие.
Как-то так.
И зачем я это написал? Все равно, “костыли”, “костыли” и “костыли”…
Спасибо, Emanote максимально близок к тому что мне надо. Embed pdf мне не хватает, но поскольку Emanote open source, я могу попробовать добавить нехватающий мне функционал
@amir Спасибо вам за наводку на emanote. Добавил поддержку embedded pdf. Теперь ждём аппрува от авторов
На базе emanote наконец-то доделал блог, который давно хотел. Если что он на украинском, но всё равно приглашаю поклацать
https://mnaoumov-court.netlify.app/
Фундаментальный недостаток emanote - отсутствие кеширование. Большие сайты генерировать по новой каждый раз - то ещё удовольствие…
совершенно случайно подвернулась вот эта статейка, где именно из Обсидиана с помощью Docusaurus делается статический сайт Ghost CMS vs Docusaurus | Блог _AMD_
Пока сыровато
wikilinks нет Feedback | Docusaurus
backlinks нет Feedback | Docusaurus
Еще пример опыта разворачивания в статике на Nextjs
Чем больше времени уделяю вордпрессу, тем больше пониманию, что он очень комфортный для работы.
Возможно как-то найти плагин который показывает все беклинки на странице и будет поинтересней всех этих популярных решений на статике.
В порядке эксперимента преобразовал в формат ваулта Obsidian старенькую энциклопедию лекарственных растений: GitHub - dimonier/herbs-obsidian-vault-ru: This is an Obsidian demo vault containing description of herbs in Russian
Прокачай свой ЗОЖ, не выходя из Обсидиана 
Появилось еще одно решение для публикации Obsidian садика.
Проблема всех этих решений, их сложно запустить из коробки. Нужны какие-то танцы.
Да, согласен. У всех разные познания в web сфере.
Одно время бредил идеей цифрового садика, искал всякие решения, в итоге остановился на ручной настройке — в виде вордпресса.
Только плагина для bidirectional lnks там нет. Можно, конечно, использовать плагины для создания wiki, например, Yada Wiki, но придется вручную ссылки проставлять такого вида:
[yadawiki link=”How To Make Iced Coffee” show=”How To Make My Favorite Drink”]
Можно еще Flowershow попробовать.
hugo in action отличная книга. там вначале про философию генераторов статических сайтов и где они уместны и где не уместны хорошо расписано @Rustam
найти можно на рутрекере
да, hugo - это вещь. то чего не хватало мне для создания сайта для НКО. вордпресы никак не хочется а gatsby всякие казались как из пушки по воробью. такая молотилка и еще на react не нужна.
Огромная благодарность @fedorovpishet и Дмитрию (если не ошибаюсь). прослушал их недавный стрим по поводу цифровых садов за услышанное слово hugo. Это оказалось достаточным. Раньше не встречался с ним.
Я тоже раньше думал что как из пушки, но потом осознал что это еще один фильтр. И на самом деле так получилось.
Заметки это одно, а вот опубликованные заметки — другое. Вордпресс помогает разделить эти две сущности. В обсидиан я думаю и пишу, а там публикую уже продукт осмысленной мысли.
Кстати, такое можно и на дискурсе развернуть. Вы верно подметили это в чатике. И о том где прочитать про дискурс и все что с ним связано. Лучший источник:
Обсуждение закрыто вместе с форумом. Поговорить об этом можно в книжном клубе ККРА — там теперь живёт сообщество.
В книжный клуб →