Хабрахабр: Метки / manual

CakePHP / Нормальная офлайновая документация

artem_kovardin — Wed, 23 Nov 2011 08:58:54 GMT

Вместе с выходом второй версии фреймворка CakePHP обновилась и документация — book.cakephp.org/2.0/. А самое главное, появилась офлайновая дока. Скачать можно прям с первой страницы кукбука: CakePHPCookbook.epub. Можно скачть с гитхаба исходники или помочь с переводом и исправлением.

Мне было лень искать что-то, что читает формат .epub и я просто распаковал файлы и получил много html страничек. Такая документация выглядит примерно так. Zip с html страничками качаем отсюда

Mac OS X / Многоканальное аудио для MAC OS своими руками или как обЪединять интерфейсы

Nikita_Ka — Sun, 28 Aug 2011 03:26:08 GMT

Пошаговое руководство, как скрутить вместе 2 разных аудиоинтерфейса в один под MAC OS X без паяльника и дополнительных проводов. Думаю, будет полезно дискжокеям и сочувствующим.

Читать дальше →

PostgreSQL / CHM-справка для PostgreSQL 9.0

pasha_golub — Thu, 03 Mar 2011 13:20:54 GMT

По роду своей службы я очень часто пользуюсь справкой по PostgreSQL, начиная с 8.х версий. И если раньше на странице документации сайта можно было найти для скачивания CHM файл справки, то для версии 9.0 (полагаю, что и далее) такой возможности нет.

Сразу отвечу почему пользоваться онлайн версией невыносимо — документация состоит из 1036 тем и, вдобавок ко всему, поиск на сайте мне не по душе. Стоит также отметить, что дерево оглавления в CHM версии ускоряет навигацию раз, эдак, в десять!

Мой хороший друг, страстный любитель Perl'a и по совместительству хабраюзер habazlam взялся за создание утилиты, способной из набора html/sgml файлов, что поставляются в исходниках с сервером, скомпилировать справку в CHM формате. Удалось ему это на славу. Единственное, что требует доработки, — это Индексы (поиск по ключевым словам). Однако даже без этого пользоваться таким мануалом во сто крат удобней, нежели онлайн аналогом.

Для всех страждущих линк: postgresql-9.0.chm

UPD: Главный цимус CHM формата для 1036-темных мануалов — это полнотекстовый индекс, без которого Донцову читать в самый раз, а мануалищще постгрессовый — чокнешься! ©habazlam

UPD: У кого не получается запустить файл, правой кнопкой на нём, затем Properties -> Unlock. Проблема CHM файла, «скачанного из интернета». Моя вина — надо было в архив положить.

Блог компании MCNtelecom / Что такое хороший мануал к ПО?

illaniel — Fri, 02 Jul 2010 11:58:11 GMT

Хотелось столько всего рассказать, столько всего написать, что теряешься от созерцания горизонтов тем, мыслей, соображений.

Наверно стоило бы рассказывать о компании и о ее проектах, но это может быстро ввести читателя в грусть-тоску. Поэтому первое, с чего мы решили начать, спросить совета.

С ростом проекта WELLtime команда наших разработчиков встала перед несколькими вопросами. Развивающийся программный продукт дал почву для реорганизации линейки предложений, изменения приоритетов между его модулями и подал много интересных идей.

Но это были одни из основных ожидаемых направлений деятельности.

Не думали не гадали мы, и, прямо таки, никак не ожидали мы, что продукт станет ожидать от нас координального обновления справочного материала.

Сделать продукт не просто, но написать к нему грамотный мануал не легче.
Возникло много интересных идей и рациональных предложений, но хотелось бы спросить у хабролюдей, что для них является показателем хорошего мануала к ПО?

Nokia / Nokia N900: Курс молодого бойца (КМБ) или осваиваем и осматриваемся

rule — Wed, 24 Feb 2010 09:56:48 GMT

Доброго времени суток дорогой читатель. Продолжаю цикл статей, посвященных Nokia N900.

О чем пойдет речь в этот раз? На этот раз я расскажу как «приручить» купленный N900, иногда у «новобранцев» возникают вопросы (как залить контакты, как настроить интернет ...).
В этой статье я популярно попытаюсь объяснить как и что настроить, чтоб все работало как в промо-ролике из моей предыдущей статьи :-)

