Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bankkroll/repo2pdf
repo2pdf is a tool that allows you to convert a GitHub repository into a PDF file. It clones the repository, processes the files, and then creates a PDF.
https://github.com/bankkroll/repo2pdf
github langchain langchain-js pdf repository
Last synced: about 1 month ago
JSON representation
repo2pdf is a tool that allows you to convert a GitHub repository into a PDF file. It clones the repository, processes the files, and then creates a PDF.
- Host: GitHub
- URL: https://github.com/bankkroll/repo2pdf
- Owner: BankkRoll
- License: mit
- Created: 2023-05-22T02:45:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-02T18:59:12.000Z (about 1 year ago)
- Last Synced: 2024-04-14T04:26:17.466Z (9 months ago)
- Topics: github, langchain, langchain-js, pdf, repository
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/repo2pdf
- Size: 247 KB
- Stars: 125
- Watchers: 3
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# repo2pdf
#### NPM: https://www.npmjs.com/package/repo2pdf
#### Website: https://repo2pdf.site
repo2pdf is an innovative and versatile tool designed to seamlessly transform GitHub repositories into well-formatted, visually engaging, and easy-to-navigate PDF files. By automating the process of cloning repositories and parsing code files, repo2pdf serves a variety of use-cases including teaching, code reviews, offline referencing, archiving, AI training, and document embedding. The tool's flexibility expands the horizons of interacting with codebases by bridging the gap between the dynamic world of coding and the static, universally accessible format of PDFs, catering to a multitude of user needs and creative applications.
- [repo2pdf](#repo2pdf)
- [Installation and Usage](#installation-and-usage)
- [Installing and Using repo2pdf with NPX](#installing-and-using-repo2pdf-with-npx)
- [Installing and Using repo2pdf by Cloning the Repository](#installing-and-using-repo2pdf-by-cloning-the-repository)
- [Configuration](#configuration)
- [Example of file structure](#example-of-file-structure)
- [Troubleshooting / FAQ](#troubleshooting--faq)
- [Contributing to repo2pdf](#contributing-to-repo2pdf)
- [Reporting Bugs](#reporting-bugs)
- [Suggesting Enhancements](#suggesting-enhancements)
- [Writing Code](#writing-code)
- [Meet Our Contributors](#meet-our-contributors)
- [License](#license)
- [Star History](#star-history)
---
## Installation and Usage
repo2pdf can be installed by either [directly using NPX](#installing-and-using-repo2pdf-with-npx) or [cloning the repository from GitHub](#installing-and-using-repo2pdf-by-cloning-the-repository). The steps and prompts vary based on the chosen method.
> NEW! Use the webapp [here](https://repo2pdf.site)
---
### Installing and Using repo2pdf with NPX
This method downloads and installs the latest version of repo2pdf from the NPM registry.
1. Install repo2pdf using NPX:
```shell
npx repo2pdf
```
2. The script will start running. Follow the prompt and provide the necessary information.
- GitHub repository URL
- Output file name
- Decision on whether to keep the cloned repository (Y/N)
---
### Installing and Using repo2pdf by Cloning the Repository
This method involves manually cloning the repo2pdf repository and setting it up on your local machine.
1. Clone the repository:
```shell
git clone https://github.com/BankkRoll/repo2pdf
```
2. Navigate to the repo2pdf directory:
```shell
cd repo2pdf
```
3. Install the dependencies:
```shell
npm install
```
4. Build the script:
```shell
npm run build
```
5. Run the script:
```shell
npm start
```
6. The script will start running. Follow the prompt and provide the necessary information:
- Decision on whether to clone a repository or use a local repository
- If using a local repository, provide the path
- If cloning a repository, provide the URL
- Features checklist for
- add line numbers in the PDF
- add page numbers in the PDF
- add highlighting in the PDF
- remove comments from the code
- remove empty lines from the code
- one file or one PDF per file
- Name of the output PDF file or output directory
- Decision on whether to keep the cloned repository after generating the PDF
Please note that you need to have Node > 18 and git(for non-local repos) installed on your system in order to run repo2pdf.
---
## Configuration
repo2pdf automatically ignores certain file types and directories (e.g., `.png`, `.git`).
To customize the files and directories to ignore, you can add a `repo2pdf.ignore` file to the root of your repository.
Please note that if you use a local repository, the `repo2pdf.ignore` file must be in the root of the repository directory. And you might need to add more directories to the ignore list, as the script does not automatically ignores different build files and directories.
### Example of file structure
```json
{
"ignoredFiles": ["tsconfig.json", "dist", "node_modules"],
"ignoredExtensions": [".raw"]
}
```
---
## Troubleshooting / FAQ
Q: I'm getting an error "Failed to install [package-name]". What should I do?
A: Make sure you have Node.js and npm installed on your system. Try running the following command to install the required package manually:
```shell
npm install [package-name]
```
Q: How can I customize the styling of the generated PDF?
A: You can modify the code in `clone.ts` or `syntax.ts` to change the font, font size, colors, and other styling options for the PDF document.
```typescript
// Example: Changing font size in syntax.ts
doc.fontSize(12);
```
Q: What types of files are supported for conversion to PDF?
A: Currently, repo2pdf supports all text-based files for conversion to PDF. Binary files like images or compiled binaries are ignored.
Q: How can I modify the ignored files list?
A: You can add a `repo2pdf.ignore` file to the root of your repository to customize the list of ignored files. Here's an example of how to structure this file:
```json
{
"ignoredFiles": ["tsconfig.json"],
"ignoredExtensions": [".md"]
}
```
Q: How can I include line numbers in the generated PDF?
A: During the execution of the script, you'll be prompted with the question "Include line numbers?". Answering 'Y' will include line numbers in the generated PDF.
Q: How can I keep the cloned repository after generating the PDF?
A: You'll be asked "Keep cloned repository?" during the script execution. Answer 'Y' to keep the cloned repository on your system after the PDF is generated.
Q: How can I generate a PDF for a local repository?
A: When running the script, you'll be asked to either clone a repository or use a local one. Choose the latter and provide the local repository path.
---
## Contributing to repo2pdf
**Your insights, skills, and valuable time can make a huge difference in the evolution of repo2pdf!** We're always excited to see the community helping in shaping this tool to be even more efficient and feature-rich.
### Reporting Bugs
Encountered a hiccup? We're here to help! Please:
1. Open an issue on GitHub detailing the bug.
2. Describe the problem in depth. Share the steps to reproduce the issue and any error messages you received.
3. If possible, provide information about your operating system and Node.js version.
### Suggesting Enhancements
Have a brilliant idea for a new feature or an improvement to an existing one? We're all ears! Please:
1. Open an issue on GitHub to share your suggestions.
2. Be as detailed as possible, explaining what you want to achieve and why it would be beneficial to the project.
### Writing Code
If you're up for rolling up your sleeves to contribute code to fix a bug or implement a new feature, here's how you can get started:
1. Fork the repository.
2. Create a new branch for your changes.
3. Make your changes in your branch.
4. Submit a pull request from your branch to the main repo2pdf repository.
In your pull request, please provide a clear description of the changes you've made. We appreciate contributions that adhere to our coding conventions and are consistent with the existing codebase - it helps us maintain the quality of the project and makes the review process more efficient.
---
### Meet Our Contributors
We're ever grateful for the valuable contributions from our community. Meet the people who're helping shape repo2pdf:
[](https://github.com/BankkRoll/repo2pdf/graphs/contributors)
---
## License
repo2pdf is open source software, licensed under the MIT License. See the `LICENSE` file for more information.
## Star History
