seeman - Online în cloud

PROGRAM:

NUME

seetxt/seeman ‐‐ Vizualizator de fișiere text GUI și de pagină manuală ("manpage") pentru X windows.

REZUMAT

seetxt [fișier text] [-x termen de căutare]
seeman [pagina de manual] [secțiunea -s] [termenul de căutare -x]

DESCRIERE

Seetxt și seeman (în mod colectiv: „vezi”) sunt același program, dar numele folosit pentru a-l numi
indică dacă o pagină de manual sau un fișier text obișnuit este în curs de încărcare. Ulterior, cel
numele de invocare este irelevant ‐‐ GUI poate fi întotdeauna folosit pentru a vizualiza ambele tipuri de fișiere.
See menține „meta-datele” documentului în mod independent pentru fiecare utilizator, permițându-vă să păstrați
marcaje și evidențieri pentru fișierele de sistem numai pentru citire (inclusiv paginile manual) într-un mod simplu și
manieră intuitivă. A se vedea, de asemenea, face găsiri stratificate, hiper-linkuri apropo de căutări și poate fi
setați să monitorizeze un fișier existent (cum ar fi un jurnal) pentru modificări.

În mod implicit, vezi rulări în „modul server”: cererile din linia de comandă vor fi trimise la rulare
server, mai degrabă decât să porniți o instanță nouă. Acest lucru ajută la facilitarea integrării cu fișierul
browsere, dintre care majoritatea vă permit să înregistrați o comandă pe care să o utilizați atunci când vizualizați un text
documentului.

See folosește bara de titlu pentru a emite unele mesaje de program. Puteți trage și plasa un fișier text
dintr-o altă fereastră de aplicație în zona de text pentru a o vizualiza (aceasta nu se mută sau nu se copiază
fișierul oriunde și nu se aplică paginilor de manual).

INVOCARE OPŢIUNI

Pentru a începe „vede” (sau pentru a trimite o cerere către serverul existent), utilizați oricare seetxt or seeman,
apoi numele fișierului, apoi orice opțiuni. Numele fișierului trebuie să fie înaintea opțiunilor. Daca nu
nume de fișier este dat, este lansată o nouă instanță a see, chiar dacă există un server care rulează.
Dacă numele fișierului în sine începe cu o liniuță, asigurați-vă că utilizați calea completă sau „./”. Tu
poate vizualiza, de asemenea, paginile manuale în afara căii utilizând calea completă sau „./”. Vezi se va referi
la astfel de pagini (în lista de fișiere etc.) ca aparținând secțiunii „***”.

Toate opțiunile sunt un singur caracter precedat de o liniuță.

-s secțiune
Folosit pentru a indica o secțiune de pagină manuală de utilizat în locul celei implicite, de ex. „Seeman
printf -s 3". Nu utilizați acest lucru cu pagini de manual în afara căii.

-x durată
See va efectua o căutare inițială de text pentru „termen”, evidențiind tot
instanțe. Pentru a căuta o expresie, (adică, un termen care include spații), includeți termenul
între ghilimele.

-v Afișează versiunea. Această documentație este pentru versiunea 0.72.

-h Afișați un mesaj util de „utilizare”.

NOTĂ DESPRE NOI LEGĂTURILE SIMBILE IN FILE CĂI: Dacă încărcați un fișier în directorul de lucru curent
fără cale, see folosește calea reală către acel fișier. Cu toate acestea, dacă și directorul respectiv
legat simbolic și mai târziu încărcați fișierul folosind o cale completă către fișier cu a link simbolic
undeva in aceasta, see va folosi acea cale. Acest lucru contează în ceea ce privește lista de fișiere și
seedata (marcaje/evidențiere), deoarece informațiile respective sunt salvate prin numele fișierului, inclusiv
calea, iar o cale simbolică nu se va potrivi cu „cea reală”.

THE NAVIGATIE BAR AND FILELIST

