Fusione di progetti HtmlHelp
Argomento successivo</p><p>Argomento precedente  Argomento successivo 

Prima che tu dissezioni in progetti multipli il tuo progetto di 500 pagine accuratamente studiato per favore prenditi qualche istante per esaminare questa esercitazione così potrai capire interamente il concetto.


In questo scenario abbiamo un'agenzia di vacanze che vuole illustrare le sue destinazioni speciali di vacanza che sono categorizzate come "Economiche e allegre" e "Spaventosamente costose". Essi vogliono che la maggior parte dei loro clienti vedano le destinazioni "Economiche e allegre" ma solo alcuni dei loro clienti vorranno vederle entrambe e alcuni vorranno vedere solo le opzioni "Spaventosamente costose". Pertanto essi dovranno creare due progetti come segue:-


Progetto principale

  1. Seleziona "File | Nuovo progetto" e digita un nome per il nuovo progetto quale "Vacanze", un titolo quale "Grandi vacanze" e una cartella a scelta, ma ricorda questa cartella, poiché ne avremo bisogno tra un attimo.
  2. Aggiungi una nuova intestazione e chiamala "Destinazioni economiche e allegre" e due nuovi argomenti sotto di essa chiamati "Iraq" e "Afghanistan"
  3. Seleziona "Progetto | Impostazioni progetto" e marca l'opzione "Questo progetto è parte di un progetto fuso".
  4. Seleziona "Progetto | Opzioni compilatore HtmlHelp" e nella pagina "Generale", marca l'opzione "Crea un indice binario" e togli il segno di spunta dall'opzione "Crea un sommario binario"
                  
  5. Ora compila e guarda cosa hai creato.


Progetto secondario

  1. Seleziona di nuovo "File | Nuovo progetto" e digita un nome per il nuovo progetto quale "SpaventosamenteCostose" (nessuno spazio), un titolo quale "Grandi vacanze" e la stessa cartella usata per il progetto principale. Nota: Puoi scegliere un progetto diverso e poi copiare semplicemente i file compilati nella cartella del progetto principale dopo aver compilato, ma l'uso della stessa cartella elimina questo passaggio.
  2. Aggiungi una nuova intestazione e chiamala "Spaventosamente costose" e due nuovi argomenti sotto di essa chiamati "Hawaii" e "Antartide"
  3. Seleziona "Progetto | Impostazioni progetto" e marca l'opzione "Questo progetto è parte di un progetto fuso".
  4. Seleziona "Progetto | Opzioni compilatore HtmlHelp" e nella pagina "Generale", marca l'opzione "Crea un indice binario", togli il segno di spunta dall'opzione "Crea un sommario binario" e imposta tutte le opzioni esattamente come per il progetto principale. Per ora dovrebbe bastare. Ma è importante considerare che se fai qualsiasi modifica alle impostazioni di uno dei progetti, esse si rifletteranno in tutti gli altri progetti che sono fusi assieme.

    L'inconveniente di avere entrambi i progetti che condividono la stessa cartella è che se crei un argomento che ha la stessa stringa di contesto dell'altro progetto, allora qualunque progetto venga compilato per ultimo sovrascriverà gli argomenti con lo stesso nome nell'altro progetto. In un certo senso ciò ti obbliga a mantenere pagine uniche per ciascun progetto, ma se non vuoi gestire questa situazione, crea cartelle di progetto separate e copia il file di aiuto compilato nella cartella del progetto principale.
  5. Ora compila e osserva il sommario e l'indice.


Fondi i due progetti!

Ora torniamo al progetto principale e aggiungiamo il nostro progetto secondario.


  1. Seleziona "File" e l'ultima voce dovrebbe essere "Vacanze", selezionala e il progetto principale si aprirà.
  2. Ora indicheremo al progetto quali file vogliamo siano fusi assieme. Seleziona "Progetto | Opzioni compilatore HtmlHelp" e fai click sulla pagina "Avanzate", quindi sulla pagina "[Unisci file]" e digita tutti i progetti secondari. Nel nostro scenario digita "SpaventosamenteCostose.chm" e fai click su [OK]



  3. Ora indicheremo al progetto principale di fondere i file del sommario dei progetti secondari. Nella pagina "Testo aiuto", in Sommario, spostati sull'ultima voce e seleziona "Inserisci | Unisci un altro sommario" e digita il nome del progetto compilato seguito da "::/" e il nome file del sommario del progetto secondario, ad es.:-
        SpaventosamenteCostose.chm::/SpaventosamenteCostose.hhc
  4. Ora compila. Dovresti osservare che il sommario del progetto principale mostra ora entrambi i progetti come nella schermata qui sotto. Se controlli l'indice noterai che anch'esso è stato fuso e potrai cercare anche in tutti i progetti secondari. Qualora tu dovessi incontrare qualsiasi problema per favore rivedi di nuovo tutti i passi per vedere cosa non ha funzionato. 



Possibili problemi con la fusione

La versione attuale di Microsoft HtmlHelp v1.4 ha alcuni bug nella fusione. Ti consigliamo di mettere il sommario unito al primo livello dell'albero in Fast-Help, ma noterai che esso è rientrato sotto l'ultima voce del tuo progetto principale. Questo è un bug. Se tenti di mettere il sommario unito a qualsiasi altro livello esso si comporterà in modo irregolare.


Un altro problema riguarda gli spazi nei nomi dei file, la fusione non li gradisce, quindi per favore rinomina i file compilati del tuo progetto secondario in modo che non contengano spazi.