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 ()
Последнее исправление: beastie (всего исправлений: 1)

Ответ на: комментарий от 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
() автор топика

Приятно видеть, что 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
() автор топика
Ответ на: комментарий от 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 ★★★★★
()

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

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

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

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

fixed

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

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

AiFiLTr0 ★★★★★
()

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

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

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

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

тормозит же

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

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

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

cnst
() автор топика

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

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

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

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