Package: odk-ppp
PPPAboutPPP is a project with the purpose of helping people convert XlsForm Excel files into more human-readable, printable formats, commonly called "paper questionnaires". Officially, PPP stands for "Pretty PDF Printer", but other formats are supported. The project consists of...Aweb applicationAcommand line toolBoth tools are open source and free to install. You can also use it online with no installation necessary, athttp://ppp.pma2020.org.SamplesSource Excel file:demo.xlsxConverted to PDF:demo.pdfConverted to DOC:demo.docManually saved as DOCX from DOC:demo.docxConverted to HTML:demo.htmlExample ScreenshotDocumentation for end usersInstallationpip install odk-pppCLIPositional ArgumentsArgumentDescriptionxlsxfilePath to source XLSForm.OptionsShort FlagLong FlagDescription-h--helpShow this help message and exit.-d--debugTurns on debug mode. Currently only works for 'html' format. Only feature of debug mode currently is that it prints a stringified JSON representation of survey to the JavaScript console.-H--highlightTurns on highlighting of various portions of survey components. Useful to assess positioning.-o--outpathPath to write output. If this argument is not supplied, then STDOUT is used. Option Usage:-o OUPATH.-l--languageLanguage to write the paper version in. If not specified, the 'default_language' in the 'settings' worksheet is used. If that is not specified and more than one language is in the XLSForm, the language that comes first alphabetically will be used. Option usage:-l LANGUAGE.-f--formatFile format. HTML and DOC are supported formats. PDF is not supported, but one can easily convert a PPP .doc file into PDF via the use ofwkhtmltopdf(https://wkhtmltopdf.org/). If this flag is not supplied, output is html by default. Option usage:-f {html,doc}.-i--input-replacementAdding this option will toggle replacement of visible choice options in input fields. Instead of the normal choice options, whatever has been placed in the 'ppp_input' field of the XlsForm will be used. This is normally to hide sensitive information.-e--exclusionAdding this option will toggle exclusion of certain survey form components from the rendered form. This can be used to remove ODK-specific implementation elements from the form which are only useful for developers, and can also be used to wholly remove sensitive information without any replacement.-r--hr-relevantAdding this option will toggle display of human readable 'relevant' text, rather than the syntax-heavy codified logic of the original XlsForm.-c--hr-constraintAdding this option will toggle display of human readable 'constraint' text, rather than the syntax- heavy codified logic of the original XlsForm.-C--no-constraintAdding this option will toggle removal of all constraints from the rendered form.-t--text-replacementsAdding this option will toggle text replacements as shown in the 'text_replacements' worksheet of the XlsForm. The most common function of text replacement is to render more human readable variable names, but can also be used to remove sensitive information, or add brevity / clarity where needed.-p--presetSelect from a preset of bundled options. The 'developer' preset renders a form that is the most similar to the original XlsForm. The 'internal' preset is more human readable but is not stripped of sensitive information. The 'public' option is like the 'internal' option, only with sensitive information removed. Option usage:-p {public,internal,developer,standard}.Example Usagepython3 -m  ppp myXlsForm.xlsxPrints HTML converted XlsForm with default settings to the consolepython3 -m  ppp myXlsForm.xlsx -l Français -f doc -p standard > myXlsForm.docConverts an ODK Excel file to a MS Word-readable .doc file (is really HTML under the hood), with the preset of "standard", and the language set to Frenchpython3 -m ppp myXlsForm1.xlsx myXlsForm2.xlsx -l Luganda Lusoga English -f doc pdf -p standard detailedSaves a document for every combination of forms and options passed, in this case2input files *3languages *2file formats *2detail formats, or24output filesDocumentation for developersInstalling and building locallyClone:git clone <url>Install dependencies:cd ppp && pip3 install -r requirements.txtTest to make sure everything's ok:make testPPPA proposPPP est un projet visant à aider les utilisateurs à convertir les fichiers Excel XlsForm en des formats imprimables, plus lisibles par l'homme, appelés communément "questionnaires sur papier". Officiellement, PPP signifie "Pretty PDF Printer", mais d'autres formats sont supportés. Le projet consiste en :une [application Web] (https://github.com/pma-2020/ppp)Un [outil de ligne de commande] (https://github.com/pma-2020/ppp-web)Les deux outils sont open source et gratuits à installer. Vous pouvez également l'utiliser en ligne sans aucune installation nécessaire, à l'adressehttp://ppp.pma2020.org.EchantillonsFichier Excel source: [demo.xlsx] (docs / demo.xlsx)Converti en PDF: [demo.pdf] (docs / demo.pdf)Converti en DOC: [demo.doc] (docs / demo.doc)enregistré manuellement au format DOCX à partir de DOC: [demo.docx] (docs / demo.docx)Converti en HTML: [demo.html] (docs / demo.html)Exemple Capture d’écran! [demo.png] (docs / demo.png)Documentation pour les utilisateurs finauxInstallationpip install odk-pppCLIArguments de positionArgumentDescriptionxlsxfileChemin d'accès à la source XLSForm.OptionsDrapeau courtDrapeau longDescription-h--helpAfficher ce message d'aide et quitter.-d--debugActive le mode débogage. Actuellement, ne fonctionne que pour le format 'html'. La seule caractéristique du mode débogage est qu’il imprime une représentation JSON sous forme de chaîne de sondage sur la console JavaScript.-H--highlightActive la mise en évidence de différentes parties des composants de l’enquête. Utile pour évaluer le positionnement.-o--outpathChemin pour écrire la sortie. Si cet argument n'est pas fourni, STDOUT est utilisé. Options:-o OUPATH.-l--languageLangue dans laquelle écrire la version papier. S'il n'est pas spécifié, le ‘langage’' par défaut’ dans les ‘’settings’’ de la  feuille de calcul  est utilisé. Si cela n'est pas spécifié et qu'il existe plusieurs langues  dans la XLSForm, la langue qui vient en premier par ordre alphabétique sera utilisée. Option:-l LANGUAGE.-f--formatles formats de fichier.HTML et DOC sont des formats pris en charge. PDF n'est pas pris en charge, mais vous pouvez facilement  de convertir un fichier PPP .doc en PDF en utilisantwkhtmltopdf(https://wkhtmltopdf.org/). Si cet indicateur ( flag) n'est pas fourni, la sortie est HTML par défaut. Option-f {html, doc}.-i--input-replacementL'ajout de cette option activera le remplacement des options de choix visibles dans les champs de saisie. Au lieu des options de choix normales, tout ce qui a été placé dans le champ 'ppp_input' du XlsForm sera utilisé. C'est normalement pour cacher les informations sensibles.-e--exclusionL'ajout de cette option activera l'exclusion de certains composants du formulaire d'enquête du formulaire rendu. Cela peut être utilisé pour supprimer du formulaire des éléments d'implémentation spécifiques à ODK qui ne sont utiles que pour les développeurs et peuvent également être utilisés pour supprimer complètement les informations sensibles sans aucun remplacement.-r--hr-relevantL'ajout de cette option activera l'affichage du texte «relevant» lisible par l'homme, plutôt que la logique codifiée , qui exige beaucoup de syntaxe,.-c--hr-contrainteL'ajout de cette option basculera l'affichage du texte de «constraint» lisible par l'homme, plutôt que la logique codée, très lourde en syntaxe du XlsForm d’origine.-C--no-contrainteL'ajout de cette option activera la suppression de toutes les contraintes du formulaire rendu.-t--text-remplacementsL'ajout de cette option basculera les remplacements de texte, comme indiqué dans la feuille de calcul 'text_replacements' du XlsForm. La fonction la plus courante du remplacement de texte consiste à rendre davantage de noms de variables lisibles par l’homme, mais elle peut également être utilisée pour supprimer des informations sensibles ou pour ajouter de la concision / clarté si nécessaire.-p--presetChoisissez parmi un préréglage d'options groupées. Le préréglage 'developer' rend le formulaire le plus similaire possible au XlsForm d'origine. Le préréglage «internal» est plus lisible par l’homme mais n’est pas dépourvu d’informations sensibles. L'option "public" est similaire à l'option "internal", mais sans informations sensibles supprimées. Options:-p {public, internal, developper, standard}.Examples d'usagepython3 -m ppp myXlsForm.xlsxImprime des XlsForm convertis en HTML avec les paramètres par défaut sur la consolepython3 -m ppp mon XlsForm.xlsx -l Français-f doc -p standard> myXlsForm.docConvertit un fichier ODK Excel en un fichier .doc lisible en MS Word (c'est vraiment du HTML sous le capot), avec le préréglage de "standard" et la langue définie au  Françaispython3 -m ppp monXlsForm1.xlsx monXlsForm2.xlsx -l Luganda Lusoga anglais -f doc pdf -p standard détailléEnregistre un document pour chaque combinaison de formulaires et d'options passés, dans ce cas :2fichiers d'entrée *3langues *2formats de fichier *2formats de détail , ou24fichiers de sortieDocumentation pour les développeursInstaller et construire localementClone :git clone <url>Installez les dépendances :cd ppp && pip3 install -r requirements.txtFaites un test pour vous assurer que tout va bien :make test