În stânga sus pe GUI sunt trei butoane: un buton „Înapoi”, un buton care conține numele
fișierul curent și un buton „Înainte”. Butonul din mijloc va prezenta Filelist.
Aceasta este o listă de fișiere vizualizate anterior, în ordinea „ultimul intrat, primul ieşit”. Puteți selecta
un fișier din această listă făcând dublu clic stânga pe el (care mută acel fișier în partea de sus a
lista). De asemenea, puteți utiliza butoanele Înapoi și Înainte, cu sau fără Lista de fișiere
fereastra deschisă, pentru a sări peste listă (fișierele încărcate astfel nu își schimbă poziția).
Când comutați fișierele, ultima poziție a cursorului este înregistrată, astfel încât să puteți comuta înapoi
și mai departe între fișiere și mențineți o poziție a liniei fără a vă deranja să plasați a
marcaj. Aceste informații sunt salvate pentru toate fișierele din listă, chiar și între invocări,
și este împărțit între instanțe. Lista de fișiere este păstrată pe disc și ar trebui să definiți a
locația pentru aceasta în configurația dvs. (vezi mai jos); dacă nu, vedeți va folosi o listă globală
din directorul său de rulare.

Puteți edita manual lista de fișiere de pe disc, dacă doriți. Rețineți că formatul s-a schimbat
între 0.61 și 0.70, iar lista dvs. de fișiere veche nu va fi compatibilă. Pentru a o corecta: toate
numele fișierelor și paginilor de manual trebuie să fie urmate de un |, apoi (secțiunea) din paranteze pentru man
pagini. Opțional, există apoi un $NUM unde „NUM” este un număr întreg – acesta este
poziţia caracterului cursorului la încărcare. Bara în sine (|) este obligatorie, ca și o secțiune
pentru paginile de manual. Veți fi avertizat despre intrări nevalide. Citiți și NOTĂ DESPRE
LEGĂTURILE SIMBILE ÎN CĂILE DE FIȘIER, sub OPȚIUNI DE INVOCARE, mai sus.

JOS COMUNICĂRI AND TEXT INTRARE

Există cinci butoane de comutare în partea de jos a interfeței de vizualizare, dintre care două arată
ca niște luminițe rotunde care clipesc verde când sunt pornite. Faceți clic direct pe lumină pentru a comuta
aceasta. Lumina din stânga activează și oprește serverul (consultați MODUL SERVER, mai jos). Dreapta
lumina setează un ceas pe fișierul curent, ceea ce înseamnă că va fi reîncărcat la un interval de până la
include orice modificări noi. Valoarea implicită pentru acest interval este de zece secunde (consultați CONFIGURARE,
de mai jos).

NOTĂ: Fișierele peste o valoare implicită de 1 Mb nu sunt reîncărcate - sunt cu coadă. Aceasta înseamnă că dacă
dimensiunea fișierului a crescut, o sumă egală cu diferența va fi luată de la final și
adăugată pe afișaj. Funcționează bine dacă „schimbarea” a fost o adăugare la final (cum ar fi
apare cu un jurnal normal). Dar dacă doriți să monitorizați un fișier text foarte mare pentru altele
modificări (aleatorie), va trebui să ajustați limita implicită de 1 Mb, consultați CONFIGURARE. Acest
nu se aplică paginilor de manual. Dacă cursorul se află la sfârșitul unui fișier urmărit, se afișează
ar trebui să rămână acolo chiar dacă fișierul a crescut.

Cele trei butoane din centru, în jurul introducerii de text, sunt comenzi pentru căutarea textului.
Dacă introduceți ceva în text și apăsați Enter, vedeți va efectua un „găsiți tot”
căutarea stilului, evidențiind termenul în galben unde a fost găsit și mutând vizualizarea pentru a include
prima instanta. Acum puteți avansa cursorul la următoarea instanță cu ctrl-n și
înapoi la instanța anterioară cu ctrl‐p. Dacă comutați „împingeți” și introduceți o nouă căutare
termen, toate instanțele ultimei căutări se vor schimba într-o evidențiere violet și la nou
termenul va fi galben. Reîncărcarea sau setarea unui ceas care provoacă reîncărcare va șterge
evidențiază. Nu vă faceți griji, există un istoric al comenzilor, ceea ce facilitează repetarea căutărilor
folosind tastele săgeți din introducerea textului (acest istoric nu este partajat sau salvat între
invocaţii).

