Вы не вошли. Пожалуйста, войдите или зарегистрируйтесь.
Форум MaemoWorld.ru → О сайте и форуме → Команды X-терминала
Страницы 1
Чтобы отправить ответ, вы должны войти или зарегистрироваться
Добавлена статья "Команды X-терминала". Немного черновой вариант (3 часа ночи на дворе 
), не раскрыты аспекты команд, и мало команд описано. Конструктивная критика приветствуется, а так же приветствуются хорошие правки 
Добавлена статья "Команды X-терминала".
Вот здорово!
У меня пока пожелания такие: команды выделять в код и сделать рубрикацию (сейчас это поправлю), а еще указать для каких нужны права root.
Добавлено: 06.01.2010 02:51:52
Сделал первую часть так, как хотелось бы видеть мне. есть замечания, пожения?
У меня пока новые пожелания.
Описания команд в общем формате - ответ на вопрос "Что сделать?".
Выделение описания команды с помощью === добавляет ее в навигацию.
Синтаксис команды, думаю, стоит оформлять как код - строка, начатая с пробела; части команды в описании и комментариях - в теге <code>.
Стоит ли все "например" выделять курсивом?
Работу с приложениями, быть может, стоит разделить: работа с репозиториями и работа с deb-пакетами?
Немного перепечатал mna.
Изменил оформление первой части так как что то там было занимало много места и было не читаемо.
Список команд очень большой и если все добавлять в навигацию то страница получится огромной.
Вообще мне кажется самая лучшая структура это то как описано в man — название команды, краткое описание, список ключей, подробное описание, подробное описание ключей с учетом особенностей систем (POSIX, GNU, BSD, System V...), описание особых параметров команды (например для grep описание составление последовательности для поиска), подробные примеры использования, список похожих команд. Больше информации чем в man по команде нигде не найти и его читать удобно так как он жестко структурирован. Только вот если столько информации на вики выкладывать никто это читать не будет... Только вот далеко не по каждой команде можно сделать выжимку основных параметров чтобы сразу понять как ей пользоваться.
Можно еще попробовать сразу писать примеры использования команд с описанием (пример: http://www.pixelbeat.org/cmdline_ru_RU.html ). Будет довольно много дублирования и не будет четкого описания что какой ключ делает, но зато это сразу можно использовать. Главное при этом научить пользователей читать man чтобы понять что еще команда умеет делать.
Изменил оформление первой части так как что то там было занимало много места и было не читаемо.
По-моему, сейчас не читиемо, т.к. полужирное оформление команд сливается с заголовками.
Кроме того, пропала навигация, которая представляла собой список команд, а в нем, по-моему, было удобно смотреть что вообще доступно.
Список команд очень большой и если все добавлять в навигацию то страница получится огромной.
Может, для каждого набора команд просто свою страницу?
Некоторые ключи (например -R - рекурсивно) являются общими для многих команд. Может как то это объединить с ссылками на те команды, к которым подходит ключ?
SR, к сожалению man не включен в стандартную поставку busybox'а, а многие не будут утруждаться установкой справочной системы
--help не всегда спасает.
Добавлено: 06.01.2010 19:36:59
KiRiK, может сделать краткое описание, а подробное описание "возложить" на wikipedia? (то есть ссылку на внешний источник сделать)
может сделать краткое описание, а подробное описание "возложить" на wikipedia? (то есть ссылку на внешний источник сделать)
Можно и так.
А можно, если хочется свое описание, делать подробности команды в отдельной статье. Только тогда заголовки таких статей нужно обсудить.
Вообще все man страницы есть в интернете (например на http://www.opennet.ru/man.shtml).
Так что возможно просто стоит составить список команд с очень кратким описанием без всяких подробностей и ключей и давать ссылки на man страницы. Тогда может на вики и не придется это все бить на много страниц.
А вот ключи такие как -R я точно бы не объединял. Да во многих случаях поведение у таких опций общее, но в некоторых случаях оно может давать не тот результат который ожидает пользователь. Например архиваторы с этой опцией будут сжимать каждый файл по отдельности встретившийся им в пути а не создавать один архив со всеми файлами (точно помню что в man для 7z прям так и написано что результат использования этого ключа будет не таким каким пользователь скорее всего думает он будет и тут уже лучше вначале прочить какие у него будет поведение). Хотя с точки зрения логики поведения этого ключа результат будет правильный, но пользователь скорее всего хотел получить именно один архив с файлами а не много сжатых файлов.
Страницы 1
Чтобы отправить ответ, вы должны войти или зарегистрироваться
Форум MaemoWorld.ru → О сайте и форуме → Команды X-терминала
Форум работает на PunBB, при поддержке Informer Technologies, Inc
Currently installed 6 official extensions. Copyright © 2003–2009 PunBB.
Сгенерировано за 0.069 секунды (95% PHP — 5% БД) 9 запросов к базе данных
