AutoLISP Tips and Tricks: creare un file help

Lisp »Tips 'n Tricks »Come creare un file help

E' possibile creare un file di guida che fornisca informazioni relative alle applicazioni o procedure utilizzate. Ecco un esempio di sorgente lisp che visualizza il file di guida helpick.ahp:

(defun c:helpick (/ hlpfil)
   (setq hlpfil "helpick.ahp")
   (acad_helpdlg hlpfil "")
   (princ)
)

A questo punto è necessario creare il file helpick.ahp, questo è solo un esempio:

\#IPE
\$Profilati IPE
\KIPE; profilati IPE
Disegna i profilati a doppio T della serie IPE. 
\#IPN
\$Profilati IPN
\KIPN; profilati IPN
Disegna i profilati a doppio T della serie IPN. 
\#HEA
\$Profilati HEA
\KHEA; profilati HEA
Disegna i profilati a doppio T della serie ad ali
larghe parallele (leggere). 
\#HEB
\$Profilati HEB
\KHEB; profilati HEB
Disegna i profilati a doppio T della serie ad ali
larghe parallele (medie). 
\#HEM
\$profilati HEM
\KHEM; profilati HEM
Disegna i profilati a doppio T della serie ad ali
larghe parallele (pesanti). 
\#UPN
\$Profilati UPN
\KUPN; profilati UPN
Disegna i profilati ad U. 
\#TELAIO
\$Telaio
\KTELAIO
Disegna il telaio di un infisso. 
\E

Il file helpick.ahp è un file ASCII quindi può essere creato con il blocco note di Windows.
Quelle che seguono sono le direttive per la guida di Autocad:

Direttiva	Uso	Dove viene visualizzata
\#	ID argomento	Non è visibile per l'utente della guida, deve essere unica e priva di spazi
\$	Titolo	Elenco cronologia e Cerca Argomento.
\K	Una o più parole chiave	Elenco ricerca. le parole chiave devono essere separate da un punto e virgola.
\E	Fine file	Fine del file. Deve essere usata una sola volta (alla fine del file, ovviamente).
\(spazio)	Commento	Le linee che iniziano con una barra rovesciata, seguite da uno spazio, vengono ignorate, sono commenti al file.

Le prime tre direttive, \#, \$ e \K, devono apparire in quest'ordine.
File .lsp e .ahp devono essere salvati nella stessa cartella, ad esempio in c:\pick\lisp. E' importante sottolineare che il file di guida è realizzato per operare su testo in formato DOS, cioè le linee di testo nel file sorgente devono essere chiuse da una sequenza di ritorno a capo (il tasto Invio).
Dopo ogni direttiva (e relativa istruzione) battere Invio.
Esempio:

\#HEA¶
\$Profilati HEA¶
\KHEA; profilati HEA¶
Disegna i profilati a doppio T della serie ad ali
larghe parallele (leggere).¶

Lisp »Tips 'n Tricks