Mettez à jour facilement le chemin vers vos éléments médias externes lorsqu’ils sont déplacés

Vous pouvez choisir comment vos éléments de bibliothèque (images, films, documents, etc.) sont gérés par HelpNDoc: ils peuvent être inclus dans votre projet, ou ils peuvent être inclus de manière dynamique au moment de la génération, lorsque vous décidez de construire les fichiers de votre documentation finale. Lorsque vous utilisez la seconde option, vous indiquez un chemin vers vos éléments médias afin que HelpNDoc puisse les trouver et les inclure lorsque nécessaire. Il est très utile de pouvoir manipuler ces éléments hors de HelpNDoc, comme de les partager avec un logiciel tiers par exemple…
Cependant, un problème peut se présenter si vous devez déplacer ces éléments sur votre disque dur ou le chemin réseau: pour être sûr que HelpNDoc puisse toujours trouver vos éléments médias, il vous faudra tous les mettre à jour manuellement, un par un. Comme cela peut s’avérer une tâche très longue, très fastidieuse et source d’erreurs, c’est une excellente occasion d’utiliser le puissant éditeur de script de HelpNDoc. Voyons comment nous pouvons tirer parti de ce dernier pour mettre à jour rapidement toute la bibliothèque en quelques secondes.

L’éditeur de script de HelpNDoc à la rescousse

Toutes les versions de HelpNDoc incluent l’éditeur de script: vous pouvez l’utiliser pour entrer des instructions depuis l’API HelpNDoc afin d’automatiser les tâches répétitives.

Une fois le projet concerné ouvert, vous devez mettre à jour et lancer l’éditeur de script de HelpNDoc, vous pouvez dès lors commencer à taper le script que nous allons utiliser pour mettre à jour la bibliothèque:

const
  REPLACE_FROM = 'c:\doc';
const
  REPLACE_TO   = 'd:\documentation';

var aList: THndLibraryItemsInfoArray;
var nCnt: Integer;
var sFilePath: string;

begin
  // Get all items in the library
  aList := HndLibraryItems.GetItemList([]);
  // Go through each of them
  for nCnt := 0 to Length(aList) - 1 do
  begin
    // Get its file location
    sFilePath := HndLibraryItems.GetItemUrlFile(aList[nCnt].id);
    // Do we need to replace this one ?
    if ((sFilePath <> '') and (Pos(UpperCase(REPLACE_FROM), UpperCase(sFilePath)) > 0)) then
    begin
      // Yes we do: update the path
      sFilePath := StringReplace(sFilePath, REPLACE_FROM, REPLACE_TO, [rfIgnoreCase]);
      // Save it
      HndLibraryItems.SetItemUrlFile(aList[nCnt].id, sFilePath);
    end;
  end;
end.

Il vous faut simplement remplacer les constantes REPLACE_FROM et REPLACE_TO pour vous assurer que HelpNDoc trouve et remplace les bonnes valeurs, puis cliquez sur “Exécuter le script” et laissez HelpNDoc faire le travail pour vous: en quelques secondes, votre bibliothèque complète sera mise à jour pour que votre nouveau chemin soit utilisé.

Voici comment fonctionne le script:

• Il établit une liste de tous les éléments de bibliothèque présents dans le projet ouvert
• Pour chaque élément, il vérifie s’il est lié à un chemin de fichier qui a besoin d’être mis à jour
• Si c’est le cas, il met à jour le chemin et passe à l’élément suivant

Autres manières de tirer parti de l’API HelpNDoc pour gagner du temps

Presque tous les aspects de HelpNDoc peuvent être automatisés en utilisant l’API HelpNDoc. Nous avons vu comment mettre à jour automatiquement tous les éléments de bibliothèque, mais nous pouvons aussi l’utiliser pour automatiser la création d’aide et de documentation, ou exporter les ID d’aide et numéros de Contexte d’aide pour vos développeurs et bien plus encore…
Vous pouvez consulter la documentation de l’API HelpNDoc pour en savoir plus sur les capacités du puissant éditeur de script de HelpNDoc.

Voir aussi...

L'outil de création d'aide HelpNDoc version 9.1 présente des fonctionnalités révolutionnaires en matière de contenu dynamique

Dans le monde en constante évolution de la documentation et de la rédaction d’aide, l’arrivée de HelpNDoc 9.1 marque une étape importante. Cette dernière mise à jour n’est pas une simple amélioration …

Lire la suite →

L'arme secrète des rédacteurs techniques : les avantages uniques de l'analyseur de caractères de HelpNDoc

HelpNDoc est une solution de choix pour les professionnels qui cherchent à créer une documentation de haute qualité, attrayante et conviviale. Cependant, ce n’est pas seulement son interface …

Lire la suite →

Nouvelles actions FTP, PDF améliorés, surcharge des éléments de bibliothèque, et plus encore dans HelpNDoc 9.0

Nous sommes ravis d’annoncer le lancement de HelpNDoc 9.0, une mise à jour importante qui apporte une foule de nouvelles fonctionnalités et d’améliorations à notre robuste outil de création d’aide. …

Lire la suite →

Obtenir le meilleur de HelpNDoc : Comment la fonctionnalité "Conserver les fichiers temporaires" peut-elle aider les rédacteurs techniques ?

Lorsque l’on travaille sur de la documentation technique, chaque outil et chaque fonctionnalité à notre disposition peut faire une grande différence en termes de productivité et d’efficacité. L’une de …

Lire la suite →