"plain text" failid ja nende vormindatud kuvamine

[sips]

Mure järgmine, et mulle meeldib aegajalt igasugu näiteid, õpetusi, töökäike maha märkida *.txt failidesse, et need oleks iga kell ning igas olekus loetavad.
Kuid tekkis väike idee, kas neid tekstifaile oleks võimalik kuidagi viisakalt vormindada ja hiljem "lahedalt" kuvada, kasutades selleks juba olemasolevaid levinud tööriistu?
Et nt terminalis kuvataks kuidagi märgitud pealkirjad paksult? Või lingid joonitaks alla? Jne..

Vahest mingi viki laadne failivorming, mis oleks mõnusalt loetav nii "# cat näide.txt", kui ka "# lahe-kuva näide.txt" varjantide puhul?

[andreas]

POD
"lahe-kuva"="perldoc"

[sips]

Hakkab looma, kuid kahjuks pole päris see (nõuab liigset "markup'i" ja nn lõpp "taage")

alg-"Dokument".txt peaks olema/jääma võimalikult lihtsalt/hästi loetavaks nagu nt mul hetkel eesolev näide:

Kood: Vali kõik

# cat /home/sips/MyDocs/gentoo_uuendus.txt
See dokument ei sisalda juhiseid
Gentoo GNU/Linux'i paigaldamiseks,
vaid näpunäiteid juba paigaldatud
süsteemi hooldamiseks/uuendamiseks.

GCC uuendamine
==============
Uuendame GCC
	# emerge -uav1 gcc
Uuendame GCC profiili
	# gcc-config -l
	 [1] i686-pc-linux-gnu-4.3.1 *
	 [2] i686-pc-linux-gnu-4.3.2
	# gcc-config -f 2
	või
	# gcc-config i686-pc-linux-gnu-4.3.2
Uuendame ümbruskonna ja profiili
	# env-update && source /etc/profile
Taasehitame libtool
	# emerge --oneshot -av libtool
Et oleks täiesti kinde, et kogu süsteem on terve,
tuleb esmalt taasehitada toolchain ja siis kõik teised pakid.
	# emerge -eav system
	# emerge -eav world
Allikas: http://www.gentoo.org/doc/en/gcc-upgrading.xml


"Maailma/süsteemi" taasehitamise
================================
Käivitame taasehitamise
	# emerge -eav--keep-going world
Kui vaja saame ka protsessi katkestada ja hiljem jätkata
	Ctrl+C
Kui kasutusel on baselayout2, siis võiks igaks juhuks uuendada ka
	# emerge -av1 sysvinit openrc
Kui oleme uuendanud xorg-serveri,
siis võiks ka uuendada kõik ohjurid
        # qlist -I -C x11-drivers | xargs emerge -v1
Uuendame seadistuste failid
	# dispatch-conf
Kui kasutusel on nvidia graafika siis
	# eselect opengl set nvidia
Uuendame ümbruskonna ja profiili
	# env-update && source /etc/profile
Katkestatud taasehitamise jätkamine
	# emerge -eav --keep-going world --resume


Kerneli uuendamine
==================
Uuendame lähtekoodi
	# USE="symlink" emerge -avu1 gentoo-sources
Vaatame millised kernelid on paigaldatud
	# eselect kernel list
	Available kernel symlink targets:
	  [1]   linux-2.6.9-gentoo-r1
	  [2]   linux-2.6.9-gentoo-r2
Valime õige kerneli
	# eselect kernel set 2
Kopeerime vana/töötava kerneli seadistused uue kerneli juurde
	# cd /usr/src/linux
	# zcat /proc/config.gz > .config
Seadistame uue kerneli üle
	# make menuconfig
Ehitame kerneli ja selle moodulid
	# make && make modules_install
Kopeerime kerneli /boot kausta
	# mount /boot
	# cp arch/x86_64/boot/bzImage /boot/bzImage-2.6.27-gentoo-r5
Seadistame Grubi
	# nano /boot/grub/grub.conf
	# umount /boot
Taasehitame moodulid
	# emerge @module-rebuild
Taaskäivitame arvuti, et aktiveerida uus kernel.
	# reboot
Kui uus kernel töötab, võib vanad eemaldada
	# emerge -aP gentoo-sources
		või parem oleks
	# emerge -av --depclean
