%chapters; ]> Учебник по Проекту Документирования FreeBSD для новых участников The FreeBSD Documentation Project 1998 1999 2000 2001 2002 2003 2004 2005 DocEng $FreeBSD$ $FreeBSD$ &bookinfo.legalnotice; Благодарим вас за то, что вы стали частью Проекта Документирования FreeBSD. Ваше участие чрезвычайно нужно. Этот учебник описывает все, что вам нужно знать для того, чтобы принять участие в Проекте Документирования FreeBSD, от инструментов и программного обеспечения, которое вы будете использовать (как обязательное, так и рекомендуемое), до философии Проекта Документирования. Этот документ все время подвергается изменениям, и не полон. Еще не законченные разделы помечены знаком * в названии. Используемые сокращения Приглашения командных процессоров В следующей таблице показано системное приглашение по умолчанию и приглашение администратора. В примерах такое будет использоваться для обозначения того, каким пользователем должен выполняться пример. Пользователь Приглашение Обычный пользователь &prompt.user; root &prompt.root; Типографские соглашения В следующей таблице описаны типографские соглашения, используемые в этой книге. Значение Примеры Названия команд, имена файлов и каталогов. Выдача на экран. Отредактируйте ваш файл .login.Используйте команду ls -a для выдачи списка всех файлов. You have mail. То, что набираете вы, когда это отличается от экранной выдачи компьютером. &prompt.user; su Password: Ссылки на страницы справочной системы. Воспользуйтесь командой su 1 для смены имени пользователя. Имена пользователей и групп Только root может это делать. Выделение Вы должны это сделать. Переменные параметры командной строки; заменяйте их реальными названиями или значениями. Для удаления файла наберите rm filename Переменные окружения $HOME является вашим домашним каталогом. Замечания, советы, важная информация, предупреждения и примеры Внутри текста встречаются замечания, предупреждения и примеры. Замечания имеют такой вид, и содержат информацию, которую вы должны принять к сведению, так как она может затронуть ваши действия. Советы имеют такой вид, и содержат информацию, которая может оказаться полезной для вас, или предлагают более простой способ сделать что-либо. Важная информация имеет такой вид. Обычно здесь обращается внимание на дополнительные действия, которые вам может потребоваться выполнить. Предупреждения имеют примерно такой вид и содержат информацию, в которой вы предупреждаетесь о возможных последствиях того, что вы не будете следовать инструкциям. Эти опасности могут быть как физическими, связанными с вами или оборудованием, так и не физическими, такими, как безусловное удаление важных файлов. Пример Примеры имеют такой вид и обычно содержат примеры, которым вы должны следовать, или показывают результаты, которые должны получиться при выполнении некоторых действий. Благодарности Я благодарю Sue Blake, Patrick Durusau, Jon Hamilton, Peter Flynn и Christopher Maden, которые выбрали время для чтения ранних черновиков этого документа и дали много ценных замечаний и критики. &chap.overview; &chap.tools; &chap.xml-primer; &chap.xml-markup; &chap.stylesheets; &chap.structure; &chap.doc-build; &chap.the-website; &chap.translations; &chap.writing-style; &chap.psgml-mode; &chap.see-also; &app.examples; &index;