LINUX.ORG.RU

mdoc.su — короткие адреса системных руководств BSD

 , , , ,


0

1

Тихо и незаметно, в свет вышел сайт для быстрого запроса системных страниц помощи всех популярных BSD систем по короткому веб-адресу.

Например, для просмотра или ссылки на man(1) FreeBSD, теперь можно использовать адрес http://mdoc.su/f/man.1 (указание раздела — необязательно). Имеется поддержка версий ОС, например, /f91/ или /FreeBSD-9.1/. Сайт поддерживает man'ы FreeBSD, OpenBSD, NetBSD и DragonFly BSD; есть возможность ссылаться сразу на руководства нескольких систем одновременно (http://mdoc.su/f,d/ifnet.9) — в таком случае, будет выдана страница со статусом 300 Multiple Choices; и можно даже указывать необходимые версии систем (http://mdoc.su/f91,n60,o52,d/mdoc).

Весь сайт написан исключительно на языке nginx.conf стандартной конфигурации (без каких-либо внешних файлов), и исходники доступны по лицензии BSD на самом сайте и на ГитХабе.

>>> mdoc.su — короткие веб-адреса системных руководств БСД



Проверено: beastie ()

Весь сайт написан исключительно на языке nginx.conf

это успех

Mr_Gentoo ()

исключительно на языке nginx.conf

Покажите Сысоеву, пусть поржет :D

tazhate ★★★★★ ()
Ответ на: комментарий от tazhate

На самом деле там есть к чему прикопаться. (Pitfalls, If Is Evil) Но сам факт конечно забавный.

На самом деле вещь хорошая. Я часто ссылаюсь на *BSD маны. Как ни крути, но это самые полные и самые лучшие маны, которые есть в *nix мире.

Пардон, но до сходного качества GNU манам как раком до Луны.

beastie ★★★★★ ()
Последнее исправление: beastie (всего исправлений: 1)
Ответ на: комментарий от beastie

На самом деле там есть к чему прикопаться.

То, о чем ты говоришь - это синтаксис сишных конфигов и их нормальное оформление.
А то, о чем пишет автор - тупо реврайты с регулярками.

tazhate ★★★★★ ()
Последнее исправление: tazhate (всего исправлений: 1)
Ответ на: комментарий от tazhate

Я в частности о (одна из типичных ошибок):

server {
	server_name mdoc.su www.mdoc.su *.mdoc.su;
	if ($host != "mdoc.su") {
		rewrite	^ http://mdoc.su$request_uri? redirect;
	}
	…
}

Каноничное, правильное решение:

server {
	listen 80;
	listen [::]:80;
	server_name .mdoc.su;
	rewrite	^ $scheme://mdoc.su$request_uri? redirect;
}

server {
	listen 80;
	listen [::]:80;
	server_name mdoc.su;
	…
}

С if'ами там тоже что-то в конце, но я ещё внимательно не смотрел.

beastie ★★★★★ ()
Последнее исправление: beastie (всего исправлений: 2)
Ответ на: комментарий от tazhate

Ага ☺ (Весь сайт написан исключительно на языке nginx.conf)

beastie ★★★★★ ()

Весь сайт написан исключительно на языке nginx.conf стандартной конфигурации (без каких-либо внешних файлов)

прикольно, теперь знаю, на чем делать сайты-визитки. и интересно, какую нагрузку оно способно выдержать - насколько шустр nginx с кучей location'ов с регексами?

Spoofing ★★★★★ ()
Ответ на: комментарий от beastie

Ну если уж так, то и ваше решение тоже неправильное: там у них в Pitfalls теперь пишут, что даже `rewrite ^ http://mdoc.su$request_uri? redirect` — неправильно, и нужно делать исключительно `return 302 http://mdoc.su$request_uri;`. (Это, кстати, для меня самого новость, раньше они точно говорили, что `rewrite ^ http://mdoc.su$request_uri?` — правильно.)

А вообще — я здесь поспорю, что оба решения по сути одинаковы. Но текущее решение mdoc.su занимает меньше места и читать легче, так что данное замечание не существенно и, ИМХО, не является таким уж плохим стилем nginx.conf — наоборот, как раз меньше копирования в конфигурационном файле.

С if'ами там тоже что-то в конце, но я ещё внимательно не смотрел.

Ну, блин, а как по твоему можно то же самое без if сделать? Форкай на ГитХабе, исправляй в конце там if'ы, будем смотреть, что у тебя получится. :-p

А вот если сам текст документа IfIsEvil почитать, то станет ясно, что никаких злых ифов в mdoc.su.nginx.conf нет.

cnst ()
Ответ на: комментарий от tazhate

Очень там всё прилично написано, никакого ужаса нету.

cnst ()

Приятно видеть, что BSD ещё живо. Альтернативы это всегда хорошо.

Sakka ()
Ответ на: комментарий от zgen

Чтобы можно было сделать флешку с фряшечкой размером 128 мегабайт путем выкидывания всего лишнего. А поскольку документацию терять не хочется, ее переместили в сеть. Не удивлюсь, если они напишут отдельную версию самой программы man, которая будет обучена лазить на этот сайт.

