Convertir DO en PDF

Les scripts .do Stata sont généralement enregistrés au format PDF pour la soumission, la révision, l'impression ou l'archivage du code lorsque les destinataires ne doivent pas modifier ni exécuter les commandes. Un PDF préserve la mise en page affichée et s'ouvre sans Stata.

L'extension .do est ambiguë : elle peut également apparaître dans des URL gérées par des applications web Java. Vérifiez le contenu du fichier avant de le convertir ; un script Stata est du texte brut et contient souvent des commandes telles que use, regress, generate ou tabulate.

Qu'est-ce qu'un fichier DO ?

Un do-file Stata est un fichier source en texte brut contenant des commandes Stata, des commentaires, des chemins et des étapes d'analyse. Il est normalement créé dans le Do-file Editor de Stata, mais n'importe quel éditeur de texte peut l'ouvrir.

Un fichier .do contient du code exécutable, et non un format de mise en page. Sa conversion en PDF crée une copie visuelle en lecture seule ; conservez le fichier d'origine, car le PDF ne convient pas à la modification ou à la réexécution de l'analyse.

Si le fichier provient d'une adresse web se terminant par .do, l'extension peut correspondre à un mappage de servlet plutôt qu'au véritable type de fichier. Ouvrez une copie dans un éditeur de texte : le contenu HTML doit être enregistré ou renommé en .html, ouvert dans un navigateur, puis imprimé au format PDF. Un téléchargement contenant une page d'erreur, des données binaires ou aucun contenu exploitable ne peut pas être converti de manière générique sur la base de son extension.

Ce que fournit le PDF

Le PDF stocke une représentation à pages fixes avec le format de page, la disposition des lignes et, éventuellement, les polices incorporées. Il convient à la distribution du code sous forme d'archive stable, à sa jointure à un rapport et à son impression sans modifications de police ou de retour à la ligne causées par l'éditeur du destinataire.

Un PDF d'un do-file contient uniquement le code source. Il n'inclut pas la sortie Stata, les graphiques, les tableaux ou les données, sauf si ces éléments sont exportés séparément.

Convertir un do-file Stata en PDF

L'impression depuis Stata ou un éditeur de texte est la méthode la plus fiable, car elle préserve l'indentation et les commentaires du code tels qu'ils sont affichés.

1. Ouvrez le fichier dans le Do-file Editor de Stata. Si Stata n'est pas disponible, utilisez un éditeur de texte prenant en charge l'impression, tel que Notepad++ sous Windows ou TextEdit sous macOS.
2. Sélectionnez une police à chasse fixe et une taille lisible, généralement de 9 à 11 pt. Désactivez le retour automatique à la ligne si chaque commande doit rester sur une seule ligne source.
3. Utilisez File → Print.
4. Sous Windows, sélectionnez Microsoft Print to PDF. Sous macOS, sélectionnez PDF → Save as PDF dans la boîte de dialogue d'impression. Sous Linux, sélectionnez Print to File et choisissez la sortie PDF, ou utilisez une imprimante PDF installée.
5. Utilisez l'orientation paysage, une police plus petite ou un format de papier plus large si les longues commandes sont renvoyées à la ligne. Enregistrez le résultat sous un nom tel que analysis.pdf.
6. Ouvrez le PDF et vérifiez les sauts de page, l'indentation, les longues lignes et les caractères non ASCII.

Pour une conversion automatisée sur les systèmes où GNU Enscript et Ghostscript sont installés, créez un fichier PostScript et convertissez-le en PDF :

enscript -f Courier10 -o analysis.ps analysis.do
ps2pdf analysis.ps analysis.pdf

Cette méthode peut nécessiter une configuration supplémentaire des polices et de l'encodage pour le texte UTF-8. Testez les caractères accentués ou non latins dans le PDF obtenu.

Conversion en ligne et limites de compatibilité

Les services de conversion de texte en PDF en ligne tels que CloudConvert peuvent être utilisés lorsque l'impression locale n'est pas disponible. Importez une copie renommée de analysis.do en analysis.txt si le service ne reconnaît pas l'extension, sélectionnez la sortie PDF et vérifiez que le résultat utilise une police à chasse fixe et préserve les sauts de ligne.

Ne téléchargez pas vers un convertisseur tiers des scripts contenant des identifiants, des données de participants, des chemins confidentiels, des clés d'API ou des recherches non publiées. L'impression locale au format PDF évite de transférer le fichier source hors de l'appareil.

Utilisez UTF-8 lors de l'enregistrement du do-file et inspectez le PDF sur un autre appareil s'il doit être soumis à l'extérieur. Des polices manquantes ou l'encodage de l'imprimante peuvent remplacer certains caractères, tandis que les longues lignes peuvent être renvoyées visuellement à la ligne, même si le script d'origine reste inchangé.

Pour capturer les résultats de l'analyse, exécutez le do-file et exportez séparément le journal Stata, les graphiques ou les tableaux pertinents. Un do-file imprimé ne peut pas reproduire la sortie générée pendant l'exécution.