Вот, допустим, такой упаковкой мы располагаем (фото взято с www.prlog.org/10472013-brand-new-nokia-n900-32gb-factory-unlocked.html, попытался снять своё фото, чтоб изобразить процесс распаковки, вот не получилось, поэтому даю это фото :-) ).

Не имеющий же в своем распоряжении N900, может просто посмотреть и оценить платформу по маленьким скринкастикам и сделать выводы касательно ее функционала и юзабилити (хотя я лично настаиваю на том, чтоб прежде чем делать какие-нибудь выводы, обязательно нужно походить с этим аппаратом дня 2-3).

Начнем по порядку(смотри руководства под катом).

Читать дальше →

PHP / Новый PHP-мануал

nxn — Mon, 25 Jan 2010 18:48:58 GMT

Всем, кто программирует на PHP, я предлагаю воспользоваться новым мануалом. Со времени его прошлого релиза произошли полезные изменения, которые были сделаны по заявкам хабравчан:

Быстрый поиск. Достаточно приписать к адресу мануала запрос. Например, http://manual.pohape.ru/str_replace
Кнопки «Назад» и «Печать»
Иерархические ссылки к каждой странице. Например, зайдя на страницу с описанием числа pi, можно быстро перейти на её родительские страницы: функции и математические функции
Был подправлен css страниц мануала, выкинуто лишнее, теперь они больше «дышат»
Suggest в списке функций был переписан. Теперь нету неприятных косяков, да и некоторые браузеры могут работать быстрее

Для тех, кто раньше не знал ничего об этом мануале, я освещу его основные преимущества:

Дизайн в стиле chm-справки понравится тем, кто успел привыкнуть к такой версии в ОС Windows
Английская версия мануала вмещает больше статей, чем её chm-аналог
Русская версия вообще стала раритетом, так как её более полугода назад убрали с php.net. В мануале же она присутствует.
Нет проблем с русским языком в интерфейсе, какие наблюдались с chm-файле
Для каждой страницы присутствуют комментарии с сайта php.net

Спасибо всем, кто вступал в переписку, указывал на косяки.
Все найденные баги и фючер реквесты новой версии я готов принять в комментариях либо по почте pohape.ru@pohape.ru

Пользуйтесь на здоровье, адрес прежний: http://manual.pohape.ru/

Linux для всех / Потоковое видео средствами ffserver & ffmpeg

TheRipper — Sat, 19 Dec 2009 04:56:48 GMT

Для организации трансляции нам потребуется:

Linux
FFmpeg (включает в себя ffserver)

Теория

FFmpeg — это набор свободных библиотек с открытым исходным кодом, которые позволяют записывать, конвертировать и передавать цифровое аудио и видео в различных форматах. Он включает libavcodec, библиотеку кодирования и декодирования аудио и видео и libavformat, библиотеку мультиплексирования и демультиплексирования в медиаконтейнер. Название происходит от названия экспертной группы MPEG и «FF», означающего «fast forward».

© Wikipedia

ffserver идёт в комплекте с ffmpeg и выполняет роль медиа-сервера — получает видеопоток от ffmpeg, который может быть запущен на другой машине, и раздаёт его счастливым пользователям.
Каждый получаемый поток называется Feed’ом (далее будет просто фид). Таких потоков может быть несколько, так же как и отдаваемых (выходных).
FFmpeg у нас будет захватывать видео с веб-камеры или читать из файла.

Читать дальше →

Linux для всех / WimaxYota для 2.6.31-14-generic (netbook Remix ubuntu 9.10, intel 5150)

KIparIs — Sat, 05 Dec 2009 17:32:34 GMT

Итак, я перепробовал множество мануалов для поднятия Йоты, и у меня ничего не получилось. Пришлось все равно додумывать за авторов и править ручками. И вот он, готовый ман для поднятия йоты без проблем.

Читать дальше →

PostgreSQL / dblink

phoinixrw — Fri, 02 Oct 2009 10:05:04 GMT

На работе потребовалось разобраться с провести множество экспериментов с dblink.
Что бы не наступать по нескольку раз на одни и те же грабли, параллельно сделал перевод документации разбавив его своими комментариями.

Кому интересно, велкам: doc.prototypes.ru/database/postgresql/contrib/dblink/

Родная документация тут: www.postgresql.org/docs/8.4/static/dblink.html

Персональные блоги / Руководство программиста Webasyst Shop-script

easyweb — Mon, 14 Sep 2009 08:58:19 GMT

