Spaces:
Running
Running
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,13 +1,44 @@
|
|
| 1 |
---
|
| 2 |
-
title: Repo
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: gradio
|
| 7 |
-
sdk_version:
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
-
|
| 11 |
---
|
| 12 |
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: Repo to Markdown Converter
|
| 3 |
+
emoji: 📄
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: green
|
| 6 |
sdk: gradio
|
| 7 |
+
sdk_version: 4.12.0 # Or whichever version you used
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
+
license: mit # Or choose another appropriate license
|
| 11 |
---
|
| 12 |
|
| 13 |
+
# Repo to Markdown Converter
|
| 14 |
+
|
| 15 |
+
This Hugging Face Space converts a Git repository (from a URL) or an uploaded local folder (as a `.zip` archive) into a single Markdown file.
|
| 16 |
+
|
| 17 |
+
**Features:**
|
| 18 |
+
|
| 19 |
+
* Supports public Git repository URLs.
|
| 20 |
+
* Supports uploading local project folders (packaged as `.zip`).
|
| 21 |
+
* Generates a directory structure overview.
|
| 22 |
+
* Includes the content of text/code files within fenced code blocks.
|
| 23 |
+
* Attempts syntax highlighting using file extensions.
|
| 24 |
+
* Allows customizing file/directory ignore patterns.
|
| 25 |
+
* Option to set a maximum file size for content inclusion.
|
| 26 |
+
* Provides the generated Markdown for viewing and download.
|
| 27 |
+
|
| 28 |
+
**How to Use:**
|
| 29 |
+
|
| 30 |
+
1. Select the **Input Source**: "URL" or "Upload ZIP".
|
| 31 |
+
2. **If URL:** Enter the full HTTPS URL of the public Git repository.
|
| 32 |
+
3. **If Upload ZIP:** Click or drag-and-drop your `.zip` file containing the project folder.
|
| 33 |
+
4. **(Optional)** Modify the **Ignore Patterns** (comma-separated). Sensible defaults are provided. Add `/` at the end for directory patterns (e.g., `node_modules/`).
|
| 34 |
+
5. **(Optional)** Adjust the **Max File Size** limit (in KB). Files larger than this will be listed, but their content won't be included in the Markdown.
|
| 35 |
+
6. Click **Generate Markdown**.
|
| 36 |
+
7. The generated Markdown will appear in the output panel.
|
| 37 |
+
8. A **Download .md File** button will appear once generation is complete.
|
| 38 |
+
|
| 39 |
+
**Limitations:**
|
| 40 |
+
|
| 41 |
+
* Only works with publicly accessible Git repositories (no authentication).
|
| 42 |
+
* Large repositories or files might take time or exceed resource limits.
|
| 43 |
+
* Binary file detection is basic; some binary files might be misidentified as text, or vice-versa.
|
| 44 |
+
* ZIP extraction assumes a standard structure; deeply nested or unusually structured ZIPs might not process correctly.
|