Dwww και όλη η τεκμηρίωση του Debian μαζί σε μια σελίδα

Η τεκμηρίωση στο Unix ξεκίνησε με το σύστημα man, και κάθε UNIX είχε μια εξαιρετική τεκμηρίωση για τα δεδομένα της εποχής. Αλλά όσο ποιο πολύπλοκο γίνονταν το Software τόσο φαίνονταν οι περιορισμοί των man pages.

Και μετά ήρθε το έργο gnu και έφτιαξε το σύστημα info. Εξαιρετικό και αυτό για την εποχή του, από το ίδιο αρχείο έφτιαχνες είτε ένα βιβλίο κανονικό, είτε ένα διαλογικό σύστημα βοήθειας. Αν δεν το ξέρετε δώστε στο τερματικό την εντολή info ή εγκαταστήστε το pinfo.

Για παράδειγμα ας δούμε τo βιβλίo του Bash. Σε αυτή τη σελίδα θα το βρούμε σε διάφορες μορφές μεταξύ των οποίων και σε pdf (κάπου 200 ολόκληρες σελίδες) όλες φτιαγμένες από το ίδιο texinfo source.

Εξαιρετικό σύστημα αλλά φτιάχτηκε πριν την HTML και του φαίνεται. Κανένας σήμερα δεν το αγαπάει. Και δεν έχουμε κάποιο διάδοχο. Κάθε έργο μένει μόνο του να βρει τον δικό του τρόπο. Και οι ανάγκες σήμερα τόσο για τους χρήστες όσο και για τους προγραμματιστές είναι πολύ ποιο πολύπλοκες για να χωρέσουν σε ένα σύστημα. Κάθε πακέτο έχει τουλάχιστον κάποιο αρχείο README, αλλά συχνά έχει πολλά παραπάνω. Παραδείγματα ή και ολόκληρα βιβλία που υπάρχουν σε χωριστό πακέτο γιατί είναι πολύ μεγάλα.

Το θέμα είναι που είναι αυτά και πως θα τα βρούμε. Ναι υπάρχουν κάπου σε κάποιο φάκελο στο `/usr/share/doc’ ή σε κάποιο man page ή στο devhelp ή στο σύστημα βοήθειας ή …

Το Dwww μπορεί να μας βοηθήσει να βρούμε αυτά τα αρχεία και να τα διαβάσουμε σε συστήματα βασισμένα στο Debian :debian: άρα και σε :mint: και :ubuntu:. Δεν είναι τέλειο αλλά συμπληρώνει ότι άλλο χρησιμοποιούμε είτε το devhelp είτε το zeal είτε απλά το google :smirk:

Εγκατάσταση

sudo apt-get install dwww
sudo apt-get install info2www

sudo a2enmod cgi
systemctl restart apache2

Χρήση

Οι παραπάνω εντολές υπονοούν (ή μπορείς απλά να με πιστέψεις) πως είναι ένα πρόγραμμα cgi και τρέχει μέσα απο ενα web server. Απλά πάμε στην σελίδα

xdg-open http://localhost/dwww/

την σελίδα μπορούμε να την κάνουμε bookmark.

2 Likes