Немного обновился документ, который заинтересовал более 1000 человек. Обновил его, потому, что на форуме компании Webasyst было очень много вопросов по поводу стилей и структурой каталогов.

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

Читать дальше →

PHP / Русская документация по PHP?

blockdog — Mon, 24 Aug 2009 16:23:01 GMT

Зашёл сегодня на официальный сайт, и не нашёл там русской документации в онлайне…
На странице загрузки русского также нет…

Диверсия? Или давно никто не обновлял, они и потёрли?

P.S.: В настройках сайта русского языка также нет…

PHP / PHP Manual с комментариями пользователей в chm

Sulako — Tue, 18 Aug 2009 13:21:37 GMT

Навеяно вот этим: Похапе мануал обновился

Мне лично удобней пользоваться CHM версией руководства по PHP — быстрый поиск удобен, а интернет не всегда доступен. Но у официальной справки нет встроенных пользовательских комментариев, которые зачастую бывают очень полезны. Ранее они были в Extended-версии руководства, но сейчас она уже не поддерживается.

Полазив в гугле, я обновленной версии руководства с комментами не нашел. Пришлось сделать собственную, и этот процесс может повторить любой желающий.

Как именно?

PHP / Похапе мануал обновился

nxn — Mon, 17 Aug 2009 19:38:07 GMT

Альтернативный мануал к PHP обновился. Напомню, он хорош для тех PHP-разработчиков, кто привык пользоваться chm-версией справочника, ведь он решает некоторые проблемы:

Корректная кодировка русскоязычных разделов
Решение проблем с открытием chm-файлов под Линуксом и Макосью

Хотя наплыв пользователей одной известной операционной системы компании «Майкрософт» показал, что мануал приглянулся не только целевой аудитории.

В новой версии произошли довольно полезные изменения:

К каждому разделу справочника теперь прикреплены полезные комментарии с сайта php.net, которые просили хабраузеры в своё время
Добавились быстрые ссылки на конкретные разделы для обмена с друзьями
Английская версия мануала обновилась до версии PHP 5.3. На сайте php.net с некоторых пор русская документация отсутствует. Я решил оставить её, зато по дефолту сделал открытие английской версии, в любом случае это настраивается
Переезд на новый хостинг и сжатие данных дало прирост в скорости открытия

http://manual.pohape.ru

Пользуйтесь за здоровье, все фючер реквесты приму с удовольствием.

Веб-разработка / [Перевод] Русский перевод руководства пользователя веб-ОС eyeOS для версий 1.8

IEugene — Mon, 11 May 2009 16:03:52 GMT

Русский перевод руководства пользователя веб-ОС eyeOS для версий 1.8. Переведено и переделано для версий 1.8 мной для коммьюнити eyeOS. На данный момент это первое и единственное руководство пользователя и документация на русском языке вообще. Размещен на официальном сайте eyeOS по адресу eyeos.org/usermanual

Содержание

1. Введение
1.1. Вход в систему
1.2. Создание нового пользователя
2. Рабочий стол: первые шаги
2.1. Панель приложений
2.2. Значки по умолчанию
2.2.1. Значок «Домашняя папка»
2.2.2. Значок «Приложения»
2.2.3. Значок «Корзина»
2.3. Системная панель
2.4. Панель задач
3. Основные приложения
3.1. eyeFiles: менеджер файлов
3.1.1. Общие операции
3.1.1.1. Пример использования
3.1.1.2. Загрузка файлов
3.1.1.3. Открытие файлов
3.2. eyeDocs: текстовой процессор
3.2.1. Создание документа
3.2.2. Сохранение документа
3.2.3. Открытие документа
3.3. eyeCalendar
3.3.1. Добавление события
3.3.2. Перемещение события
3.3.3. Редактирование события
3.4. eyeContacts
3.4.1. Добавление нового контакта
3.4.2. Просмотр, редактирование и удаление контакта
3.4.3. Импорт и экспорт контактов
3.5. eyeBoard: доска объявлений
3.5.1. Посылка сообщения
3.5.2. Очистка доски
3.6. eyeMail: клиент электронной почты
3.6.1. Прием почты
3.6.2. Отправка нового сообщения
3.7. eyeRSS: читатель новостных лент
3.7.1. Добавление новой ленты
3.7.2. Чтение ленты
3.7.3. Обновление ленты
3.7.4. Удаление ленты
3.8. eyeProcess: диспетчер процессов
3.8.1. Закрытие приложения
3.9. eyeControl: панель управления
3.9.1. Изменение вида вашего рабочего стола
3.9.2. Администрирование системы
3.9.2.1. Общее администрирование
3.9.2.2. Управление пользователями
3.9.2.3. Управление группами
3.9.2.4. Управление хранилищами
3.9.2.5. Установка нового программного обеспечения