Samuti võib puhastada vana kernaliga seotud asjad kaustadest
	/usr/src/
	/lib/modules/
	/boot
ja eemaldada sissekanded grub.conf'ist
Allikas: http://www.gentoo.org/doc/en/kernel-upgrade.xml


Portage jääkidest puhastamine
=============================
Pakis "gentoolkit" on eclean-dist, mis kustutab
kaustast /usr/portage/distfiles/ ebavajalikuks muutunud lähtekoodid
        # eclean-dist
Kõigi lähtekoodide eemaldamiseks
        # rm -r /usr/portage/distfiles
Ajutiste failide eemaldamine
        # rm -r /var/tmp/portage


Kasutajate haldamine
====================
Kasutaja lisamine
	# useradd -m -g users -G audio,wheel USERNAME
Kasulikud grupid (peale users'i)
	wheel,audio,cdrom,video,games,usb,portage,plugdev
Olemasolevate kasutajate tuvastamine
	# cat /etc/passwd | grep "/home" |cut -d: -f1
	rainer
	guest


USE lipud
=========
euse -i rar
euse -E kde		- enable the given useflags
euse -D gnome		- disable the given useflags

Lingi loomine
=============
Usage: ln [OPTION]... [-T] TARGET LINK_NAME
	~ $ ln -s /home/shared/ ${HOME}/shared
 

GRUBi loomine
=============
Esmalt kopime stage'd oma boot partile
	# monut /boot
	# mkdir /boot/grub
	# cp /lib/grub/i386-pc/* /boot/grub/
Loome lingi boot
	# cd /boot
	# ln -s . boot
Loome menüü faili grub/grub.conf
	# cd /boot/grub
	# nano grub.conf
	# ln -s grub.conf menu.list
Paigalsame GRUB'i MBR'i
	# grub
		grub> root (hd0,0)
		grub> setup (hd0)
		grub> quit


---------------------
Need märkmed kribas Sips

[Sisyphos]

Kui dokument on "plain" siis on ta plain. Mitte natuke "rich".

"Plain texti" vormindad ainult lihtsate t ü h i k u t e, SUURTÄHTEDE ja muue sellisega.

[andreas]

Sama näide POD'iga:

Kood: Vali kõik

=encoding UTF-8

=head1 Gentoo

See dokument ei sisalda juhiseid Gentoo GNU/Linux'i paigaldamiseks, vaid
näpunäiteid juba paigaldatud süsteemi hooldamiseks/uuendamiseks. 

=head1 GCC uuendamine 

Uuendame GCC 

 # emerge -uav1 gcc 

Uuendame GCC profiili 

 # gcc-config -l 
  [1] i686-pc-linux-gnu-4.3.1 * 
  [2] i686-pc-linux-gnu-4.3.2 
 # gcc-config -f 2 

või 

 # gcc-config i686-pc-linux-gnu-4.3.2 

Uuendame ümbruskonna ja profiili 

 # env-update && source /etc/profile 

Taasehitame libtool 

 # emerge --oneshot -av libtool 

Et oleks täiesti kinde, et kogu süsteem on terve, 
tuleb esmalt taasehitada toolchain ja siis kõik teised pakid.

 # emerge -eav system 
 # emerge -eav world 

Allikas: L<http://www.gentoo.org/doc/en/gcc-upgrading.xml>

=head1 "Maailma/süsteemi" taasehitamise 

Käivitame taasehitamise 

 # emerge -eav--keep-going world 

Kui vaja saame ka protsessi katkestada ja hiljem jätkata 

 Ctrl+C 

Kui kasutusel on baselayout2, siis võiks igaks juhuks uuendada ka 

 # emerge -av1 sysvinit openrc 

Kui oleme uuendanud xorg-serveri, siis võiks ka uuendada kõik ohjurid

 # qlist -I -C x11-drivers | xargs emerge -v1 

Uuendame seadistuste failid 

 # dispatch-conf 

Kui kasutusel on nvidia graafika siis 

 # eselect opengl set nvidia 

Uuendame ümbruskonna ja profiili 

 # env-update && source /etc/profile 

Katkestatud taasehitamise jätkamine 

 # emerge -eav --keep-going world --resume 

=head1 Kerneli uuendamine 

Uuendame lähtekoodi 

 # USE="symlink" emerge -avu1 gentoo-sources 

Vaatame millised kernelid on paigaldatud 

 # eselect kernel list 
  Available kernel symlink targets: 
    [1]   linux-2.6.9-gentoo-r1 
    [2]   linux-2.6.9-gentoo-r2 

Valime õige kerneli 

 # eselect kernel set 2 

Kopeerime vana/töötava kerneli seadistused uue kerneli juurde 

 # cd /usr/src/linux 
 # zcat /proc/config.gz > .config 

Seadistame uue kerneli üle 

 # make menuconfig 

Ehitame kerneli ja selle moodulid 

 # make && make modules_install 

Kopeerime kerneli /boot kausta 

 # mount /boot 
 # cp arch/x86_64/boot/bzImage /boot/bzImage-2.6.27-gentoo-r5 

Seadistame Grubi 

 # nano /boot/grub/grub.conf 
 # umount /boot 

Taasehitame moodulid 

 # emerge @module-rebuild 

Taaskäivitame arvuti, et aktiveerida uus kernel. 

 # reboot 

Kui uus kernel töötab, võib vanad eemaldada 

 # emerge -aP gentoo-sources 

või parem oleks 

 # emerge -av --depclean 

Samuti võib puhastada vana kernaliga seotud asjad kaustadest 

 /usr/src/ 
 /lib/modules/ 
 /boot 

ja eemaldada sissekanded grub.conf'ist 

Allikas: L<http://www.gentoo.org/doc/en/kernel-upgrade.xml>

=head1 Portage jääkidest puhastamine 

Pakis "gentoolkit" on eclean-dist, mis kustutab kaustast /usr/portage/distfiles
ebavajalikuks muutunud lähtekoodid 

 # eclean-dist 

Kõigi lähtekoodide eemaldamiseks 
 
 # rm -r /usr/portage/distfiles 

Ajutiste failide eemaldamine 

 # rm -r /var/tmp/portage 

=head1 Kasutajate haldamine 

Kasutaja lisamine

 # useradd -m -g users -G audio,wheel USERNAME 

Kasulikud grupid (peale users'i) 

 wheel,audio,cdrom,video,games,usb,portage,plugdev 

Olemasolevate kasutajate tuvastamine 

 # cat /etc/passwd | grep "/home" |cut -d: -f1 
 rainer 
 guest 

=head1 USE lipud 

 euse -i rar 
 euse -E kde      - enable the given useflags 
 euse -D gnome      - disable the given useflags 

=head1 Lingi loomine 

 Usage: ln [OPTION]... [-T] TARGET LINK_NAME 
   ~ $ ln -s /home/shared/ ${HOME}/shared 

=head1 GRUBi loomine 

Esmalt kopime stage'd oma boot partile 

 # mount /boot 
 # mkdir /boot/grub 
 # cp /lib/grub/i386-pc/* /boot/grub/ 

Loome lingi boot 

 # cd /boot 
 # ln -s . boot 

Loome menüü faili grub/grub.conf 

 # cd /boot/grub 
 # nano grub.conf 
 # ln -s grub.conf menu.list 

Paigalsame GRUB'i MBR'i 
 # grub 
    grub> root (hd0,0) 
    grub> setup (hd0) 
    grub> quit 


Need märkmed kribas Sips
=cut

[Sisyphos]

Võib-olla aitab endale html-meilide saatmisest. Siis on asi kaunilt vormistatud. Ja meililugeja peaks ka alati arvutis käepärast olemas olema.

[z]

Mnjah.

[i]kursiiv[/i] /kursiiv/
[u]allajoonitud[/u] _allajoonitud_
[b]jäme[/b] *jäme*

PEALKIRI
~~~~~~~~

...jne

[rivol]

Mulle meeldib reStructuredText, väga lihtne ja intuitiivne. sips-i näide on juba üsna lähedane sellele.
Lähemalt uurige ise:
http://en.wikipedia.org/wiki/ReStructuredText
http://docutils.sourceforge.net/docs/us ... start.html

[wk]

Mu arust on kõige mõnusam teksti struktureerimise viis vikilaadne (markdown) variant, sellest näiteks HTMLi genereerimiseks on olemas perli tarvis Text::Markdown ja ka muid vahendeid.

http://en.wikipedia.org/wiki/Markdown
http://daringfireball.net/projects/markdown/