anonymous ()
Ответ на: комментарий от cnst

Ага, очень прилично. Надо попробовать скомпилить этот конфиг вдруг бинарь из него выйдет - убийца вебсерверов :)

partyzan ★★★ ()
Ответ на: комментарий от anonymous

У того, кому нужно сделать флешку с фряшечкой на 128mb наверняка еще 100500 фряшечек найдется, на которых это можно посмотреть без инета.

zgen ★★★★★ ()
Ответ на: комментарий от anonymous

если они напишут отдельную версию самой программы man

да, идея здравая)

ymn ★★★★★ ()

Во-первых, просто сделали шоркаты для офф. сайтов. Нормальному человеку ничего не стоит самому в браузере вбить, валидный адрес.
Во-вторых, тру сайт, с которого надо брать пример - http://man7.org

Имхо, пилить и пилить. И гордиться тут нечем.

gh0stwizard ★★★★★ ()
Последнее исправление: gh0stwizard (всего исправлений: 1)
Ответ на: комментарий от cnst

Ну вот видишь, не разбираешься в чем прелести. На кой в 21 веке запоминать где и что лежит? А у них каталог по всем возможным типам. А также странички где все видно, откуда мне знать сколько видов wait имеется?
Далее, это kernel man pages и сишной библиотеки, а не всего и вся.
И не надо горячится. Цели и задачи у всех разные. Просто твой вариант смахивает для машин, а не людей. Заставлять помнить все секции и что в них лежит, имхо, античеловечно.

gh0stwizard ★★★★★ ()
Ответ на: комментарий от gh0stwizard

Никто ничего не заставляет помнить. У нас на БСД и без разделов всё замечательно работает: http://mdoc.su/f/patch. А вот на man7.org вообще ничего про patch нет, даже если самому смотреть.

А по поводу wait: это системный вызов, они всегда находятся во втором разделе, это же элементарно! :-)

Мой вариант как раз для людей, которым муторно либо здоровенный адрес в истории браузера искать, либо идти на сайт и искать там man.cgi. Ну и в Твитере удобно такие адреса набирать, или на телефоне, например. И для всевозможной интеграции удобно, да. Совсем не обязательно для машин.

cnst ()

Домен .su, а язык английский.

Как этим пользоваться?

Xintrea ★★★★★ ()
Ответ на: комментарий от cnst

Что удобного в том что надо идти на офсайт если ты не помнишь названия функции? Видов wait между прочим три: wait, wait3, wait4. На ман7 я это увижу сразу.

Ты уже сам сказал целевую аудиторию: твиттер. Ну здорово чо, гордись.

Удобно всегда и везде ввести: man cmd. Быстро, надежно и 100% валидно.

gh0stwizard ★★★★★ ()
Ответ на: комментарий от gh0stwizard

http://mdoc.su/f/wait.2 — там все варианты wait и перечислены, включая wait3 и wait4.

Целевая аудитория не только твиттер. Я сам лично часто использую просто так в повседневной практике, до этого приходилось длинный URL в истории искать, или опять на главный сайт freebsd/openbsd идти, а теперь всё просто. :-)

cnst ()
Ответ на: комментарий от gh0stwizard

Во-вторых, тру сайт, с которого надо брать пример - http://man7.org

Ух ты!
Спасибо, не знал. Понравилось и ушло в закладки.

Spirit_of_Stallman ★★★ ()

да ничо так говносайтик, в сапу примут

anonymous ()

локально маны читать уже не модно?

Harald ★★★★★ ()

Зачем это? В FreeBSD поломали «man»?

rtvd ★★★★★ ()
Ответ на: комментарий от rtvd

Можно читать маны фряхи не выходя из линукса!

anonymous ()

Весь сайт написан исключительно на языке nginx.conf

Немедленно вызывайте Сысоева, он должен это видеть.

anonymous ()
Ответ на: комментарий от anonymous

Можно читать маны фряхи не выходя из виндоса!

fixed

anonymous ()
Ответ на: комментарий от Xintrea

Этим пользоваться могут только американские коммунисты.

AiFiLTr0 ★★★★★ ()

Весь сайт написан исключительно на языке nginx.conf стандартной конфигурации (без каких-либо внешних файлов)

вся новость просто меркнет по сравнению с этой строкой

q11q11 ★★★★★ ()
Ответ на: комментарий от rtvd

для быстрого запроса системных страниц

тормозит же

anonymous ()
Ответ на: комментарий от TheLibertyMan

Поддержка /fond/ — экспериментальная. :-) При /f91o52n60d/, без запятых, получается уж слишком большой винегрет, мы такого пока поддерживать не будем. :-)

Но за проверку работоспособности и вникания в детали — спасибо!

cnst ()

а почему такая дрочка именно на *bsd?

anonymous ()
Ответ на: комментарий от Xintrea

/offtopic

Беда-печаль, что случилось с webhamster.ru? Где последнюю MyTetra скачать?

ollowtf ★★★ ()
Ответ на: комментарий от ollowtf

Ого, nginx поплохело первый раз за три года. Буду разбираться.

Xintrea ★★★★★ ()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.