În mod normal, căutările nu fac distincție între majuscule și minuscule. Pentru a face căutarea distinge între majuscule și minuscule, comutați
"caz". Pentru a procesa termenul de căutare ca expresie regulată, comutați „regexp” (de exemplu: pentru a găsi
„pentru”, dar nu „foreach”, căutați „\bfor\b” ca expresie regulată). Acestea sunt obișnuite în stil POSIX
expresii, ca și în cazul comenzii „grep”. Se afișează numărul din stânga textului
numărul de cazuri găsite la ultima căutare. Puteți folosi „ctrl-/” pentru a seta focalizarea
introducerea textului în loc să faceți clic pe ea cu mouse-ul.

Există câteva combinații de taste care pot fi utile în navigarea în zona de text: alt-stânga
sau Acasă se mută la începutul unei linii, alt-dreapta sare 27 de caractere o dată, Sfârșit
se deplasează la capătul liniei. Ctrl‐home se mută la începutul documentului,
ctrl-end până la capăt.

PRINCIPAL MENIU

Meniul principal este invocat cu butonul din dreapta atunci când cursorul mouse-ului se află în textul principal
zonă. Toate intrările au macrocomenzi ctrl sau „taste rapide” care funcționează oriunde, dacă este cazul.
Pot exista până la douăzeci de articole în meniu dacă aveți un fișier seedata și „copiați în”
director definit în ~/.seeconfig. Unele elemente (de exemplu, copiere, ajutor, renunțare), sunt
explicative și neincluse aici.

lista de fișiere (ctrl-f)
Aceasta deschide fereastra Filelist (vezi FILELIST mai sus).

vezi marcajele (ctrl-s)
Dacă există semne de carte pentru fișierul curent, acestea vor fi încărcate cu fișierul.
Marcajele sunt afișate ca număr de linie și, pentru a le identifica, primele 31
caractere din rând (dacă linia este goală sau conține mai puțin de 31 de caractere,
două sau mai multe linii de text pot apărea lângă număr). Treci la marcaj prin
făcând dublu clic stânga pe el. Puteți ȘTERGE un marcaj din listă folosind ambele
butoane/buton-3. Marcajele sunt salvate automat pe măsură ce sunt plasate și
sters. Vedeți încarcă marcajele bazate pe calea completă a fișierului (cu excepția
paginile de manual), deci dacă fișierul a fost mutat, marcajele salvate nu vor apărea.
Cu toate acestea, indexul de marcaj utilizat pentru toate fișierele este în sine doar un fișier text simplu
care poate fi editat cu ușurință dacă este necesar (vezi CONFIGURARE, mai jos). Este nevoie de
că aveți un fișier „seedata” definit în configurația dvs.

plasați marcaj (ctrl-m)
Adăugați un nou marcaj pentru linia care conține cursorul text. Marcajele sunt
salvat automat (dacă aveți un fișier seedata).

reîncărcare (ctrl-l)
Aceasta actualizează afișajul pentru a reflecta starea curentă a fișierului. Cu fișierele terminate
1 MB, fișierul este „coadă” (vezi NOTĂ în secțiunea anterioară), ceea ce este util pentru
jurnalele lungi, etc. Pentru a reîncărca efectiv întregul fișier (dacă este atât de mare), utilizați
lista de fișiere (primul fișier din lista de fișiere este întotdeauna ultimul fișier încărcat). The
cursorul și vizualizarea vor reveni la același număr de linie ca înainte (care poate sau nu
fie aceeași linie, evident), cu excepția cazului în care acesta este un fișier mare „coadă”, caz în care
priveliștea se mută până la capăt.

căutare apropo (ctrl-a)
Listați rezultatele unei căutări „apropos” pentru paginile de manual în zona principală de text, folosind
orice termen se află în textul de jos. Numele paginilor individuale sunt duble
subliniat verde și hyper-linked. Faceți dublu clic stânga pentru a afișa pagina.

(anul) liniile numerice (ctrl-3)
Adăugați sau eliminați numerele de rând din stânga. Numerele liniilor sunt disponibile numai pe fișiere
cu mai puțin de 100000 de linii. Când efectuați căutări pe fișiere mai lungi de zece
mie de linii, se recomandă să dezactivați mai întâi numerotarea liniilor.

albastru aldine (ctrl-h)
Acest lucru aplică o etichetă „albastru aldine” textului selectat curent. Acest marcaj va
apare din nou în see ori de câte ori încărcați acest fișier (dacă calea este aceeași), până când
îl „dezetichetezi”.

