diff options
author | Cem Keylan <cem@ckyln.com> | 2021-02-02 03:39:56 +0300 |
---|---|---|
committer | Cem Keylan <cem@ckyln.com> | 2021-02-02 03:39:56 +0300 |
commit | e7999a032bd888abf3665c501a754dbb922fe7c9 (patch) | |
tree | 9e6fd5104482ba77815a1ed1d591e9ba8167be78 /docs/docs.txt | |
parent | c17e5bd8eb9c0b98b5b6eb9b6cd8f38e2856bb40 (diff) | |
download | website-e7999a032bd888abf3665c501a754dbb922fe7c9.tar.gz |
Switch to org-mode for generating the website
Diffstat (limited to 'docs/docs.txt')
-rw-r--r-- | docs/docs.txt | 105 |
1 files changed, 94 insertions, 11 deletions
diff --git a/docs/docs.txt b/docs/docs.txt index a481cf0..385ad92 100644 --- a/docs/docs.txt +++ b/docs/docs.txt @@ -1,15 +1,98 @@ -Carbs Linux documentation -================================================================================ + _______________ -Welcome to the Carbs Linux source of documentation! You can install these to -your system for viewing offline: + DOCUMENTATION + _______________ - +--------------------------------------------------------------------------+ - | | - | $ cpt-build carbs-docs && cpt-install carbs-docs | - | | - +--------------------------------------------------------------------------+ +Below are sources of documentation regarding Carbs Linux and tools +surrounding it. -Documentation Index --------------------------------------------------------------------------------- + +User Manual +=========== + + Carbs Linux User Manual aims to be a general-purpose explanation of + the distribution, from the installation steps to the style guide of + the project. It can be accessed or otherwise obtained with various + methods: + + +HTML +~~~~ + + You can view the Manual from your browser. The Manual can be viewed as + + - [One HTML page per node] + - [Single HTML page] + + +[One HTML page per node] <file:docs/carbslinux> + +[Single HTML page] <file:docs/carbslinux.html> + + +Plain text +~~~~~~~~~~ + + You can download [carbslinux.txt] in order to view the Manual from + your preferred pager. + + ,---- + | curl -LO https://carbslinux.org/docs/carbslinux.txt + | less carbslinux.txt + `---- + + +[carbslinux.txt] <file:docs/carbslinux.txt> + + +Info +~~~~ + + You can install the `carbs-docs' package and either `texinfo' or + `info' packages to view the Manual offline. + + ,---- + | cpt bi info carbs-docs + | info carbslinux + `---- + + +Source +~~~~~~ + + You can also acquire the source for generating the Manual, which + requires `emacs' for exporting the Org-mode documentation and + `texinfo' for generating html/info pages. + + ,---- + | git clone git://git.carbslinux.org/docs + `---- + + +Installation Instructions +========================= + + Installation Manual is part of the [User Manual], but it can also be + obtained separately: + + - [HTML] + - [Plaintext] + + +[User Manual] See section User Manual + +[HTML] <file:install.org> + +[Plaintext] <file:install.txt> + + +Carbs Packaging Tools +===================== + + The user manual for CPT is not complete yet, but will be released with + the 6.0.0 release. You can see the [repository] in order to check its + status. + + +[repository] <https://github.com/CarbsLinux/cpt> |