OHAZOT.COM(oh)			     LOCAL			OHAZOT.COM(oh)

ohazot - about ohazot.com

OHAZOT
     contents
	     This site contains mainly documents about linux  (mostly
	     Slackware), OpenBSD and terminal programs.
     setup   This site is running on openbsd using httpd.  The documents are
	     written using mdoc using make to run mandoc.
     compatibility
	     This site can be accessed from a graphical browser or text
	     browser.

HOW TO
   curl
     - The site can be accessed from curl to get the text version of the files
     using:
	   https://ohazot.com/:[es/][FILENAME][.oh]

     - If no filename is given, a list of files is displayed.
     - the extension is ommitted but the FILENAME.oh exists, it will be
     displayed.
     - if es/ is added, it will search in Spanish.
     - if the file exists only in English, it will show the English version.
     - if accessed from a web browser it will convert to html.

   Download options
     -	 Use the </downloads/latest.tar.gz>
     -	 Mirror the docs directories.
	       wget --mirror https://ohazot.com

   Local usage
     -	 command line:
	       man -M {PATH_TO_DOWNLOADS}/man -s oh {DOCUMENT}
     -	 OpenBSD
	 -   add to /etc/man.conf : manpath [PATH_TO_DOWNLOADS]/man
     -	 Slackware
	 -   add export MANPATH=${MANPATH}:[PATH_TO_DOWNLOADS]/man
     If added to man.conf or MANPATH, run man -s oh [DOCUMENT]

TODO
     - wip: translate to spanish.

     - next
     -	 improve makefile, add awk script for parsing.
     -	 review old docs.

   docs
     - review and standarize them.
     - add category indexes.
     - review docs and add # or $ accordingly to code lines, depending on
     whether the commands need root.

   manpages
     review manpage site to use:

     - Linux Documentation die.net: https://linux.die.net/ was the original
     one, but requires JS, therefore is not compatible with text browsers.
     Discarded.
     - ArchLinux manpages: https://man.archlinux.org was the next option but
     the manpage for lgogdownloader(oh) cannot be found.
     - ManKier: https://www.mankier.com works on text browsers and has the
     manpage for lgogdownloader. Does not have netpbm manpage, only individual
     packages manpages.
     - manpages.org: https://manpages.org works on text browsers, has
     lgogdownloader and netpbm manpage. Search is off-putting.

   roff macros
     decide whether to use macros on all documents or only mdoc and roff
     related documents for macro definitions reference.

     - pros: simplifies writing the documents.
     - cons: the documents are harder to read when using the file for mdoc
     reference.

   docs
     Add the following docs: apropos(1) , awk(1) (onetrueawk in Slackware) ,
     grep(1) , find(1) , regex , patterns(7) , fdm , SQL , SQLite3 ,
     PostScript , pikchr: https://pikchr.org , (La)TeX , MySQL , GLPI ,
     terminal games , privacy , edbrowse , surfraw , dictd , dwarf fortress ,
     script(1) , thermal printer , ratox: https://ratox.2f30.org , tox chat:
     https://tox.chat , tmux(1) , tor , forth , termux

   protocols
     Check if the following protocols can be added (and add the doc if
     implemented): gopher , ftp(1) , rss .

NOTE
     All docs have the links to their corresponding manpages for programs and
     other related links.  Check OpenBSD manpages: https://man.openbsd.org/
     and ArchLinux manpages: https://man.archlinux.org/man according to your
     needs or the documents for the required distribution.  More information
     can be found in: links(oh) .

SEE ALSO
     history(oh) , openbsd(oh) , roff(oh) , make(oh) , mdoc(oh) , mandoc(oh) ,
     httpd(oh) , ssl(oh) , linux(oh) , slackware(oh) , wget(oh)

AUTHORS
     ohazot(oh) | about(oh) | ohazot.com: https://ohazot.com
     <admin@ohazot.com>

OpenBSD 7.7 linux|  Created:2025-10-03|Updated:2025-11-23|	OHAZOT.COM(oh)