roșu italic (alt-r)
Aplică o etichetă „rosu italic” textului selectat curent. Ce tocmai s-a spus
despre roșu italic este la fel de adevărat și cu albastrul îndrăzneț.

deetichetare (ctrl-u)
Elimină orice etichetare/marcare din textul selectat curent. Sfat: atunci când deetichetați,
utilizați o bandă decentă în jurul etichetei pe care doriți să o eliminați în cazul în care există spațiu alb
inclus. Acest lucru poate părea irelevant, dar dacă fișierul se modifică și aveți grupuri de
unul sau două caractere albe evidențiate accidental, acele evidențieri „ascunse”.
va apărea brusc. Ele pot fi, de asemenea, confuze în fișierul seedata (vezi
CONFIGURARE, mai jos).

modul wrap (ctrl-w)
Vă oferă trei opțiuni pentru a întrerupe linii mai lungi decât afișajul: fără înfășurare, înfășurare
pe cuvânt sau exact. Valoarea implicită este wrap on word.

trimite la editor (ctrl-e)
Aceasta emite o comandă definită de utilizator pentru a trimite fișierul la un editor de text. Personal
fav: „vim ‐‐remote”. Cu toate acestea, deoarece majoritatea instalărilor *nix nu au vim
compilat în acest fel, implicit este „gedit”. Vezi CONFIGURARE, mai jos.

copiați (ctrl-o)
Aceasta va apărea dacă aveți un director valid „copiere în” definit în dvs
~/.seeconfig fişier. Ia orice se află în intrarea de text ca nume pentru fișier
și copiază conținutul buffer-ului de text în acest fișier, cu calea „copy-to”.
atașat (puteți include subdirectoare). Dacă tamponul conține un fișier text, fișierul
fișierul nou va fi o copie exactă. Dacă ați selectat text, vedeți va include numai
textul selectat în noul fișier, astfel încât să puteți salva o parte din buffer mai degrabă decât
totul. Copierea este cea mai utilă în combinație cu următoarea opțiune...

executa (ctrl-x)
Aceasta execută orice se află în intrarea de text ca o comandă prin intermediul shell-ului și se imprimă
rezultatul în vizualizarea text. See menține afișajul actualizat până la comandă
iesirile. Nu puteți interacționa și acest lucru nu este cu adevărat destinat utilizării ca consolă.
Totuși, ceea ce puteți face este să aplicați o comandă conținutului buffer-ului de text ca și cum
era un fișier, folosind „SEEBUF” în loc de nume de fișier (de fapt, acesta este scris
într-un fișier temporar). De exemplu: dacă doriți să vedeți numai liniile din buffer
care conține cuvântul „cuvânt”, tastați „cuvântul grep SEEBUF”; acest lucru va șterge afișajul
și imprimați rezultatul ca și cum afișajul anterior ar fi un fișier pe care tocmai l-ați grepit. Dacă
ați selectat text pe afișaj, vedeți va folosi doar textul selectat pentru
SEEBUF. Puteți salva rezultatele utilizând „copiere” de mai sus și, de fapt, această opțiune
va apărea în meniu numai dacă aveți un director „copiere în” definit (vezi
CONFIGURARE). În mod implicit, consultați redirecționarea stderr către afișaj. Dacă pentru unii
motiv pentru care nu doriți acest lucru, setați „fără redirecționare” (consultați din nou CONFIGURARE). Tu la fel
obțineți valoarea returnată (de obicei 0) în bara de titlu.

reconfigurare (F2)
Acesta reprocesează fișierul de configurare (~./seeconfig) și vă arată fișierul
Ecranul „Configurare” din nou. Modificările geometriei prin „dimensiuni:” pot să nu ia
loc până când reporni vezi.

SERVER MODE