Читать дальше →

JAVA / Перевод манов с оффсайта Sun. Часть 1

EdWing — Thu, 07 May 2009 13:56:56 GMT

Еще в сентябре прошлого года, начиная изучение Java я наткнулся на подкаст Голодного «The Art Of Programming». В одном из них он прославлял мануалы? расположенные на оффсайте Sun. Достаточно долгое время проведя со словарем и IDE, я добился некоторого результата.
Недавно пришла мысль, что люди, не сильно владеющие английским языком не могут использовать этот ресурс, каким бы хорошим он ни был.
Ниже последует перевод первой статьи (она небольшая), а к хабралюдям есть вопрос: как вы оцениваете качество/целесообразность подобного перевода?

P.S. Публикую в блоге JAVA, потому что никак не получается опубликовать в «Стартап Программист»
P.P.S. За дельный совет в переводе спасибо miravingin

Читать дальше →

Opera / Изучаем Opera 9.6

Shpankov — Wed, 08 Oct 2008 18:34:30 GMT

В теме об официальном релизе очередной финальной версии браузера Opera 9.6 промелькнула ссылка, которой и сам сначала не придал особого значения. Между тем, при ближайшем рассмотрении оказалось, что ресурс этот довольно любопытный. Норвежцы подготовили целый путеводитель по новому браузеру, гле пусть кратко (т.е. — нескучно читать), но при этом подробно (собрав в одном месте описания почти всех основных функций браузера) рассказывается, для чего нужна та или иная функция и как ей пользоваться. Этакое пособие для начинающих.

Читать дальше →

Opera / Opera-9.5: С чистого листа

Shpankov — Sat, 14 Jun 2008 00:30:16 GMT

Идея написать данную статью возникла сразу вслед за релизом браузера Opera-9.5. Видимо, свою роль сыграли постоянные вопросы пользователей о том, как грамотно перейти со старой версии на новую. Не секрет, что при обновлении установка Opera поверх предыдущей версии нередко приводит к непредсказуемым последствиям, за что разработчикам большой минус. Впрочем, на данный момент мы имеем то, что имеем, поэтому есть смысл просто выполнить переход на последний релиз с соблюдением неких правил, годами «вымученных» опытными пользователями Opera.

Надеюсь, хватит времени, сил и желания продолжить работу ;)

Кстати, подразумевается, что сей труд окажется полезным не только для пользователей, кто уже работает в Opera, но и тем, кто решил попробовать его в работе впервые.

Читать статью

Update
Продолжение

Update
Готова третья статья из цикла "Opera 9.5: С чистого листа". Продолжаем изучать настройки браузера Opera.

Готова четвёртая статья из цикла "Opera 9.5: С чистого листа".

PHP / Стираю языковые барьеры. Бесплатно

oowl — Sun, 24 Feb 2008 12:27:19 GMT

Примерно так можно озаглавить вещи, которые я делаю в свободное время вот уже несколько месяцев. После руссификации мануала по CakePHP я занялся переводом на русский язык документации по другому фреймворку.

Интересно, какому?

Персональные блоги / Haskell: а мне можно?

blockdog — Thu, 16 Aug 2007 10:23:20 GMT

Заметка для тех, кто не только слышал всякое про Haskell, но еще и заинтересовался этим...

Привожу несколько ссылок для тех, кто хочет понять, что же такого "здоровского" в этом языке программирования, и с чего начать:

Видео с OSCON 2007: A taste of Haskell (Simon Peyton-Jones): Часть 1, Часть 2
(Много траффика)

Описание языка и стандартной библиотеки на русском

Yet Another Haskell Tutorial

Meta-tutorial

Write Yourself a Scheme in 48 Hours

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

Персональные блоги / Python за 10 минут

zhulan0v — Thu, 07 Jun 2007 16:24:00 GMT

Отличная статья, этакий экспресс тур по основным фишкам питона (синтаксис, типы данных, циклы, классы, etc). Этот материал пригодится, если вы просто хотите понять основные отличия питона от других языков типа ruby или php.

P.S. Обожаю питон за конструкции вроде [x * y for x in lst1 for y in lst2]