Spaces:
Sleeping
Sleeping
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.
|