Singura modalitate de a încărca un fișier nou într-o instanță care rulează a see (cu excepția cazului în care se află în fișierul „fișier
list", de mai sus) este să utilizați drag n' drop, o căutare adecvată (pentru pagini de manual) sau serverul.

„Modul server” vă permite să trimiteți comenzi de la distanță pentru a vedea, în primul rând pentru a putea fi
incluse în meniul utilizatorului unui browser de fișiere, operate de o altă aplicație sau
operate dintr-o linie de comandă. EXEMPLU: Pentru a utiliza see cu browserul de fișiere nautilus al GNOME,
faceți clic pe „deschide cu” pe un fișier text în nautilus, selectați o comandă personalizată și tastați „seetxt”.
De acum înainte, nautilus vă va oferi opțiunea de a vizualiza fișiere text cu seetxt.

În timp ce serverul rulează, o lumină verde din stânga va clipi și orice comandă
invocarea liniei care include un nume de fișier sau o pagină de manual va merge la ea (inclusiv solicitările
din alte aplicații, cum ar fi browserul de fișiere). Majoritatea browserelor web funcționează în acest fel – dacă
dați clic pe un link din clientul dvs. de e-mail, acesta va apărea în browserul web care rulează și
nu lansați altul.

Serverul folosește un socket local care este implicit ~/.seesock dar poate fi setat în
Fișier de configurare. Dacă serverul refuză să pornească dintr-un motiv oarecare, renunțați să vedeți și ștergeți
acest fișier socket (ar trebui să existe numai când rulează un server).

Poate exista un singur server care rulează o dată. Puteți opri serverul făcând clic
indicatorul intermitent din partea stângă a interfeței.

CONFIGURARE

See nu necesită nicio configurație pentru a funcționa, deși fără ea este posibil să nu poți
utilizați toate caracteristicile. Un exemplu de fișier de configurare este instalat în
INSTALLDIR/share/seetxt‐runtime (INSTALLDIR este setat la momentul construirii, probabil / Usr / local if
ai construit din sursă și nu ai ales nimic diferit, sau / usr daca ai instalat de la
un pachet prefabricat). Copiați .seeconfig în directorul dvs. de acasă și adaptați-l la dvs
are nevoie. Numele câmpurilor nu țin seama de majuscule și minuscule, iar liniile care încep cu # sunt ignorate.
Configurația poate afecta următoarele:

· „font text” de exemplu, „font text: helvetica 12”

· „dimensiuni” de exemplu, „dimensiuni: 1200 800”. Acestea sunt dimensiunile zonei de text în
pixeli.

· confirmarea încărcării fișierului: în mod normal, see vă solicită să confirmați când urmează să fie un fișier nou
încărcat. Puteți sări peste acest lucru incluzând „fără confirmare” pe o linie în sine.

· „seedata:” aceasta este locația unui fișier text pentru a stoca marcajele și marcajele. De ex.
„seedata: /home/user/seedata”. NU UTILIZAȚI TILDE (~). Puteți edita datele seedate
fișier, dar aveți grijă să urmați structura de acolo: paginile de manual necesită un număr de secțiune
în paranteze. Versiunile anterioare 0.70 nu necesitau acest lucru și poate fi necesar să adăugați
secțiunea manual dacă marcajele pentru o pagină nu se încarcă cu versiunea 0.70+.
După aceea, există o listă de numere de linii separate prin asterisc pentru marcaje. The
primul număr este numărul de marcaje. Apoi poate exista un „R” (pentru roșu) și sau
„B” (pentru albastru), cu mai multe numere întregi separate prin asterisc. Acestea sunt perechi de caractere
pozițiile (început și sfârșit) pentru evidențieri. De exemplu, încercați să introduceți acest lucru în dvs
fișier seedata:

seetxt(1)*2*143*263*B*15226*15269*R*15464*15659*

Cu sau fără un fișier de configurare, prima dată când utilizați see, va crea un seedata
fișier pentru dvs. (implicit la ~/.seedata). Acesta este singurul fișier permanent
creat automat în directorul dvs. de pornire. Citiți, de asemenea, NOTĂ DESPRE LEGĂTURILE SIMBILE ÎN
FILE PATHS sub OPȚIUNI DE INVOCARE, mai sus.

· „filelist:” aceasta este locația unui fișier text pentru a păstra istoricul fișierelor vizualizate
in. Este implicit la INSTALLDIR/share/seetxt‐runtime/filelist, care este world
citit/scris. Mai multe instanțe de see pot partaja aceeași listă de fișiere; nu este
blocat sau ținut deschis.

· „seesocket:” o cale și un nume de utilizat ca socket pentru server; implicit este
~/.seesock (din nou, nu folosiți o tilde). Lungimea completă a acestui nume de cale nu poate fi
mai mult de 106 caractere (aceasta este o limitare a socket-urilor Unix locale). NU FACE
DE fapt, CREAȚI ACEST FIȘIER.

· „interval de urmărire:” este numărul de secunde dintre actualizări când un fișier este „vizionat”
(folosind comutatorul intermitent din partea dreaptă, vezi COMBUTARE ȘI INTERFAȚĂ, mai sus); implicit
este de zece secunde. Lumina clipește cu o rată constantă, fără a avea legătură cu timpul de vizionare.

· „background:” setează culoarea de fundal a zonei de text (de exemplu, „background: CornflowerBlue”).
Evidențierile textului utilizate de see (roșu, albastru, verde și cyan) sunt destul de mari
contrast, dar dacă doriți să ajustați fundalul din orice motiv, alegeți o culoare din
/usr/share/X11/rgb.txt (cu excepția celor cu spații în nume) sau utilizați RGB hexbyte
format (de exemplu, #ffffff).

· „coada la:” stabilește limita de dimensiune a fișierului la care să se folosească „coada” mai degrabă decât a
reîncărcare completă, în octeți. (de exemplu, „coada la: 5000000”). Valoarea implicită este 1000000. A se vedea
NOTĂ la începutul COMBUTĂRII DE JOS, de mai sus.

· „copy to:” este un director în care să plasați fișiere dintr-o operațiune de „copy out” (vezi
MENIU PRINCIPAL de mai sus). De exemplu, „copiați pe: /home/user/Desktop”. Dacă nu aveți o copie către
director, nu puteți efectua nicio copiere.

· redirecționare stderr cu opțiunea de meniu „execute” (vezi mai sus). Pentru a transforma stderr
redirecționare dezactivată, includeți „fără redirecționare” pe o linie în sine.

· „editor:” setează o comandă a editorului de utilizat (de exemplu, „editor: vim ‐‐remote”); vezi MENIU PRINCIPAL
mai sus pentru o explicație mai detaliată.

Valorile incorecte din fișierul dvs. .seeconfig pot cauza o defecțiune o_O

ERORI

Majoritatea mesajelor de eroare, fie în bara de titlu, fie în pop-up, ar trebui să se explice de la sine.

Citire scurtă pe dosar
Acest lucru se poate întâmpla dacă încercați să încărcați un fișier non-text, deoarece see se va opri la zero
octet, ceea ce înseamnă că cantitatea de text citită este mai mică decât lungimea reală a fișierului.

Nu s-a putut crea fișierul temporar
See vă folosește directorul principal pentru două fișiere temporare posibile de foarte scurtă durată,
.seeTMP și .seeTP (acestea nu trebuie lăsate niciodată în urmă ca gunoi și puteți șterge
ele dacă le găsești). Fără permisiunea de a face acest lucru, funcționalitatea va fi
redusă.

Nu se poate actualiza lista de fișiere! (Eroarea #3)
Acest lucru se va întâmpla numai dacă see este capabil să citească lista de fișiere, dar nu să scrie în ea. În
în acest caz, fie trebuie să modificați/adăugați intrarea „filelist:” în ~/.seeconfig or
au permisiunea de a scrie fișierul. Lista implicită de fișiere la nivel de sistem ar trebui
au fost setat modul 666 la instalare; dacă nu, administratorul de sistem trebuie să o facă
„chmod 666” lista de fișiere.

Nu se poate valida textul (Eroarea #4)
Există un caracter non-utf8 (ceva care nu poate fi imprimat) în fișierul dvs.

Fara memorie
Computerul tău nu va rămâne niciodată fără memorie, promit.

DREPTURI DE AUTOR

Drepturi de autor (C) 2008, 2009, 2010 Mark Thomas Eriksen. Se acordă permisiunea de a copia,
distribuiți și/sau modificați acest document în conformitate cu termenii Documentației libere GNU
Licență, versiunea 1.3 sau orice versiune ulterioară publicată de Free Software Foundation
(http://www.gnu.org/licenses/fdl.html).

Vizitați pagina de pornire seetxt: http://seetxt.sf.net

Utilizați seeman online folosind serviciile onworks.net