- Notifications
You must be signed in to change notification settings - Fork0
s-and-witch/ruhaskell
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Сайт русскоязычного сообщества Haskell-разработчиков.
Мы уверены, что каждому Haskell-энтузиасту есть что рассказать коллегам, но наши блоги разбросаны по просторам интернета, а кроме того, не всем хочется строить собственное блоговое пространство. Поэтому наш сайт представляет собой единое место обмена опытом, где каждый сможет рассказать обо всём, так или иначе связанном с разработкой на Haskell.
Принимаются материалы, имеющие прямое или косвенное отношение к Haskell. Это может быть что угодно:
- Разжёвывание фундаментальной теории, о каких-нибудь категориях и иже с ними.
- Рассмотрение любых аспектов языка, от Hello World до свободных монад и трансформерных ужасов.
- Рассказ об инструментах, связанных с Haskell.
- Готовые практические рецепты. Что называется, копи-паст - и вперёд!
- Истории успеха или неудачи, связанные с практической разработкой на Haskell.
- Пиар программного решения, реализованного с помощью Haskell.
Причём технический уровень статей может быть рассчитан на любых читателей, от зелёных новичков до экспертов.
Статьи принимаются в форматеMarkdown
, рекомендуется использовать расширение.md
.
В начале каждой статьи должен присутствовать информационный блок следующего вида:
---author: Денис Шевченкоtitle: Yesod: знакомствоtags: Yesod, вебdescription: Yesod - это мощный веб-фреймворк, написанный на языке Haskell.---
где:
author
- имя автора статьи,title
- название статьи,tags
- один или более тематических тегов, перечисленных через запятую,description
- краткое описание статьи, необходимое для обновлений в RSS.
Кроме того, существует опциональное полеhrefToOriginal
. Если оригинал публикуемой вами статьи находится на стороннем ресурсе, просто допишите полеhrefToOriginal
к вышеупомянутым полям:
hrefToOriginal: https://www.fpcomplete.com/user/astynax/basics/pine-tree
В результате этого в верхней правой части статьи будет размещена ссылка на оригинал.
Внимание! Если автором оригинала публикуемой вами статьи являетесьне вы - убедитесь в том, что автор согласен на публикацию его статьи в рамках нашего ресурса.
Имя файла статьи должно быть сформировано следующим образом:
гггг-мм-дд-краткое-имя-статьи.md
Например:
2014-12-27-yesod-raw-deploy.md
URL этой статьи станет таким:
/posts/2014/12/27/yesod-raw-deploy.html
Это позволит отфильтровать статьи по дате публикации. Причём если номер месяца или дня меньше 10, то его необходимо начинать с0
. Например, публикация от 1 мая должна быть названа так:
2014-05-01-yesod-raw-deploy.md
Все Markdown-статьи хранятся в веткеmaster
. Иерархически они располагаются в каталогеposts
, но не в корне, а обязательно в своём тематическом подкаталоге. Имя подкаталога соответствует названию категории. Например, все статьи из категорииweb
располагаются в каталогеposts/web/
. Разумеется, поскольку имя каталога участвует в формировании базового URL статьи, оно должно быть английским.
Посколько Git не любит пустые каталоги, тематические подкаталоги будут создаваться по мере написания статей.
Вы можете собрать сайт у себя:
$ git clone git@github.com:ruHaskell/ruhaskell.git$cd ruhaskell$ stack setup$ ./just_build.sh
После этого откройте в браузере страницу_site/index.html
.
Для удобства можно запустить скриптwatch.sh
, при изменении постовсайт будет собираться автоматически. Если у вас установлен Firefoxс расширениемMozRepl,также будет обновляться вкладка с локальной версией сайта:
$ ./watch.sh
Запрещены:
- оскорбления в любой форме,
- явный оффтоп,
- спам.
Статьи и/или комментарии, содержащие первое, второе и/или третье, будут удалены.
Вопросы? Предложения? Критика? Стучитесь в нашчат или пишитеЮрию Сыровецкому иДенису Шевченко.