Оформление README файла репозитория на github
Приветствую, это полный гайд по оформлению REAMDE файла репозитория на github.
Начнём с самого простого, и закончим понастоящему класными решениями.
Начнём с некоторой теории. README.md файл может принимать html и markdown разметку сразу.
Приступим.
Заголовки
Для создания заголовка нужно поставить знак # и через пробел написать название заголовка. Чем больше вы используете #, тем меньше будет заголовок. Это можно использовать как подзаголовки.
# О проекте
## Что из себя представляет проект
какой-то текст
## Философия
какой-то текст
Стили текста
Для придачи стиля стексту, текст нужно занести либо в блок html, либо добавить слева и справа особые символы.
**жирный**
_курсив_
~~зачёркнутый~~
<sub>подпись</sub>2
<sup>супер подпись</sup>2
<ins>подчёркнутый</ins>
Цитирование
Цитирование делится на цитирование кода и текста.
Для цитирования текста, нужно поставить перед ним >
Цитирование текста -
> цитата
Для цитирования кода нужно перед кодом и после кода поставить ```
```
print("Hello world")
```
Цитирование через табуляцию
Добавив табуляцию перед текстом, вы вынесите его в отдельный блок
табуляция
Работает так же как и при цитировании кода.
Списки
Списки делятся на нумерованные и без номера. Кроме того они могут иметь подсписки. Для создания подсписка нужно сделать табуляцию.
для создания списков сделайте следующие конструкции -
# Нумерованные
1. Что-то
1. элемент подсписка
2. элемент подсписка
2. Что-то
1. элемент подсписка
2. элемент подсписка
# Не нумерованные
- Что-то
- элемент подсписка
- элемент подсписка
- Что-то
- элемент подсписка
- элемент подсписка
В подсписках нумерация будет ломаться, так что лучше ей не пользоваться.
Ссылки
Вы можете сделать кликабельный текст. Для этого вам нужно сделать следующую конструкцию.
[Текст](ссылка)
если вместо ссылки вы впишите # и название заголовка, то текст будет переводить вас на конкретный заголовок.
[About](#about)
если есть пробелы, нужно заменить их на -
Задачи
для создания задачи сделайте подобную конструкцию
- [ ] задача не выполненная
- [x] задача выполненная
Оповерщения
Последнее о чём я хочу вам рассказать - это оповещения.
Типы оповещений
[!NOTE]
[!TIP]
[!IMPORTANT]
[!WARNING]
[!CAUTION]
По началу идут самые незначительные, а ниже, соответственно более значимые.
Делаются они вот так -
> [!NOTE]
> малополезно
> [!TIP]
> Полезно
> [!IMPORTANT]
> Важно
> [!WARNING]
> Предупреждение
> [!CAUTION]
> Осторожно
Надеюсь, вам был полезен этот пост. Пишите своё мнение на счёт этого, если есть вопросы, постараюсь ответить.
Есть ещё телеграмм канал, можете там же спросить что-то. Посчу туда всякое.
Информацию я брал с этой англоязычной документации гитхаб.
Честная цена за кг/литр
Всем привет! Меня зовут Паша и возможно вы уже пользуетесь моим расширением Ave blacklist для блокировки продавцов спамеров на авито. Но сегодня не об этом.
Больше года назад Кабинет министров не поддержал законопроект с ценой за килограмм или литр, новость была на Пикабу в том числе
Что ж, Кабинет министров не поддержал, а я поддерживаю двумя руками!
И написал расширение для браузеров для расчета цена за единицу измерения на сайтах доставок еды - заКило (chrome, firefox)
Мог бы научить и в офлайн магазинах цену за единицу измерения считать, но кто бы меня спрашивал :D
Маркетинговые фишки для запутывания потребителей
Для чего нужно смотреть цену именно за единицу измерения? Сейчас я расскажу пару маркетинговых трюков, которые манипулируют человеком, заставляя делать неверные выводы. А я за осознанный и рациональный выбор.
1) Неравные объёмы. Оооо, эта тема сильно развита в молочке. Как думаете, что выгодней купить 800 мл, 930 мл, 1.4 литра и 2 литра молока? Следующие изображения как раз об этом:
2) Оптовый эффект. Кажется, что большая упаковка должна быть выгодней. Но это не всегда работает. В результате потребитель может купить больше товара по невыгодной цене, получается такой двойной урон по кошельку.
Слобода (на перепелиных яйцах) самое выгодное предложение 400 мл (253 рубля/литр против 300 в фасовке 700 мл), Слобода Оливковый 400 мл (263 рублей/литр против 288 в фасовке 800 мл), у ricco самая выгодная фасовка самая большая 215 рублей/литр
3) Промо-упаковки. «+10 % бесплатно» на пачке чипсов или кофе — итоговая стоимость за грамм остаётся скрытой
4) Акционные блоки. Товар в «специальной акции» может стоить дороже аналога без акции, если не считать граммы и миллилитры.
Если написано, что цена ниже, значит это наверное правда? Да, ведь? По секрету скажу - даже без скидки Молочный ломтик цена ниже за 1 штуку, чем за упаковку 5 штук (2250 рублей/кг)
Как заКило закрывает пробел
Пока законопроект о единых юнит-прайсах пылится в кабинетах, заКило берёт на себя всю работу по подсчёту цены за килограмм или литр — прямо в вашем браузере. Расширение автоматически считывает вес и объём товара из страницы, делает все вычисления локально и выводит рядом с привычной ценой понятную метку «₽/кг» или «₽/л».
— Никаких ручных калькуляций: вам не нужно помнить формулы и перебирать варианты — всё готово в один клик.
— Единообразный интерфейс: заКило выводит юнит-прайс в одном и том же месте и в одном стиле на всех поддерживаемых сайтах, избавляя от необходимости искать мелкие надписи.
— Реальная экономия: сразу видно, какая фасовка выгоднее, и не придётся переплачивать за «промо-упаковки» или странные объёмы.
— Простая интеграция: расширение уже работает на крупнейших сервисах доставки продуктов (Ашан, Яндекс.Маркет, Перекрёсток, Пятёрочка и др.) — достаточно установить и сравнивать.
ЗаКило закрывает пробел между законодателями и реальными покупателями, переводя борьбу за честную цену на практический уровень
Как можно помочь?
1) Предложить свою идею для доработки расширения - это я всегда строго приветствую
2) Помочь с дизайном - на некоторых сайтах какое то обилие цифр и текста и при добавлении цены за кг смотреть, на мой взгляд, становится сложно. Круто было бы разработать какой-нибудь универсальный макет для отображение цены и цена за единицу, чтобы было проще сравнивать товары, а также проще интегрировать расширение на новые сайты
3) Сейчас расширение показывает цену за ту единицу, которая указана на сайте - если литры, то за 1 литр, если килограммы, то за 1 кг. Но в некоторых категориях (молоко, например) какие-то товары показываются в мл, какие то в граммах. И сравнивать тоже не совсем корректно граммы с мл из-за плотности молока. Тут мне нужна помощь с тем, в каких категориях есть еще такое не соответствие. Про молоко я себе уже внес задачку, но про другие категории могу лишь догадываться
4) Помочь в разработке
К обсуждению проекта можно присоединиться в беседу в телеграме
UPD:
Некорректная ссылка на Ave Blacklist в посте, правильная такая: https://chromewebstore.google.com/detail/ave-blacklist/jhobdoodiicgomhcmcdapbdehndbhkfj
Сделал Telegram-бота для техподдержки через темы. Код открытый
Привет, Пикабу! 👋
Хочу показать вам Telegram-бота, которого я написал на Laravel. Он помогает вести персонализированную поддержку пользователей прямо в Telegram.
Ссылка на GitHub:
🌟 https://github.com/prog-time/tg-support-bot
Если зайдёте — буду рад вашей звёздочке!
Зачем вообще нужен такой бот?
Я веду блог по разработке, и мне часто пишут подписчики. Сначала я просто отвечал вручную, но быстро понял, что чат захламляется, сообщения теряются, и всё становится неудобно.
Хотелось:
централизованной переписки,
без спама в личке,
и чтобы пользователи не видел личный аккаунт.
Так и родилась идея: бот, который принимает сообщения от клиентов, создаёт для каждого отдельную тему в Telegram-группе, и пересылает туда все сообщения. Я отвечаю в теме — бот отправляет ответ клиенту от своего имени.
Никаких личных контактов. Никаких потерянных сообщений. Всё — в одной группе.
Как работает бот?
Очень просто:
Создаём группу в Telegram для фиксирования чатов.
В настройках группы включаем темы и добавляем бота в группу с правами администратора.
Пользователь пишет боту.
Если это новый клиент, бот создаёт отдельную тему в группе.
Вы отвечаете в этой теме — бот пересылает ответ клиенту.
🎯 Бонус:
Бот не хранит переписки, фото и файлы — только ID сообщений и клиентов. Никаких баз данных с чувствительной инфой. Всё по-честному.
Что умеет?
Поддерживает все типы сообщений: текст, голос, видео, документы, фото.
Подходит для небольших команд, которым нужна простая и быстрая поддержка через Telegram.
Настраивается примерно за 30-60 минут.
Название темы формируется из символа "#" и id пользователя.
У темы меняется иконка, в зависимости от последнего сообщения. Если последнее сообщение от клиента, то ставится иконка "облачко", а если оно написано со стороны администратора, то ставится "зелёная галочка".
Также вы можете получить информацию о пользователе с котором ведёте общение.Подобное сообщение отправляется при создание темы или после отправки команды /contact.
Как установить?
Процесс установки очень прост. Если что-то не получится — пишите мне в Telegram:
📬 https://t.me/prog_time_bot
В двух словах:
1) Клонируем репозиторий:
2) Создаём бота через BotFather.
3) Создаём приватную группу и включаем темы.
4) Добавляем бота в группу с правами администратора.
5) Получаем ID группы (например, через getmyid_bot).
6) Настраиваем .env файл проекта:
APP_URL="https://your-domain.ru"
TELEGRAM_TOKEN="ваш_токен"
TELEGRAM_GROUP_ID="id_группы"
TELEGRAM_SECRET_KEY="придумайте_ключ"
7) Заходим по адресу https://ваш-домен/api/telegram/set_webhook, для регистрации хука.
Готово. Теперь можно писать боту, и он будет пересылать сообщения в группу, где удобно отвечать клиентам.
Если было полезно — поставьте звезду на GitHub и расскажите друзьям-разработчикам.
Возможно, кому-то это сэкономит кучу времени и нервов.
Буду рад фидбеку!
Замена GitHub
В связи с выходом работ по продукту на этап тестирования, интересует возможность выложить исходники для свободного скачивания и тестирования желающими.
Враги заблокировали GitHub:
GitHub объяснил блокировку российских аккаунтов санкциями
По словам представителя сервиса, доступ к аккаунтам ограничен в соответствии с санкциями США.
Подробнее: https://www.securitylab.ru/news/531173.php
И возникает вопрос - какой ресурс использовать ?
Yandex Диск ? Какие аналоги GitHub есть ?
Update.
Оказывается , альтернативы есть и вполне достаточно:
https://vc.ru/dev/175025-top-10-alternativ-github-dlya-razmesheniya-open-source-proektov
Наверное к конференции , будет готов дистрибутив и статистика использования . Поживем увидим.
Windows 7 навсегда 2025
Браузер Chrome до сих пор можно запускать в Windows 7 путём кряка (crack). Спустя 2 года после прекращения официальной поддержки со стороны Google и 5 лет после прекращения поддержки Microsoft.
Как я прошёл путь от радиофизики, до работы AI инженером и... до попытки продать свой первый цифровой продукт
Когда-то давно я учился на радиофизика. Да, вот это вот всё: уравнения, матан, физика на стеро... ну вы поняли. Потом жизнь завернула довольно интересно — я переехал в Германию, выучился там на машинное обучение, поработал в нескольких крупных компаниях. Опыт набрался, в резюме всё красиво, проектов в портфолио тоже прилично. Казалось бы — живи, не тужи.
Но в какой-то момент начал замечать, что программирование само по себе — уже не "вау". Даже если ты делаешь какой-то прикольный проект, он почти всегда просто остаётся... в папке. Или на GitHub. Ну максимум — в CV. И всё.
А ведь когда-то я реально делал интересные вещи. Потенциал был, некоторые проекты могли бы перерасти в продукты. Но не перерастали. Почему? Потому что одного кода — мало.
💡 Реализация ≠ результат
Сегодня я чётко понимаю: уметь продать — это отдельный скилл, и он критически важен. Ты можешь быть каким угодно крутым технарём, но если ты не умеешь объяснить, зачем это кому-то, или не можешь хоть как-то донести ценность — твой проект так и останется лежать мёртвым грузом.
Банальный пример: сколько на GitHub лежит офигенных репозиториев, которые никто не знает, никто не использует, и они просто... всё. Есть. Где-то. В интернете.
Именно поэтому я решил поставить себе мини-челлендж: сделать максимально простой, но реально полезный продукт — и попытаться его продать.
💻 Что за идея?
Я сделал ассистента для прохождения технических интервью. Пока фокус на алгоритмических задачках, например, с LeetCode. Работает просто: кидаешь скрин задачи — получаешь помощь. Работает незаметно, даже при шаринге экрана. То есть ассистент не палится. Совсем.
Приложение собрано на Electron.js — чисто чтобы быстрее и проще было запустить. Дальше — посмотрим, как пойдут дела. Может, добавлю поддержку аудио и смогу покрыть все типы интервью — не только тех.
🎯 Почему я это делаю?
Потому что хочу наконец-то не просто сделать проект, а реально превратить его в продукт.
Хочу понять, как работает продажа. Как говорить с потенциальными пользователями. Как упаковывать. Как строить воронку. Короче, выйти из уютного мира кода — в мир живых людей.
Если интересно — могу дальше писать, как идёт путь. Это, знаете, как бизнес-дневник программиста-интроверта. Может, кому-то будет полезно или просто забавно наблюдать, как я сражаюсь с маркетингом и самим собой.
Пожелайте удачи! 🚀
Как залить big release на Github?
Сделал небольшой проект, больше для себя, но и так .. для всех. Код выложил на github (git push), тут без проблем. А вот скомпилированный бинарник в качестве релиза не получается. Через веб-интерфейс пишет ограничение на файл 25мБ, а у меня zip-файл 38 мБ. Причем как-то один раз получилось, а второй уже ни в какую. Вроде облазил весь help на github и упоминается, что через командную строку можно бОльшие файлы заливать, но ни одного примера не нашёл. Может подскажете верный источник знаний с примерами.














