diff options
author | galaxico <galaxico@quteity.cti> | 2019-07-20 18:43:05 +0300 |
---|---|---|
committer | galaxico <galaxico@quteity.cti> | 2019-07-20 18:43:05 +0300 |
commit | a90144f2110a51e3f16ed42cfb375624528d019d (patch) | |
tree | 1f3103942d6007f067314feb467676a2a379161b /greek/doc | |
parent | 9d015f6aa6e5e81cc0870119f7a01eac70b0a4f5 (diff) |
added doc to Greek files
Diffstat (limited to 'greek/doc')
-rw-r--r-- | greek/doc/Makefile | 1 | ||||
-rw-r--r-- | greek/doc/books.wml | 55 | ||||
-rw-r--r-- | greek/doc/cvs.wml | 2 | ||||
-rw-r--r-- | greek/doc/ddp.wml | 96 | ||||
-rw-r--r-- | greek/doc/devel-manuals.wml | 341 | ||||
-rw-r--r-- | greek/doc/index.wml | 191 | ||||
-rw-r--r-- | greek/doc/misc-manuals.wml | 53 | ||||
-rw-r--r-- | greek/doc/obsolete.wml | 349 | ||||
-rw-r--r-- | greek/doc/todo.wml | 122 | ||||
-rw-r--r-- | greek/doc/topics.wml | 90 | ||||
-rw-r--r-- | greek/doc/user-manuals.wml | 304 | ||||
-rw-r--r-- | greek/doc/vcs.wml | 104 |
12 files changed, 1708 insertions, 0 deletions
diff --git a/greek/doc/Makefile b/greek/doc/Makefile new file mode 100644 index 00000000000..c26323c0c92 --- /dev/null +++ b/greek/doc/Makefile @@ -0,0 +1 @@ +include $(subst webwml/greek,webwml/english,$(CURDIR))/Makefile diff --git a/greek/doc/books.wml b/greek/doc/books.wml new file mode 100644 index 00000000000..a9a452d3e30 --- /dev/null +++ b/greek/doc/books.wml @@ -0,0 +1,55 @@ +#use wml::debian::template title="Debian Books" GEN_TIME="yes" +#include "$(ENGLISHDIR)/doc/books.def" +#use wml::debian::translation-check translation="193117c6582ca2ae3a4f481d2b76ddcaaebf8768" maintainer="galaxico" + +# Greetings translators! +# As you may have noticed, we have changed the system for handling this +# list: from now translation of the blurb of books will be managed with +# gettext through the +# doc.XX.po file (where XX is the code of your language), located at +# webwml/$lang/po directory. +# You can add directly there the translation for the description of +# books, and they will be automagically included in the book list page. +# More information about the translation of PO strings of the website are +# available in the README file at webwml/english/po. For any doubt, +# please contact debian-www@lists.debian.org + +<p> +<langindex name=dutch /> +<langindex name=english /> +<langindex name=french /> +<langindex name=german /> +<langindex name=japanese /> +<langindex name=korean /> +<langindex name=spanish /> +</p> + + +#include "$(ENGLISHDIR)/doc/books.data" + +<h2>Adding new Debian books</h2> + +<p>If you would like to have your book mentioned here, send mail +<strong>in English</strong> to +<<a href="mailto:books@debian.org">books@debian.org</a>>. +<br /> +Please include the following information:</p> +<ul> +<li>Book title,</li> +<li>Author,</li> +<li>Publisher,</li> +<li>Language(s) the book is written in,</li> +<li>A URL to a page describing the book, or at least to the organisation,</li> +<li>Email address for customer enquiries,</li> +<li>What CDs are included with the book, and</li> +<li>A brief description or blurb about the book, around 50 words or so +(<b>in english</b>).</li> +</ul> + +<h2>Removing Debian Books</h2> + +<p>We can remove a book if it uses an unmaintained distribution as +explanation basis (older than oldstable).</p> +<p>You can request the removal of your book too. It's useful if the book +become out of print for example. Please use the method advised in +previous paragraph to contact us.</p> diff --git a/greek/doc/cvs.wml b/greek/doc/cvs.wml new file mode 100644 index 00000000000..2cd21dcf44e --- /dev/null +++ b/greek/doc/cvs.wml @@ -0,0 +1,2 @@ +#use wml::debian::redirect newpage="vcs" +#use wml::debian::translation-check translation="63b253e9f683a3e51632a8be03911a02d53a936e" maintainer="galaxico" diff --git a/greek/doc/ddp.wml b/greek/doc/ddp.wml new file mode 100644 index 00000000000..b19053d4b0a --- /dev/null +++ b/greek/doc/ddp.wml @@ -0,0 +1,96 @@ +#use wml::debian::ddp title="Debian Documentation Project" +#use wml::debian::translation-check translation="66a989955b4ffb2ffa1af62f99ac4b75d99f6cf5" maintainer="galaxico" + +<p>The Debian Documentation Project was formed to coordinate and unify all +efforts to write more and better documentation for the Debian system.</p> + + <h2>DDP Work</h2> +<div class="line"> + <div class="item col50"> + + <h3>Manuals</h3> + <ul> + <li><strong><a href="user-manuals">Users' manuals</a></strong></li> + <li><strong><a href="devel-manuals">Developers' manuals</a></strong></li> + <li><strong><a href="misc-manuals">Miscellaneous manuals</a></strong></li> + <li><strong><a href="#other">Problematic manuals</a></strong></li> + </ul> + + <h3>Current Topics</h3> + <ul> + <li><a href="topics">Topics</a> for discussion or resolution.</li> + + </ul> + + <h3>Todo List</h3> + <ul> + <li><a href="todo">Things that need to be done</a>; volunteers + always appreciated!</li> + <li><a href="todo#ideas">Good and bad ideas</a>, larger issues + that need to be resolved.</li> + </ul> + + </div> + + <div class="item col50 lastcol"> + + <h3>Documentation Policy</h3> + <ul> + <li>Manual licenses comply with DFSG.</li> + <li>We use Docbook XML for our documents.</li> + <li>The sources should be at <a href="https://salsa.debian.org/ddp-team">https://salsa.debian.org/ddp-team</a></li> + <li><tt>www.debian.org/doc/<manual-name></tt> will be the official URL</li> + <li>Every document should be actively maintained.</li> + <li>Please ask on <a href="https://lists.debian.org/debian-doc/">debian-doc</a> if you like to write a new document</li> + </ul> + + <h3>Git Access</h3> + <ul> + <li><a href="vcs">How to access</a> the git repository of the DDP</li> + </ul> + + </div> + + +</div> + +<hr class="clr"> + +<p>Note to Portuguese-speaking users: visit +<a href="http://wiki.debianbrasil.org/">DDP-BR</a>, web pages about +localization of Debian documentation in Brazilian Portuguese language.</p> + +<hr /> + +<h2><a name="other">Problematic manuals</a></h2> + +<p>In addition to the normally advertized manuals, we maintain the following +manuals that +are problematic in one way or another, so we can't recommend them to all +users. Caveat emptor.</p> + +<ul> + <li><a href="obsolete#tutorial">Debian Tutorial</a>, obsoleted by + <a href="obsolete#guide">Debian Guide</a></li> + <li><a href="obsolete#userref">Debian User Reference Manual</a>, + stalled and quite incomplete</li> + <li><a href="obsolete#system">Debian System Administrator's + Manual</a>, stalled, almost empty</li> + <li><a href="obsolete#network">Debian Network Administrator's + Manual</a>, stalled, incomplete</li> + <li><a href="devel-manuals#swprod">How Software Producers can distribute + their products directly in .deb format</a>, stalled, outdated</li> + <li><a href="devel-manuals#packman">Debian Packaging Manual</a>, partly + merged in <a href="devel-manuals#policy">Debian Policy Manual</a>, + the rest will be included in a dpkg reference manual that is yet to be + written</li> + <li><a href="obsolete#makeadeb">Introduction: Making a Debian + Package</a>, obsoleted by + <a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a></li> + <li><a href="obsolete#programmers">Debian Programmers' Manual</a>, + obsoleted by + <a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a> + and + <a href="devel-manuals#debmake-doc">Guide for Debian Maintainers</a></li> + <li><a href="obsolete#repo">Debian Repository HOWTO</a>, outdated after introduction of secure APT</li> +</ul> diff --git a/greek/doc/devel-manuals.wml b/greek/doc/devel-manuals.wml new file mode 100644 index 00000000000..e2cce6be620 --- /dev/null +++ b/greek/doc/devel-manuals.wml @@ -0,0 +1,341 @@ +#use wml::debian::ddp title="Debian Developers' Manuals" +#include "$(ENGLISHDIR)/doc/manuals.defs" +#include "$(ENGLISHDIR)/doc/devel-manuals.defs" +#use wml::debian::translation-check translation="451b03d4fc80b466f5190c24097f4ad0d563e152" maintainer="galaxico" + +<document "Debian Policy Manual" "policy"> + +<div class="centerblock"> +<p> + This manual describes the policy requirements for the Debian GNU/Linux + distribution. This includes the structure and contents of the Debian + archive, several design issues of the operating system, as well as + technical requirements that each package must satisfy to be included + in the distribution. + +<doctable> + <authors "Ian Jackson, Christian Schwarz, David A. Morris"> + <maintainer "The Debian Policy group"> + <status> + ready + </status> + <availability> + <inpackage "debian-policy"> + <inddpsvn-debian-policy> + <p><a href="https://bugs.debian.org/debian-policy">Proposed amendments</a> to Policy + + <p>Supplemental Policy documentation:</p> + <ul> + <li><a href="packaging-manuals/fhs/fhs-3.0.html">Filesystem Hierarchy Standard</a> + [<a href="packaging-manuals/fhs/fhs-3.0.pdf">PDF</a>] + [<a href="packaging-manuals/fhs/fhs-3.0.txt">plain text</a>] + <li><a href="debian-policy/#document-upgrading-checklist">Upgrading checklist</a> + <li><a href="packaging-manuals/virtual-package-names-list.txt">Virtual package names list</a> + <li><a href="packaging-manuals/menu-policy/">Menu policy</a> + [<a href="packaging-manuals/menu-policy/menu-policy.txt.gz">plain text</a>] + <li><a href="packaging-manuals/perl-policy/">Perl policy</a> + [<a href="packaging-manuals/perl-policy/perl-policy.txt.gz">plain text</a>] + <li><a href="packaging-manuals/debconf_specification.html">debconf specification</a> + <li><a href="packaging-manuals/debian-emacs-policy">Emacsen policy</a> + <li><a href="packaging-manuals/java-policy/">Java policy</a> + <li><a href="packaging-manuals/python-policy/">Python policy</a> + <li><a href="packaging-manuals/copyright-format/1.0/">copyright-format specification</a> + </ul> + </availability> +</doctable> +</div> + +<hr> + +<document "Debian Developer's Reference" "devref"> + +<div class="centerblock"> +<p> + This manual describes procedures and resources for Debian maintainers. + It describes how to become a new developer, the upload procedure, how + to handle our bug tracking system, the mailing lists, Internet + servers, etc. + + <p>This manual is thought as a <em>reference manual</em> for all Debian + developers (newbies and old pros). + +<doctable> + <authors "Ian Jackson, Christian Schwarz, Lucas Nussbaum, Raphaël Hertzog, Adam Di Carlo, Andreas Barth"> + <maintainer "Lucas Nussbaum, Hideki Yamane, Holger Levsen"> + <status> + ready + </status> + <availability> + <inpackage "developers-reference"> + <inddpsvn-developers-reference> + </availability> +</doctable> +</div> + +<hr> + +<document "Guide for Debian Maintainers" "debmake-doc"> + +<div class="centerblock"> +<p> +This tutorial document describes the building of the Debian package to ordinary +Debian users and prospective developers using the <code>debmake</code> command. +</p> +<p> +It is focused on the modern packaging style and comes with many simple examples. +</p> +<ul> +<li>POSIX shell script packaging</li> +<li>Python3 script packaging</li> +<li>C with Makefile/Autotools/CMake</li> +<li>multiple binary packages with shared library etc.</li> +</ul> +<p> +This “Guide for Debian Maintainers” can be considered as the successor to the +“Debian New Maintainers’ Guide”. +</p> + +<doctable> + <authors "Osamu Aoki"> + <maintainer "Osamu Aoki"> + <status> + ready + </status> + <availability> + <inpackage "debmake-doc"> + <inddpsvn-debmake-doc> + </availability> +</doctable> +</div> + +<hr> + +<document "Debian New Maintainers' Guide" "maint-guide"> + +<div class="centerblock"> +<p> + This document will try to describe building of a Debian GNU/Linux package + to the common Debian user (and wannabe developer) in common language, and + well covered with working examples. + + <p>Unlike previous attempts, this one is based on <code>debhelper</code> + and the new tools available to maintainers. The author is making every + attempt to incorporate and unify previous efforts. + +<doctable> + <authors "Josip Rodin, Osamu Aoki"> + <maintainer "Osamu Aoki"> + <status> + to be replaced by “Guide for Debian Maintainers” (debmake-doc) + </status> + <availability> + <inpackage "maint-guide"> + <inddpsvn-maint-guide> + </availability> +</doctable> +</div> + +<hr> + +<document "Introduction to Debian packaging" "packaging-tutorial"> + +<div class="centerblock"> +<p> +This tutorial is an introduction to Debian packaging. +It teaches prospective +developers how to modify existing packages, how to create their own packages, +and how to interact with the Debian community. +In addition to the main +tutorial, it includes three practical sessions on modifying the <code>grep</code> +package, and packaging the <code>gnujump</code> game and a Java library. +</p> + +<doctable> + <authors "Lucas Nussbaum"> + <maintainer "Lucas Nussbaum"> + <status> + ready + </status> + <availability> + <inpackage "packaging-tutorial"> + <inddpsvn-packaging-tutorial> + </availability> +</doctable> +</div> + +<hr> + +<document "Debian Menu System" "menu"> + +<div class="centerblock"> +<p> + This manual describes the Debian Menu System and the <strong>menu</strong> + package. + + <p>The menu package was inspired by the install-fvwm2-menu program from + the old fvwm2 package. However, menu tries to provide a more general + interface for menu building. With the update-menus command from this + package, no package needs to be modified for every X window manager again, + and it provides a unified interface for both text- and X-oriented + programs. + +<doctable> + <authors "Joost Witteveen, Joey Hess, Christian Schwarz"> + <maintainer "Joost Witteveen"> + <status> + ready + </status> + <availability> + <inpackage "menu"> + <a href="packaging-manuals/menu.html/">HTML online</a> + </availability> +</doctable> +</div> + +<hr> + +<document "Introduction to i18n" "i18n"> + +<div class="centerblock"> +<p> + This document describes basic idea and howto of l10n (localization), + i18n (internationalization), and m17n (multilingualization) for + programmers and package maintainers. + + <p>The aim of this document is to make more packages support i18n + and to make Debian a more internationalized distribution. + Contributions from all over the world will be welcome, because + the original author is Japanese-speaker and this document would be + on Japanization if there were no contributions. + +<doctable> + <authors "Tomohiro KUBOTA (久保田智広)"> + <maintainer "Tomohiro KUBOTA (久保田智広)"> + <status> + in development + </status> + <availability> + not yet complete + <inddpsvn-intro-i18n> + </availability> +</doctable> +</div> + +<hr> + +<document "Debian XML/SGML Policy" "xml-sgml-policy"> + +<div class="centerblock"> +<p> + Subpolicy for Debian packages that provide and/or make use + of XML or SGML resources. + +<doctable> + <authors "Mark Johnson, Ardo van Rangelrooij, Adam Di Carlo"> + <status> + starting, merging in current SGML policy from <tt>sgml-base-doc</tt> + and new materials for XML catalog management + </status> + <availability> + <inddpsvn-xml-sgml-policy> + </availability> +</doctable> +</div> +<hr> + +<document "How Software Producers can distribute their products directly in .deb format" "swprod"> + +<div class="centerblock"> +<p> + This document is intended as a starting point to explain how software + producers can integrate their products with Debian, what different + situations can arise depending on the license of the products and the + choices of the producers, and what possibilities there are. It does not + explain how to create packages, but it links to documents which do exactly + that. + + <p>You should read this if you are not familiar with the big picture of + creating and distributing Debian packages, and optionally with adding them + to the Debian distribution. + +<doctable> + <authors "Aaron Isotton"> + <maintainer "Aaron Isotton"> + <status> + ready (?) + </status> + <availability> + <inddpsvn-distribute-deb> + </availability> +</doctable> +</div> + +<hr> + +<document "Debian Installer internals" "d-i-internals"> + +<div class="centerblock"> +<p> + This document is intended to make Debian Installer more accessible to new + developers and as a central location to document technical information. + +<doctable> + <authors "Frans Pop"> + <maintainer "Debian Installer team"> + <status> + ready + </status> + <availability> + <p><a href="https://d-i.debian.org/doc/internals/">HTML online</a></p> + <p><a href="https://salsa.debian.org/installer-team/debian-installer/tree/master/doc/devel/internals">DocBook XML source online</a></p> + </availability> +</doctable> +</div> + +<hr> + +<document "dbconfig-common documentation" "dbconfig-common"> + +<div class="centerblock"> +<p> + This document is intended for package maintainers who maintain packages that + require a working database. Instead of implementing the required logic + themselves they can rely on dbconfig-common to ask the right questions during + install, upgrade, reconfigure and deinstall for them and create and fill the + database. + +<doctable> + <authors "Sean Finney and Paul Gevers"> + <maintainer "Paul Gevers"> + <status> + ready + </status> + <availability> + <inpackage "dbconfig-common"> + <inddpsvn-dbconfig-common> + Additional also the <a href="/doc/manuals/dbconfig-common/dbconfig-common-design.html">design document</a> is available. + </availability> +</doctable> +</div> + +<hr> + +<document "dbapp-policy" "dbapp-policy"> + +<div class="centerblock"> +<p> + A proposed policy for packages that depend on a working database. + +<doctable> + <authors "Sean Finney"> + <maintainer "Paul Gevers"> + <status> + draft + </status> + <availability> + <inpackage "dbconfig-common"> + <inddpsvn-dbapp-policy> + </availability> +</doctable> +</div> + diff --git a/greek/doc/index.wml b/greek/doc/index.wml new file mode 100644 index 00000000000..b2f428ad5af --- /dev/null +++ b/greek/doc/index.wml @@ -0,0 +1,191 @@ +#use wml::debian::template title="Documentation" +#use wml::debian::translation-check translation="0c1382aadfb1f9dfa75bd0b8cb402d749a4f0901" maintainer="galaxico" + +<p>An important part of any operating system is documentation, the technical +manuals that describe the operation and use of programs. As part of its efforts +to create a high-quality free operating system, the Debian Project is making +every effort to provide all of its users with proper documentation in an +easily accessible form.</p> + +<h2>Quick start</h2> + +<p>If you are <em>new</em> to Debian we recommend you start first by +reading:</p> + +<ul> + <li><a href="$(HOME)/releases/stable/installmanual">Installation Guide</a></li> + <li><a href="manuals/debian-faq/">Debian GNU/Linux FAQ</a></li> +</ul> + +<p>Do have these at hand when you make your first Debian installation, it +will probably answer many questions and help you work with your new Debian +system. Later you might want to go through:</p> + +<ul> + <li><a href="manuals/debian-handbook/">The Debian Administrator's Handbook</a>, the comprehensive user manual</li> + <li><a href="manuals/debian-reference/">Debian Reference</a>, + a terse user's guide with the focus on the shell command line</li> + <li><a href="$(HOME)/releases/stable/releasenotes">Release Notes</a>, + for people who are upgrading</li> + <li><a href="https://wiki.debian.org/">Debian Wiki</a>, a good source + of information for newcomers</li> +</ul> + + +<p>Finally, make sure you print out and have at hand the <a +href="https://www.debian.org/doc/manuals/refcard/refcard">Debian GNU/Linux Reference +Card</a>, a listing of the most important commands for Debian systems.</p> + +<p>There is a fair bit of other documentation listed below.</p> + +<h2>Types of documentation</h2> + +<p>Most of the documentation included in Debian was written for GNU/Linux +in general. There is also some documentation written specifically for Debian. +These documents come in these basic categories:</p> + +<ul> + <li><a href="#manuals">manuals</a></li> + <li><a href="#howtos">HOWTOs</a></li> + <li><a href="#faqs">FAQs</a></li> + <li><a href="#other">other shorter documents</a></li> +</ul> + +<h3 id="manuals">Manuals</h3> + +<p>The manuals resemble books, because they comprehensively describe major +topics.</p> + +<h3>Manuals specific to Debian</h3> + +<div class="line"> + <div class="item col50"> + + <h4><a href="user-manuals">Users' manuals</a></h4> + <ul> + <li><a href="user-manuals#faq">Debian GNU/Linux FAQ</a></li> + <li><a href="user-manuals#install">Debian Installation Guide</a></li> + <li><a href="user-manuals#relnotes">Debian Release Notes</a></li> + <li><a href="user-manuals#refcard">Debian Reference Card</a></li> + <li><a href="user-manuals#debian-handbook">The Debian Administrator's Handbook</a></li> + <li><a href="user-manuals#quick-reference">Debian Reference</a></li> + <li><a href="user-manuals#securing">Securing Debian Manual</a></li> + <li><a href="user-manuals#aptitude">aptitude user's manual</a></li> + <li><a href="user-manuals#java-faq">Debian GNU/Linux and Java FAQ</a></li> + </ul> + + </div> + + <div class="item col50 lastcol"> + + <h4><a href="devel-manuals">Developers' manuals</a></h4> + <ul> + <li><a href="devel-manuals#policy">Debian Policy Manual</a></li> + <li><a href="devel-manuals#devref">Debian Developer's Reference</a></li> + <li><a href="devel-manuals#debmake-doc">Guide for Debian Maintainers</a></li> + <li><a href="devel-manuals#maint-guide">Debian New Maintainers' Guide</a></li> + <li><a href="devel-manuals#packaging-tutorial">Introduction to Debian packaging</a></li> + <li><a href="devel-manuals#menu">Debian Menu System</a></li> + <li><a href="devel-manuals#i18n">Introduction to i18n</a></li> + <li><a href="devel-manuals#d-i-internals">Debian Installer internals</a></li> + <li><a href="devel-manuals#dbconfig-common">Guide for database using package maintainers</a></li> + <li><a href="devel-manuals#dbapp-policy">Policy for packages using databases</a></li> + </ul> + + <h4><a href="misc-manuals">Miscellaneous manuals</a></h4> + <ul> + <li><a href="misc-manuals#history">Debian Project History</a></li> + <li><a href="misc-manuals#markup">Debiandoc-SGML Markup Manual</a></li> + <li><a href="misc-manuals#sgml-howto">Debian SGML/XML HOWTO</a></li> + </ul> + + </div> + + +</div> + +<p class="clr">The complete list of Debian manuals and other documentation can be found +at the <a href="ddp">Debian Documentation Project</a> web pages.</p> + +<p>There are also several user-oriented manuals written for Debian GNU/Linux, +available as <a href="books">printed books</a>.</p> + +<h3 id="howtos">HOWTOs</h3> + +<p>The <a href="https://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html">HOWTO +documents</a>, like their name says, describe <em>how to</em> do +something, and they usually cover a more specific subject.</p> + + +<h3 id="faqs">FAQs</h3> + +<p>FAQ stands for <em>frequently asked questions</em>. A FAQ is a document +which answers those questions.</p> + +<p>Questions specifically related to Debian are answered in the +<a href="manuals/debian-faq/">Debian FAQ</a>. +There is also a separate <a href="../CD/faq/">FAQ about Debian CD/DVD +images</a>.</p> + + +<h3 id="other">Other, shorter documents</h3> + +<p>The following documents include quicker, shorter instructions:</p> + +<dl> + + <dt><strong><a href="http://www.tldp.org/docs.html#man">manual pages</a></strong></dt> + <dd>Traditionally, all Unix programs are documented with <em>manual + pages</em>, reference manuals made available through the <tt>man</tt> + command. They usually aren't meant for beginners. You can + search for and read the manual pages available in Debian + in <a href="https://manpages.debian.org/cgi-bin/man.cgi">https://manpages.debian.org/</a>. + </dd> + + <dt><strong><a href="https://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html">info files</a></strong></dt> + <dd>Many GNU software is documented through <em>info + files</em> instead of manual pages. These files include detailed + information of the program itself, options and example usage + and are available through the <tt>info</tt> + command. + </dd> + + <dt><strong>various README files</strong></dt> + <dd>The <em>read me</em> files are also common — they are simple text + files that describe a single item, usually a package. You can find + a lot of these in the <tt>/usr/share/doc/</tt> subdirectories on + your Debian system. Each software package has a subdirectory + under it with its own read me files, and might also include + configuration examples. Notice that, for larger programs, documentation + is typically provided in a separate package (same name as the + original package, but ending in <em>-doc</em>). + </dd> + + <dt><strong>quick reference cards</strong></dt> + <dd> + <p>Quick reference cards are very short summaries of a certain + (sub)system. Usually, such a reference card provides the mostly + used commands on a single piece of paper. Some notable reference + cards and collections include:</p> + <dl> + <dt><a href="https://www.debian.org/doc/manuals/refcard/refcard">Debian + GNU/Linux Reference Card</a></dt> + <dd>This card, that can be printed out in a single paper, + provides a list of the most important commands and is + a good reference for new users of Debian that want to + familiarise with them. At least basic knowledge of computer, + files, directories and the command line is required. + Novice users might want to read the + <a href="user-manuals#quick-reference">Debian Reference</a> + first.</dd> + </dl> + </dd> + +</dl> + + +<hrline /> + +<p>If you have checked the above resources and still can't find answers to +your questions or solutions to your problems regarding Debian, take a look +at our <a href="../support">support page</a>.</p> diff --git a/greek/doc/misc-manuals.wml b/greek/doc/misc-manuals.wml new file mode 100644 index 00000000000..6595dec5b50 --- /dev/null +++ b/greek/doc/misc-manuals.wml @@ -0,0 +1,53 @@ +#use wml::debian::ddp title="Debian Miscellaneous Manuals" +#include "$(ENGLISHDIR)/doc/manuals.defs" +#include "$(ENGLISHDIR)/doc/misc-manuals.defs" +#use wml::debian::translation-check translation="0d1d7aa9d7556ad1f2ab9398fb87b5aae3996ccf" maintainer="galaxico" + +<document "Debian Project History" "history"> + +<div class="centerblock"> +<p> + This manual explains the history, the goals and related issues + about the Debian Project. + +<doctable> + <authors "Will Lowe, Martin Schulze, Bdale Garbee"> + <maintainer "Bdale Garbee, Javier Fernández-Sanguino Peña"> + <status> + ready, updated on demand + </status> + <availability> + <inpackage "debian-history"> + <inddpcvs-debian-history> + </availability> +</doctable> +</div> + +<hr> + +<document "DebianDoc-SGML Markup Manual" "markup"> + +<div class="centerblock"> +<p> + Documentation for the <strong>debiandoc-sgml</strong> system, + including best practices and hints for maintainers. Future versions + should includes tips for easier maintenance and building of + documentation in Debian packages, guidelines for organizing + translation of documentation, and other helpful information. + See also <a href="https://bugs.debian.org/43718">bug #43718</a>. + +<doctable> + <authors "Ian Jackson, Ardo van Rangelrooij"> + <maintainer "Ardo van Rangelrooij"> + <status> + ready + </status> + <availability> + <inpackage "debiandoc-sgml-doc"> + <inddpcvs-debiandoc-sgml-doc> + </availability> +</doctable> +</div> + +<hr> + diff --git a/greek/doc/obsolete.wml b/greek/doc/obsolete.wml new file mode 100644 index 00000000000..3777717af31 --- /dev/null +++ b/greek/doc/obsolete.wml @@ -0,0 +1,349 @@ +#use wml::debian::template title="Obsolete Documentation" +#use wml::debian::translation-check translation="4d893897b4eb3554a9a45e45ede6bf2ebff9b25d" maintainer="galaxico" + +#include "$(ENGLISHDIR)/doc/manuals.defs" + +<h1 id="historical">Historical documents</h1> + +<p>The documents listed below were either written a long time ago and +are not up to date or have been written for previous versions of Debian +and have not been updated to current versions. Their information is +outdated, but may still be of interest to some.</p> + +<p>The documents that have lost their relevance and serve no purpose any +more, have had their references removed, but the source code for many of +these obsolete manuals can be found on the +<a href="https://salsa.debian.org/ddp-team/attic">DDP's attic</a>.</p> + + +<h2 id="user">User oriented documentation</h2> + +<document "dselect Documentation for Beginners" "dselect"> + +<div class="centerblock"> +<p> + This file documents dselect for first-time users, and is intended to help + in getting Debian installed successfully. It makes no attempt to explain + everything, so when you first meet dselect, work through the help screens. +</p> +<doctable> + <authors "Stéphane Bortzmeyer"> + <maintainer "(?)"> + <status> + stalled: <a href="https://packages.debian.org/aptitude">aptitude</a> has + replaced dselect as the standard Debian package management interface + </status> + <availability> + <inddpcvs name="dselect-beginner" formats="html txt pdf ps" + langs="ca cs da de en es fr hr it ja pl pt ru sk" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + +<document "User's Guide" "users-guide"> + +<div class="centerblock"> +<p> +This <q>User's Guide</q> is nothing but a reformatted <q>Progeny User's Guide</q>. +Contents are adjusted for the standard Debian system.</p> + +<p>Over 300 pages with a good tutorial to start using the Debian system +from <acronym lang="en" title="Graphical User Interface">GUI</acronym> desktop +and shell command line. +</p> +<doctable> + <authors "Progeny Linux Systems, Inc."> + <maintainer "Osamu Aoki (青木 修)"> + <status> + Useful itself as a tutorial. Written for the woody release, + getting obsolete. + </status> + <availability> +# langs="en" isn't redundant, it adds the needed language suffix to the link + <inddpcvs name="users-guide" index="users-guide" langs="en" formats="html txt pdf" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Tutorial" "tutorial"> + +<div class="centerblock"> +<p> +This manual is for a new Linux user, to help such a user get acquainted +with Linux once they have installed it, or for a new Linux user on a system +which someone else is administering. +</p> +<doctable> + <authors "Havoc Pennington, Oliver Elphick, Ole Tetlie, James Treacy, + Craig Sawyer, Ivan E. Moore II"> + <editors "Havoc Pennington"> + <maintainer "(?)"> + <status> + stalled; incomplete; + probably obsoleted by <a href="user-manuals#quick-reference">Debian Reference</a> + </status> + <availability> + not yet complete + <inddpcvs name="debian-tutorial" cvsname="tutorial"> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian GNU/Linux: Guide to Installation and Usage" "guide"> + +<div class="centerblock"> +<p> + A manual, oriented towards the end-user. +</p> +<doctable> + <authors "John Goerzen, Ossama Othman"> + <editors "John Goerzen"> + <status> + ready (but it is for potato) + </status> + <availability> + <inoldpackage "debian-guide"> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian User Reference Manual" "userref"> + +<div class="centerblock"> +<p> + This manual provides at least an overview of everything a user should know + about their Debian GNU/Linux system (i.e. setting up X, how to configure + network, accessing floppy disks, etc.). It is intended to bridge the gap + between the Debian Tutorial and the detailed manual and info pages + supplied with each package.</p> + + <p>It is also intended to give some idea of how to combine commands, on + the general Unix principle, that <em>there is always more than one way to + do it</em>. +</p> +<doctable> + <authors "Ardo van Rangelrooij, Jason D. Waterman, Havoc Pennington, + Oliver Elphick, Bruce Evry, Karl-Heinz Zimmer"> + <editors "Thalia L. Hooker, Oliver Elphick"> + <maintainer "(?)"> + <status> + stalled and quite incomplete; + probably obsoleted by <a href="user-manuals#quick-reference">Debian Reference</a> + </status> + <availability> + <inddpcvs name="user" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + + +<document "Debian System Administrator's Manual" "system"> + +<div class="centerblock"> +<p> + This document is mentioned in the introduction of the Policy manual. + It covers all system administration aspects of a Debian system. +</p> +<doctable> + <authors "Tapio Lehtonen"> + <maintainer "(?)"> + <status> + stalled; incomplete; + probably obsoleted by <a href="user-manuals#quick-reference">Debian Reference</a> + </status> + <availability> + not yet available + <inddpcvs name="system-administrator" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Network Administrator's Manual" "network"> + +<div class="centerblock"> +<p> + This manual covers all network administration aspects of a Debian system. +</p> +<doctable> + <authors "Ardo van Rangelrooij, Oliver Elphick, Duncan C. Thomson, Ivan E. Moore II"> + <maintainer "(?)"> + <status> + stalled; incomplete; + probably obsoleted by <a href="user-manuals#quick-reference">Debian Reference</a> + </status> + <availability> + not yet available + <inddpcvs name="network-administrator" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + +# Add this to books, there's a revised edition (2nd) @ Amazon +<document "The Linux Cookbook" "linuxcookbook"> + +<div class="centerblock"> +<p> + A hands-on reference guide to the Debian GNU/Linux system that shows, + in over 1,500 <q>recipes</q>, how to use it for everyday activities — from + working with text, images, and sound to productivity and networking + issues. Like the software the book describes, the book is copylefted + and its source data is available. +</p> +<doctable> + <authors "Michael Stutz"> + <status> + published; written for woody, getting obsolete + </status> + <availability> + <inoldpackage "linuxcookbook"> + <p><a href="http://dsl.org/cookbook/">from the author</a> + </availability> +</doctable> +</div> + +<document "APT HOWTO" "apt-howto"> + +<div class="centerblock"> +<p> + This manual tries to be a quick but complete source of information + about the APT system and its features. It contains much information + about the main uses of APT and many examples. +</p> +<doctable> + <authors "Gustavo Noronha Silva"> + <maintainer "Gustavo Noronha Silva"> + <status> + ready + </status> + <availability> + <inpackage "apt-howto"> + <inddpcvs name="apt-howto" langs="en ca cs de es el fr it ja pl pt-br ru uk tr zh-tw zh-cn" + formats="html txt pdf ps" naming="locale" vcstype="attic"/> + </availability> +</doctable> +</div> + + +<h2 id="devel">Developer documentation</h2> + +<document "Introduction: Making a Debian Package" "makeadeb"> + +<div class="centerblock"> +<p> + Introduction on how to create a <code>.deb</code>, using + <strong>debmake</strong>. +</p> +<doctable> + <authors "Jaldhar H. Vyas"> + <status> + stalled, obsoleted by <a href="devel-manuals#maint-guide">New Maintainers' Guide</a> + </status> + <availability> + <a href="https://people.debian.org/~jaldhar/">HTML online</a> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Programmers' Manual" "programmers"> + +<div class="centerblock"> +<p> + Helps new developers to create a package for the Debian GNU/Linux system. +</p> +<doctable> + <authors "Igor Grobman"> + <status> + obsoleted by <a href="devel-manuals#maint-guide">New Maintainers' Guide</a> + </status> + <availability> + <inddpcvs name="programmer" vcstype="attic"> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Packaging Manual" "packman"> + +<div class="centerblock"> +<p> + This manual describes the technical aspects of creating Debian binary + and source packages. It also documents the interface between dselect + and its access method scripts. It does not deal with the Debian + Project policy requirements, and it assumes familiarity with dpkg's + functions from the system administrator's perspective. + +<doctable> + <authors "Ian Jackson, Klee Dienes, David A. Morris, Christian Schwarz"> + <status> + Parts that were de facto policy were merged into + <a href="devel-manuals#policy">debian-policy</a>. + </status> + <availability> + <inoldpackage "packaging-manual"> + </availability> +</doctable> +</div> + +<h2 id="misc">Miscellaneous documentation</h2> + +<document "Debian Repository HOWTO" "repo"> + +<div class="centerblock"> +<p> + This document explains how Debian repositories work, how to create + them, and how to add them to the <tt>sources.list</tt> correctly. +</p> +<doctable> + <authors "Aaron Isotton"> + <maintainer "Aaron Isotton"> + <status> + ready (?) + </status> + <availability> + <inddpcvs name="repository-howto" index="repository-howto" + formats="html" langs="en fr de uk ta" vcstype="attic"> + </availability> +</doctable> +</div> + +<document "Debian SGML/XML HOWTO" "sgml-howto"> + +<div class="centerblock"> +<p> + This HOWTO contains practical information about the use of SGML and XML + on a Debian operating system. + +<doctable> + <authors "Stephane Bortzmeyer"> + <maintainer "Stephane Bortzmeyer"> + <status> + stalled, obsolete + </status> + <availability> + +# English only using index.html, so langs set. + <inddpcvs name="sgml-howto" + formats="html" + srctype="SGML" + vcstype="attic" +/> + </availability> +</doctable> +</div> diff --git a/greek/doc/todo.wml b/greek/doc/todo.wml new file mode 100644 index 00000000000..1949f1f6435 --- /dev/null +++ b/greek/doc/todo.wml @@ -0,0 +1,122 @@ +#use wml::debian::ddp title="Debian Documentation Project (DDP) TODO List" +#use wml::debian::translation-check translation="6fb6b036dd209b63e98e309c29803afec40f7048" maintainer="galaxico" + +<H3>Urgent TO-DO list:</H3> + +<ul> + <li>Ruthless stale documentation reaping. + + <li>Stipulate and document a documentation hierarchy. Basically, complete + the <a href="docpolicy">Documentation Policy</a> document, with the assent + and blessing of the Debian Web team. This involves consistency of file + location in the web area and in packages. There is a draft available + <a href="$(HOME)/doc/manuals/ddp-policy/ch-manuals#s3.5"> + here</A> but needs to be revised yet. + + <li>Add a way to manage translations automatically just as the website's + WML sources are. + + <li>Determine which information should be included in the CD and + <em>automate</em> a method to create the proper index. + Relevant information is <a href="$(HOME)/doc/manuals/ddp-policy/ch-manuals#s3.6">here</A> + and subversion holds some + <a href="https://anonscm.debian.org/viewvc/ddp/utils/scripts/">scripts</a> + that need to be polished and added to a cron job. +</ul> + +<H3>Ideas:</H3> + +<p>The following is just a list of ideas that came up in several threads +on our mailing list. Thus, these may be good and bad ideas. :-) + +<br> + +<ul> + <li> + <p>Provide a consistent interface to all of Debian's manpages, like + many others are doing already like + <a href="http://manpages.ubuntu.com/">Ubuntu</A>, + <a href="https://www.freebsd.org/cgi/man.cgi">FreeBSD</A>, + <a href="http://man.netbsd.org/">NetBSD</A>, + <a href="http://www.openbsd.org/cgi-bin/man.cgi">OpenBSD</A>, + <a href="http://docs.hp.com/hpux/os/man_pages.html">HP (HPUX)</A>, + <a href="http://publib16.boulder.ibm.com/cgi-bin/ds_form?lang=en_US&viewset=AIX">IBM (AIX)</a>, + <a href="http://techpubs.sgi.com/library/tpl/cgi-bin/init.cgi">SGI (Irix)</a>, + and + <a href="http://docs.sun.com/app/docs/doc/816-3930/intdoclist-tbl-343">Sun (Solaris)</a>. + Curiously enough there are several servers (like + <a href="http://www.fifi.org/cgi-bin/man2html">Fifi</a>) are already + providing all of Debian's manpages. + This is Bug <a href="https://bugs.debian.org/264589">#264589</a>. + <p>There is a first beta version available at + <a href="https://manpages.debian.org">manpages.debian.org</A> +# Funny enough, not all Linux distributions provides an official source +# for online search of manpages. Not even Red Hat does this. +# And TLDP points to different unofficial sources including +# http://linux.ctyme.com/ +# jfs + + <li>Implement URN's. This would enable users to check for documentation + locally, on the web site, or on mirrors. Local configuration could be + used to indicate closer or more convenient mirrors or ordering. + <tt>doc-base</tt> could use URNs to point to documents rather than + using file names. + + <li>I thought about what output formats we want to include in the debian + packages (.deb's). We need to include HTML (that's the policy) but + some people may also want to have PostScript or TEXT versions. So I + had the idea of distributing the SGML source _only_ and creating the + formats the user wants to have at runtime (could be installation time + as well as afterwards). This has several advantages: + <ul> + <li>the .debs would be small + <li>greatest flexibility + <li>we could even adjust links when compiling the docs, i.e. replacing + Internet links to local ones if the files are present !!! + <li>it's probably easier to keep an overall index page up-to-date (a la + dwww) + </ul> + The disadvantages I see: + <ul> + <li>people need to have debiandoc-sgml installed (but that's not big) + <li>formatting will take a few seconds (not too much but simply unpackaging + would be faster) + </ul> + <p><tt>doc-base</tt> could define the fundamentals of this type of + system, since it tracks metadata for documents. + + <li>Determine which documents are actually being used (or sought) by our + users so we can focus on them. That's something that has not been yet + investigated. Some sources of information might be the user's mailing + list (conduct a poll), the web log statistics (of both the main www site + and mirrors) and, since documents are also distributed as Debian packages, + the popularity-contest data. + + <li>Generate the information of available manuals presented in the website + by extracting the info (which is provided by <tt>manual.defs</tt> + and <tt>version.defs</tt>) automatically from VCS. + + <li>Make it possible to track translation status based on information from + the VCS site. Consider re-using the framework developed by + the debian-installer for the installation manual. + + <li>Track document 'last-changed' status so that the users browsing the + documents available can determine whether the document applies (or doesn't + apply) to them. + + <li>Consider providing documentation for users in non-english languages + (VCS holds directories for some languages and some documentation originally + written in a language which is not English) + + <li>Consider providing an interactive mechanism for users to annotate + documents through a wiki-like interface, separated from the main presentation + on the website or using the same presentation. This feedback could be used + by document author's and, even if open to abuse, it has worked quite well + for other documentation projects (PHP) + + <li>Have users use a generic bug tracking system for documentation. It + is used for those documents that provide a package but not all documents + do so. + + +</ul> diff --git a/greek/doc/topics.wml b/greek/doc/topics.wml new file mode 100644 index 00000000000..9a26bff2c4a --- /dev/null +++ b/greek/doc/topics.wml @@ -0,0 +1,90 @@ +#use wml::debian::ddp title="Debian Documentation Project (DDP) Current Topics" +#use wml::debian::translation-check translation="bf88db4349aa004897ba419ac204acb62b9e2650" maintainer="galaxico" + +<p>The following issues are under immediate or pressing need for +consideration, discussion, or helpful volunteers. + +<br> + +<ul> + <li><strong>DDP and www.debian.org integration</strong> + <p>Jay Treacy has opened a topic on standardizing file locations for + packages, for the web site, and probably within the DDP. See + <a href="todo">Todo</a> for more information. + <br> + + <li><strong>LDP cooperation</strong> + <p>We need to be more integrated with the LDP project, since we can't do + it alone. Some have stepped forward to package some of the LDP + documents. + <br> + + <li><strong>Making <tt>debiandoc-sgml</tt> safe for Internationalization</strong> + <p>It's not entirely clear yet what has to be done for debiandoc-sgml to + be multi-lingual friendly. Some have started working on a basic + grove-based SGML structure extractor, which helps keep structural + similarity between different translations of one document. We know + that file output naming might need to be changed or post-processed for + documents in content-negotiated web spaces. Other problems need to be + identified. + <br> + + <li><strong>Issues on packaging documentation.</strong> + <p>The question is how document correlate into packages. Having one + package per document has the following advantages: + <ul> + <li>Packages will be small. If a single document is updated, one does + not have to download all documents. + <li>Things are clearer if the package maintainer is the document + maintainer (i.e., author). + <li>One can easily report bugs against documents. + </ul> + but also the following disadvantages: + <ul> + <li>We already have enough packages and some users already complain that + there are too many. + </ul> + + <p>Here is a proposal (which is probably a little obsolete). Current + thinking is that manuals should reside in their own packages, unless the + manuals are very small. The accountability given by the BTS and the + ability to ship new versions without fuss seem to outweigh the minor point + of reducing packages. + + <p>I suggest the following Debian packages: + + <table> + <tr> + <th>Debian Package</th> + <th>Documents</th> + </tr> + <tr valign=top> + <td>debian-doc</td> + <td>META Manual, Hardware Compatibility List, + Installation Manual, Release Notes, + FAQ, Debian Tips, User's Manual, + Debian System Administrators Manual</td> + </tr> + <tr valign=top> + <td>debian-policy</td> + <td>Policy Manual</td> + </tr> + <tr valign=top> + <td>debian-doc-dev</td> + <td>Project Manual, Developers Reference Manual, + Programmer's Manual, Making a Debian Package, Packaging HOWTO, + Documentation Guidelines, How to get started with SGML</td> + </tr> + <tr valign=top> + <td>dpkg-dev</td> + <td>dpkg Reference Manual, dpkg Internals</td> + </tr> + </table> + + <p>Note that I suggest renaming <strong>doc-debian</strong> into + <strong>debian-doc</strong> since I find the latter name much better. + + <p><small>(by Adam Di Carlo (?))</small> + + <p>Do we need any sort of policy statement about this issue? +</ul> diff --git a/greek/doc/user-manuals.wml b/greek/doc/user-manuals.wml new file mode 100644 index 00000000000..8726c5a1f50 --- /dev/null +++ b/greek/doc/user-manuals.wml @@ -0,0 +1,304 @@ +#use wml::debian::ddp title="Debian Users' Manuals" +#include "$(ENGLISHDIR)/doc/manuals.defs" +#include "$(ENGLISHDIR)/doc/user-manuals.defs" +#use wml::debian::translation-check translation="6fb6b036dd209b63e98e309c29803afec40f7048" maintainer="galaxico" + +<document "Debian GNU/Linux FAQ" "faq"> + +<div class="centerblock"> +<p> + Users' Frequently Asked Questions. + +<doctable> + <authors "Susan G. Kleinmann, Sven Rudolph, Santiago Vila, Josip Rodin, Javier Fernández-Sanguino Peña"> + <maintainer "Javier Fernández-Sanguino Peña"> + <status> + ready + </status> + <availability> + <inpackage "debian-faq"><br> + <inddpsvn-debian-faq> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Installation Guide" "install"> + +<div class="centerblock"> +<p> + Installation instructions for the Debian GNU/Linux distribution. + The manual describes the installation process using the Debian Installer, + the installation system for Debian that was first released with + <a href="$(HOME)/releases/sarge/">Sarge</A> (Debian GNU/Linux 3.1).<br> + Additional information related to the installation can be found in the + <a href="https://wiki.debian.org/DebianInstaller/FAQ">Debian Installer FAQ</a> + and the + <a href="https://wiki.debian.org/DebianInstaller">Debian Installer wiki pages</a>. + +<doctable> + <authors "Debian Installer team"> + + <maintainer "Debian Installer team"> + <status> + The manual is not yet perfect. Active work is being done for the current + and future Debian releases. Help is welcome, especially with non-x86 + installation and translations. + Contact + <a href="mailto:debian-boot@lists.debian.org?subject=Install%20Manual">debian-boot@lists.debian.org</a> + for more information. + </status> + <availability> + <insrcpackage "installation-guide"> + <br><br> + <a href="$(HOME)/releases/stable/installmanual">Published version + for the stable release</a> + <br> + Available on the <a href="$(HOME)/CD/">official full CDs and DVDs</a> + in the <tt>/doc/manual/</tt> directory. + <br><br> + <a href="https://d-i.debian.org/manual/">Development version</a> +# <br> +# <a href="$(HOME)/releases/testing/installmanual">Version being prepared +# for the next stable (in testing)</a> + <br> + <inddpsvn-installation-guide> + </availability> +</doctable> + +<p> +Versions of the installation guide for previous releases (and possibly the +next release) of Debian are linked from the <a href="$(HOME)/releases/">release +page</a> for those releases. + +</div> + +<hr /> + +<document "Debian Release Notes" "relnotes"> + +<div class="centerblock"> +<p> + This document contains information on what's new in the current Debian + GNU/Linux distribution and complete upgrading information for users of + older Debian releases. + +<doctable> + <authors "Adam Di Carlo, Bob Hilliard, Josip Rodin, Anne Bezemer, Rob Bradford, Frans Pop, Andreas Barth, Javier Fernández-Sanguino Peña, Steve Langasek"> + <status> + Actively worked upon for Debian releases. + Contact + <a href="mailto:debian-doc@lists.debian.org?subject=Release%20Notes">debian-doc@lists.debian.org</a> + for more information. Problems and patches should be reported as + <a href="https://bugs.debian.org/release-notes">bugs against the + release-notes pseudo-package</a>. + </status> + <availability> + <a href="$(HOME)/releases/stable/releasenotes">Released version</a> + <br> + Available on the <a href="$(HOME)/CD/">official full CDs and DVDs</a> + in the <tt>/doc/release-notes/</tt> directory. +# <br> +# Also available at <a href="$(HOME)/mirror/list">ftp.debian.org and all mirrors</a> +# in the <tt>/debian/doc/release-notes/</tt> directory. +# <br> +# <a href="$(HOME)/releases/testing/releasenotes">Version being prepared +# for the next stable (in testing)</a> + + <inddpsvn-release-notes> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Reference Card" "refcard"> + +<div class="centerblock"> +<p> + This card provides new users of Debian GNU/Linux with the most + important commands in a single page to be used as a reference + when working with Debian GNU/Linux systems. Basic (or better) + knowledge of computers, files, directories and the command line is + required. + +<doctable> + <authors "W. Martin Borgert"> + <maintainer "W. Martin Borgert"> + <status> + published; in active development + </status> + <availability> + <inpackage "debian-refcard"><br> + <inddpsvn-refcard> + </availability> +</doctable> +</div> + +<hr /> + +<document "The Debian Administrator's Handbook" "debian-handbook"> + +<div class="centerblock"> +<p> + The Debian Administrator's Handbook teaches the + essentials to anyone who wants to become an effective and independent Debian + GNU/Linux administrator. + +<doctable> + <authors "Raphaël Hertzog, Roland Mas"> + <status> + Published; in active development + </status> + <availability> + <inpackage "debian-handbook"><br> + <inddpsvn-debian-handbook> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Reference" "quick-reference"> + +<div class="centerblock"> +<p> + This Debian GNU/Linux reference covers many aspects of system + administration through shell-command examples. Basic tutorials, tips, and + other information are provided for topics including system installation, + Debian package management, the Linux kernel under Debian, system tuning, + building a gateway, text editors, VCS, programming, and GnuPG. + + <p>Previously known as "Quick Reference". + +<doctable> + <authors "Osamu Aoki (青木 修)"> + <maintainer "Osamu Aoki (青木 修)"> + <status> + Published; in active development + </status> + <availability> + <inpackage "debian-reference"><br> + <inddpsvn-debian-reference> + </availability> +</doctable> +</div> + +<hr /> + +<document "Securing Debian Manual" "securing"> + +<div class="centerblock"> +<p> + This manual describes the security of the Debian GNU/Linux + operating system and within the Debian project. It starts + with the process of securing and hardening the default Debian GNU/Linux + installation (both manually and automatically), covers some of the + common tasks involved in setting up a secure user and network environment, + gives information on the security tools available, steps to take + before and after a compromise and also describes how security is + enforced in Debian by the security team. The document includes + a step by step hardening guide and within the appendix there + is detailed information on how to setup an intrusion detection + system and a bridge firewall with Debian GNU/Linux. + +<doctable> + <authors "Alexander Reelsen, Javier Fernández-Sanguino Peña"> + <maintainer "Javier Fernández-Sanguino Peña"> + <status> + Published; under development with few changes. Some of its content might not be fully up-to-date. + </status> + <availability> + <inpackage "harden-doc"><br> + <inddpsvn-securing-debian-howto> + </availability> +</doctable> +</div> + +<hr /> + +<document "aptitude user's manual" "aptitude"> + +<div class="centerblock"> +<p> + An introductory guide to the aptitude package manager with the + complete command reference. + + +<doctable> + <authors "Daniel Burrows"> + <status> + Published; in active development + </status> + <availability> + <inpackage "aptitude-doc"><br> + <inddpsvn-aptitude> + </availability> +</doctable> +</div> + +<hr /> + +<document "APT User's Guide" "apt-guide"> + +<div class="centerblock"> +<p> + This document provides an overview of how to use the APT package manager. + + +<doctable> + <authors "Jason Gunthorpe"> + <status> + Published; somewhat stale + </status> + <availability> + <inpackage "apt-doc"><br> + <inddpsvn-apt-guide> + </availability> +</doctable> +</div> + +<hr /> + +<document "Using APT Offline" "apt-offline"> + +<div class="centerblock"> +<p> + This document describes how to use APT in a non-networked environment, + specifically a 'sneaker-net' approach for performing upgrades. + +<doctable> + <authors "Jason Gunthorpe"> + <status> + Published; somewhat stale + </status> + <availability> + <inpackage "apt-doc"><br> + <inddpsvn-apt-offline> + </availability> +</doctable> +</div> + +<hr /> + +<document "Debian Java FAQ" "java-faq"> + +<div class="centerblock"> +<p> +The purpose of this FAQ is to be a place to look for all kind of +questions a developer or user might have regarding Java as far as Debian +is concerned, it includes license issues, development packages available, +and programs related to building a Free Software Java environment. + +<doctable> + <authors "Javier Fernández-Sanguino Peña, Torsten Werner, Niels Thykier, Sylvestre Ledru"> + <status> + Published; in active development although some of its content might not be current. + </status> + <availability> + <inpackage "java-common"><br> + <inddpsvn-debian-java-faq> + </availability> +</doctable> +</div> diff --git a/greek/doc/vcs.wml b/greek/doc/vcs.wml new file mode 100644 index 00000000000..e4ccbb2d60d --- /dev/null +++ b/greek/doc/vcs.wml @@ -0,0 +1,104 @@ +#use wml::debian::ddp title="Debian Documentation Project VCS" +#use wml::debian::toc +#use wml::debian::translation-check translation="63b253e9f683a3e51632a8be03911a02d53a936e" maintainer="galaxico" + +<p>The Debian Documentation Project stores its web pages and much of the +manual text on the Debian Salsa service at +<strong>salsa.debian.org</strong>, which is Debian's GitLab instance. +Please read the <a href="https://wiki.debian.org/Salsa">Salsa documentation</a> +for more information about how this service works. +</p> + +<p>Everybody can download the sources from the Salsa service. Only members of +the Debian Documentation Project can update files.</p> + +<toc-display /> + +<toc-add-entry name="access">Accessing the sources in git</toc-add-entry> + +<p>You can use a web interface to access the files individually and +see changes on each project at +<url "https://salsa.debian.org/ddp-team/" /></p> + +<p>For downloading an entire manual, direct access to the git server +is often a better option. You need the +<tt><a href="https://packages.debian.org/git">git</a></tt> package on your +own machine.</p> + +<h3>Cloning a git repository anonymously (read-only)</h3> + +<p>Use this command to download all the files for one project:</p> + +<p style="margin-left: 2em"> + <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code> +</p> + +<p>Do the same for every project you want to clone locally.</p> + +<h3>Cloning a git repository with push privileges (read-write)</h3> + +<p>Before accessing the git server using this method you have to be +granted write access to it first. Please read how to <a +href="#obtaining">request</a> push permission first.</p> + +<p>Use this command to download all the files for one project:</p> + +<p style="margin-left: 2em"> + <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code> +</p> + +<p>Do the same for every project you want to clone locally.</p> + +<h3>Fetching changes from the remote git repository</h3> + +<p>To update your local copy with any changes made by other people, enter +the <strong>manuals</strong> directory and run the command:</p> + +<p style="margin-left: 2em"> + <code>git pull</code> +</p> + +<toc-add-entry name="obtaining">Obtaining push privileges</toc-add-entry> + +<p>Push privileges are available to anyone who wishes to participate in +writing the manuals. We generally request that you have submitted +a couple of useful patches first.</p> + +<p>After creating your account on <a href="https://salsa.debian.org/">Salsa</a>, +please request push privileges by clicking <q>Request to join</q> on the +group or any of the specific projects under +<url "https://salsa.debian.org/ddp-team/" />. +Please follow it up with an email to debian-doc@lists.debian.org explaining +the track record of your work on Debian.</p> + +<p>Once your request is approved, you'll be part of either the <a +href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q> group</a> or +one of its projects. +</p> + +<hr /> + +<toc-add-entry name="updates">Automatic update mechanism</toc-add-entry> + +<p>The published web pages of the manual text are generated on +www-master.debian.org as part of the regular web site rebuilding process, +which happens every four hours.</p> + +<p>The script does a <kbd>svn export --force svn://svn.debian.org/svn/ddp/manuals</kbd>, and then +<kbd>make -C trunk publish</kbd>.</p> + +<p>The makefile is set up to rebuild each subdirectory (that contains +maintained documentation), and to install the files from each subdirectory +in <code>doc/manuals/</code> subdirectory of the web site. The subdirectory +makefiles are derived from <code>manuals/standard.makefile</code>.</p> + +<p>The documentation files generated by the update script can be found at +<a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p> + +<p>The log files generated by the update script can be found at +<url "https://www-master.debian.org/build-logs/ddp/" /></p> + +<p>Note that this process regenerates the <code>/doc/manuals/</code> +directory. The contents of the <code>/doc/</code> directory is generated +either from <a href="/devel/website/desc">webwml</a> or from other scripts, +such as those which extract certain manuals from their packages.</p> |