{"id":23069082,"url":"https://github.com/ccamel/generator-latex-mail","last_synced_at":"2026-05-05T23:32:54.564Z","repository":{"id":57247748,"uuid":"78333279","full_name":"ccamel/generator-latex-mail","owner":"ccamel","description":":envelope: A Yeoman template for scaffolding LaTeX administrative mails (in french format)","archived":false,"fork":false,"pushed_at":"2024-02-29T20:22:56.000Z","size":297,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2025-08-09T06:51:38.544Z","etag":null,"topics":["generator","gulp","latex","letter","pdf","xelatex","yeoman"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ccamel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-01-08T09:28:07.000Z","updated_at":"2025-01-07T01:40:06.000Z","dependencies_parsed_at":"2024-12-16T06:12:59.406Z","dependency_job_id":"70a81df2-6ee8-4a72-b8f7-26e44fbc1062","html_url":"https://github.com/ccamel/generator-latex-mail","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ccamel/generator-latex-mail","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccamel%2Fgenerator-latex-mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccamel%2Fgenerator-latex-mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccamel%2Fgenerator-latex-mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccamel%2Fgenerator-latex-mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ccamel","download_url":"https://codeload.github.com/ccamel/generator-latex-mail/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ccamel%2Fgenerator-latex-mail/sbom","scorecard":{"id":268852,"data":{"date":"2025-08-11","repo":{"name":"github.com/ccamel/generator-latex-mail","commit":"6e10b4c0b9aac84b2b0e20f4b96ad67115866cd3"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.5,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":0,"reason":"Found 0/10 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 4 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T12:51:37.102Z","repository_id":57247748,"created_at":"2025-08-17T12:51:37.102Z","updated_at":"2025-08-17T12:51:37.102Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32672664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["generator","gulp","latex","letter","pdf","xelatex","yeoman"],"created_at":"2024-12-16T06:12:54.220Z","updated_at":"2026-05-05T23:32:54.547Z","avatar_url":"https://github.com/ccamel.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"generator-latex-mail\n====================\n[![Yeoman](https://img.shields.io/badge/generator-yeoman-5aadbb.svg?style=flat)](http://yeoman.io)\n[![Npm](https://img.shields.io/npm/v/generator-latex-mail.svg)](https://www.npmjs.com/package/generator-latex-mail)\n[![LaTex](https://img.shields.io/badge/language-LaTex-7cad22.svg?style=flat)](https://www.latex-project.org)\n[![Apache-2.0](https://img.shields.io/badge/licence-Apache--2.0-lightgrey.svg?style=flat)](http://www.apache.org/licenses/LICENSE-2.0)\n[![Build Status](https://travis-ci.org/ccamel/generator-latex-mail.svg?branch=develop)](https://travis-ci.org/ccamel/generator-latex-mail)\n\n\u003e A [Yeoman] template for scaffolding [LaTeX] administrative mails (in french format)\n\n## Features\n\n * Scaffolds a _workspace_ where all latex resources lay in\n * Manages _institute_ files which hold the identity of the senders\n * Generates nice default [LaTex] _letters_ using the [letter.cls](https://www.ctan.org/tex-archive/macros/latex/contrib/lettre) LaTeX class, with following features:\n    * support generation for Registered Letters (*Lettres recommandées*)\n    * automatically set the letter date to the current date\n    * support the link to an institute (previously created)\n\n[![icon-screenshot](doc/assets/icon-screenshot.png) letter-example.pdf](doc/samples/letter.pdf)\n\n## Why ?\n\n![what ! latex for writing letters ?](doc/assets/what.gif \"What ! Latex ? For letters ?\")\n\nYes ! This is what I personally use; mainly because:\n\n- [LaTex] is free, portable, flexible, sexy and produces very high quality documents.\n- I'm a coder and I just can't imagine using a [WYSIWYG](https://en.wikipedia.org/wiki/WYSIWYG) editor for writing something.\n\n## Installation\n\n##### Prerequisites\n\nSo you want to play with it. I assume the following is already installed:\n\n- [node.js]\n- [Yeoman]\n- [LaTex] - (more precisely [XeLaTeX])\n \n To install [XeLaTeX], I would suggest you to use [TexLive] core or full package. But you are free to use any other distribution. \n You can have a look to [my environment under Arch](doc/latex-environment.md).\n\n##### Project\n\nInstall [generator-latex-mail] using [npm]:\n\n```bash\nnpm install -g generator-latex-mail\n```\n\nAlternately you can install the module directly from sources. You will need [git] for that.\n\n```bash\ngit clone https://github.com/ccamel/generator-latex-mail.git\ncd generator-latex-mail\nnpm link\n```\n\n## Getting started\n\n### Create the workspace\n\nBefore anything else, you need to create a workspace. For that, you just have to invoke the [latex-mail generator](generators/app/index.js#L20) with [yeoman] and let you guide.\n\n```bash\nyo latex-mail\n```\n\nYou will be asked to answer a few questions.\n\n```\n? What is the name of the workspace you want to create ? mails\n```\n\nAs a result, you will get the following directory structure.\n\n```\n[workspace]                     # folder created by template\n   ├── assets                   # contains all resources used by LaTex\n   │   ├── fonts                # contains alternative fonts\n   │   └── institutes           # contains the institutes\n   │       └── default.ins\n   ├── letters                  # contains all the letters\n   │   └── letter.tex\n   ├── outputs                  # contains all the pdf generated from the letters\n   │   └── letter.pdf\n   ├── temp                     # folder containing temporary files\n   ├── gulp.js                  # the gulp file used to process tex files\n   └─  package.json             # npm dependencies used by gulp\n\n```\n\n### Create an institute\n\nAn institute is a LaTex file containing the information about the sender of a letter, like the name, the address, the phone number.\n\nThe creation of an institute is performed with the `institute` sub-generator.\n\n```bash\nyo latex-mail:institute\n```\n\nYou will be asked to answer a few questions.\n\n```\n? What is the name of the institute (a file that describes the sender) default\n? Full name John Doe\n? Address 1 10 rue de la Pomme\n? Address 2 \n? City Paris\n? Zipcode 75010\n? Phone 06 01 02 03 04\n? Email john.doe@yopmail.com\n   create assets/institutes/default.ins\n```\n\nAs a result, you will get the new institute file in the `assets/institutes` folder. You can of course freely modify it to\nadapt it to your needs.\n\n### Create a new letter\n\nCreating a new letter is fairly simple, thanks to the `letter` sub-generator.\n\n```bash\nyo latex-mail:letter\n```\n\nYou will be asked to answer a few questions.\n\n```\n? Name of the letter (without extension) letter\n? What institute do you want yo use ? default\n? Subject of the letter Réclamation\n? Does the letter a Registered Letter or not (If 'yes', a special mention is added to the subject of the letter). Yes\n```\n\nAs a result, you will get the new letter file in the `letters` folder. Modify it with the editor of your choice.\n\n### Make PDF\n\nI use [XeLaTex] which is a TeX typesetting engine with support of Unicode and modern font technologies.\n\nThe process is driven by [Gulp] which is a streaming build system. The pipeline generation is as such:\n\n```\n  letters/*.tex -\u003e [XelaTex] -\u003e outputs/*.pdf\n```\n\nThe process is idempotent: only letters that have been modified since last generation are built again.\n\nTo launch the process, just invoke the [Gulp] `default` task:\n\n```\ngulp\n```\n\n## Samples\n\n[Sample PDF](doc/samples/letter.pdf)\n\n## Technologies\n\n[![Yeoman-logo][Yeoman-logo]][Yeoman] [![Gulp-logo][Gulp-logo]][Gulp] [![LaTex-logo][LaTex-logo]][LaTex]\n\n## Useful links\n\n - [écrire des lettres en latex (zestedesavoir.com)](https://zestedesavoir.com/tutoriels/508/ecrire-des-lettres-en-latex/)\n - [lettres en latex (www.tuteurs.ens.fr)](http://www.tuteurs.ens.fr/logiciels/latex/lettre.html)\n\n## License\n\n[Apache-2.0] © [Christophe Camel]\n\n[Christophe Camel]: https://github.com/ccamel\n[Apache-2.0]: http://www.apache.org/licenses/LICENSE-2.0\n[LaTex]: https://www.latex-project.org/\n[LaTeX-logo]: doc/assets/logo-LaTex.png\n[XeLaTex]: https://en.wikipedia.org/wiki/XeTeX\n[TexLive]: http://www.tug.org/texlive/\n[Yeoman]: http://yeoman.io/\n[Yeoman-logo]: doc/assets/logo-Yeoman.png\n[Gulp]: http://gulpjs.com/\n[Gulp-logo]: doc/assets/logo-Gulp-2x.png\n[node.js]: https://nodejs.org/\n[npm]: https://www.npmjs.com/\n[git]: https://git-scm.com/\n[generator-latex-mail]: https://github.com/ccamel/generator-latex-mail\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccamel%2Fgenerator-latex-mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fccamel%2Fgenerator-latex-mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fccamel%2Fgenerator-latex-mail/lists"}