Ricettario di Alan

Crea nuova cartella `ricettario/`, aggiungi README, un primo esempio
("tintomatic"), e lo script per l'automazione della compilazione ed
esecuzione degli script di comandi per tutti gli esempi. (See #7)

README.md

@@ -39,6 +39,7 @@ Data inizio progetto: 2018/04/13.
 - [Stato del progetto](#stato-del-progetto)
 - [Sostieni il progetto](#sostieni-il-progetto)
 - [Ultime novità](#ultime-novit%C3%A0)
+    - [2019/02/07: Inizio lavori per il "Ricettario di Alan"](#20190207-inizio-lavori-per-il-ricettario-di-alan)
     - [2019/02/05: Modulo per l'italiano indipendente e pronto all'uso](#20190205-modulo-per-litaliano-indipendente-e-pronto-alluso)
     - [2019/02/01: Passaggio a Alan 3.0beta6 build 1866](#20190201-passaggio-a-alan-30beta6-build-1866)
     - [2019/01/24: Passaggio a Alan 3.0beta6 build 1862](#20190124-passaggio-a-alan-30beta6-build-1862)
@@ -213,6 +214,11 @@ Grazie.
 
 Alcune notizie flash sugli aggiornamenti importanti del progetto...
 
+## 2019/02/07: Inizio lavori per il "Ricettario di Alan"
+
+- [`/ricettario/`](./ricettario)
+
+La cartella `ricettario/` conterrà il _Ricettario di Alan_, una collezione organizzata di esempi ispirati a _[The Inform Recipe Book]_, uno dei manuali inclusi con il sistema di sviluppo [Inform 7]. Lo scopo del ricettario sarà fornire esempi pratici e documentati su come sia possibile implementare idee e funzionalità nelle avventure.
 
 ## 2019/02/05: Modulo per l'italiano indipendente e pronto all'uso
 
@@ -314,6 +320,7 @@ Ora restano ancora da tradurre molti messagi di risposta dei verbi, e l'intera l
 - [`/docs/`](./docs) — documentazione HTML della libreria
     + [`hjs`](./docs/hjs) — package customizzato di highlight.js
 - [`/docs_src/`](./docs_src) — cartella sorgenti documentazione in AsciiDoc
+- [`/ricettario/`](./ricettario) — il "Ricettario di Alan" (WIP)
 - [`/test/`](./test) — test suite della libreria
 - [`LICENSE`][License] — Artistic License 2.0
 
@@ -461,6 +468,7 @@ Alan Standard Library:
 
 [programmazione in lingua naturale]: https://en.wikipedia.org/wiki/Natural-language_programming "Vedi la pagina Wikipedia su 'Natural-language_programming'"
 [Inform 7]: http://inform7.com "Visita il sito di Inform 7"
+[The Inform Recipe Book]: http://inform7.com/learn/man/RB_1_1.html "Naviga alla versione online di 'The Inform Recipe Book'"
 
 <!-- Donazione PayPal -->
 

ricettario/AGGIORNA_RICETTE.bat

@@ -0,0 +1,40 @@
+:: -----------------------------------------------------------------------------
+:: AGGIORNA_RICETTE.bat | v0.0.1 | 2019/02/07 | by Tristano Ajmone
+:: -----------------------------------------------------------------------------
+@ECHO OFF & CLS
+:: Code Page 28591 = ISO 8859-1 Latin 1; Western European (ISO)
+CHCP 28591 > nul
+
+FOR %%i IN (*.alan) DO (
+  ECHO ....................................................
+  CALL :CompilaPoiTesta %%i ^
+    || (
+      ECHO Abbandono prematuro dell'esecuzione ...
+      EXIT /B
+    )
+)
+ECHO ....................................................
+ECHO // fine //
+EXIT /B
+
+:CompilaPoiTesta
+
+:: Compila avventura
+ECHO Compila: %1
+
+CALL alan.exe -import ..\alanlib_ita\ %1  > nul 2>&1 ^
+  && (
+    ECHO Testa:   %~n1.a3sol
+    CALL arun.exe -r %~n1.a3c < %~n1.a3sol > %~n1.a3log ^
+      ||(
+        ECHO ^*^*^* TEST FALLITO ^*^*^*
+        EXIT /B 1
+      )
+  ) || (
+    ECHO ^*^*^* COMPILAZIONE FALLITA ^*^*^*
+    ECHO ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    CALL alan.exe -import ..\alanlib_ita\ %1
+    ECHO ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+    EXIT /B 1
+  )
+EXIT /B

ricettario/README.md

@@ -0,0 +1,47 @@
+# Il Ricettario di Alan
+
+Questa cartella è una raccolta di esempi pratici su come implementare vari effetti nelle avventure con Alan Italian e la Libreria Standard.
+
+
+-----
+
+**Indice dei contenuti**
+
+<!-- MarkdownTOC autolink="true" bracket="round" autoanchor="false" lowercase="only_ascii" uri_encoding="true" levels="1,2,3" -->
+
+- [Introduzione](#introduzione)
+- [Ricette](#ricette)
+    - [Tintomatic](#tintomatic)
+
+<!-- /MarkdownTOC -->
+
+-----
+
+# Introduzione
+
+Gli esempi in questa cartella sono ispirati a _[The Inform Recipe Book]_, uno dei manuali inclusi con il sistema di sviluppo [Inform 7]. Lo scopo del ricettario è fornire esempi pratici sui vari modi in cui è possibile implementare determinate idee e funzionalità nelle avventure.
+
+
+# Ricette
+
+## Tintomatic
+
+    Livello: intermedio.
+    Stato:   da ritoccare.
+
+- [`tintomatic.alan`](./tintomatic.alan)
+
+Questo esempio dimostra come modificare dinamicamente il nome stampato di un luogo e la sua descrizione, nonché l'implementazione di "tintomatic", un erogatore di vernice di media complessità.
+
+TODO:
+
+- [ ] randomizza la tinta della vernice erogata.
+
+<!-----------------------------------------------------------------------------
+                               REFERENCE LINKS                                
+------------------------------------------------------------------------------>
+
+[Inform 7]: http://inform7.com "Visita il sito di Inform 7"
+[The Inform Recipe Book]: http://inform7.com/learn/man/RB_1_1.html "Naviga alla versione online di 'The Inform Recipe Book'"
+
+<!-- EOF -->

ricettario/tintomatic.a3log

@@ -0,0 +1,142 @@
+
+
+Tinteggiare 
+Cambiare nome e descrizione di luoghi. 
+(C) Tristano Ajmone, 2019. 
+Avventura realizzata con ALAN Interactive Fiction Language v3.0beta6
+build 1866. 
+Libreria Standard Italiana v2.1 
+Versione 1 
+Tutti i diritti riservati.
+
+
+La stanza bianca
+Se entro mezzogiorno non avrai tinteggiato questa stanza tua moglie si
+infurier�. Al centro della stanza c'� il tintomatic.
+
+> esamina le pareti
+Le pareti sono ancora bianche, se non vuoi grane con tua moglie ti
+conviene tinteggiarle entro mezzogiorno.
+
+> inventario
+Stai portando un rullo.
+
+> esamina il rullo
+� un rullo per tinteggiare le pareti, intonso.
+
+> esamina tintomatic
+Il tintomatic � un miscelatore di tinte casuali per la preparazione di
+idropitture murali a sorpresa. � dotato di un singolo pulsante e una
+vaschetta per la vernice.
+
+> esamina il pulsante
+Esamini il pulsante, ma non noti niente di speciale.
+
+> esamina la vaschetta
+La vaschetta del tintomatic � vuota.
+
+> esamina la vernice
+Qui non puoi vedere nulla del genere.
+
+> tinteggia
+Non c'� vernice nella vaschetta del tintomatic.
+
+> premi il pulsante
+Premi il pulsante e la vaschetta si riempe di vernice rossa.
+
+> esamina la vaschetta
+La vaschetta � piena di vernice rossa.
+
+> esamina la vernice
+La vernice nella vaschetta � rossa.
+
+> tinteggia
+Inzuppi il rullo nella vernice rossa e tinteggi la stanza.
+
+> guarda
+La stanza rossa
+Hai gi� tinteggiato questa stanza una volta, ma pi� guardi le pareti rosse
+, pi� ti convinci che a tua moglie questo colore non piacer�. Al centro
+della stanza c'� il tintomatic.
+
+> esamina le pareti
+Le pareti ora sono rosse.
+
+> esamina il rullo
+Il rullo � coperto di vernice rossa.
+
+> lascia il rullo
+Lasci il rullo.
+
+> premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+Premi il pulsante e la vaschetta si riempe di vernice verde.
+
+La vernice nella vaschetta � verde.
+
+Raccolgi il rullo, lo inzuppi nella vernice verde e tinteggi la stanza.
+
+
+La stanza verde
+Hai gi� tinteggiato questa stanza due volte, ma pi� guardi le pareti verdi
+, pi� ti convinci che a tua moglie questo colore non piacer�. Al centro
+della stanza c'� il tintomatic.
+
+> esamina le pareti POI esamina la vaschetta POI esamina il rullo
+Le pareti ora sono verdi.
+
+La vaschetta del tintomatic � vuota.
+
+Il rullo � coperto di vernice verde.
+
+> premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+Premi il pulsante e la vaschetta si riempe di vernice gialla.
+
+La vernice nella vaschetta � gialla.
+
+Inzuppi il rullo nella vernice gialla e tinteggi la stanza.
+
+
+La stanza gialla
+Hai gi� tinteggiato questa stanza tre volte, ma pi� guardi le pareti 
+gialle, pi� ti convinci che a tua moglie questo colore non piacer�. Al
+centro della stanza c'� il tintomatic.
+
+> esamina le pareti POI esamina la vaschetta POI esamina il rullo
+Le pareti ora sono gialle.
+
+La vaschetta del tintomatic � vuota.
+
+Il rullo � coperto di vernice gialla.
+
+> premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+Premi il pulsante e la vaschetta si riempe di vernice viola.
+
+La vernice nella vaschetta � viola.
+
+Inzuppi il rullo nella vernice viola e tinteggi la stanza.
+
+
+La stanza viola
+Hai gi� tinteggiato questa stanza per ben quattro volte, ma pi� guardi le
+pareti viola, pi� ti convinci che a tua moglie questo colore non piacer�. 
+Al centro della stanza c'� il tintomatic.
+
+> premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+Premi il pulsante e la vaschetta si riempe di vernice blu.
+
+La vernice nella vaschetta � blu.
+
+Inzuppi il rullo nella vernice blu e tinteggi la stanza.
+
+
+La stanza blu
+Hai gi� tinteggiato questa stanza per ben cinque volte, e ora sei
+soddisfatto di come � venuta. Al centro della stanza c'� il tintomatic.
+
+> premi il pulsante
+Ripensandoci, sei soddisfatto dell'attuale colore della stanza, meglio
+lasciar perdere il tintomatic.
+
+> 
+
+Cosa vuoi fare: RESTART, RESTORE, QUIT o UNDO? 

ricettario/tintomatic.a3sol

@@ -0,0 +1,23 @@
+esamina le pareti
+inventario
+esamina il rullo
+esamina tintomatic
+esamina il pulsante
+esamina la vaschetta
+esamina la vernice
+tinteggia
+premi il pulsante
+esamina la vaschetta
+esamina la vernice
+tinteggia
+guarda
+esamina le pareti
+esamina il rullo
+lascia il rullo
+premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+esamina le pareti POI esamina la vaschetta POI esamina il rullo
+premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+esamina le pareti POI esamina la vaschetta POI esamina il rullo
+premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+premi il pulsante POI esamina la vernice POI tinteggia POI guarda
+premi il pulsante