You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: about.md
+10-20Lines changed: 10 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,39 +1,29 @@
1
1
---
2
2
layout: default
3
3
title: About html2rss
4
-
#nav_order: 2
4
+
nav_order: 2
5
5
---
6
6
7
7
# About html2rss
8
8
9
-
`html2rss` is an open-source project dedicated to empowering users to take control of their web content consumption. In an age where many websites no longer offer traditional RSS feeds, `html2rss`bridges this gap by providing a robust and flexible solution for converting any HTML content into a structured RSS format.
9
+
`html2rss` is an open-source project dedicated to empowering you to take control of your web content. In an age where traditional RSS feeds are often missing, `html2rss`provides a robust and flexible solution to convert almost any HTML content into a structured RSS format.
10
10
11
-
The project was started in 2018 and has since grown into a suite of tools that help users create and consume RSS feeds.
11
+
Started in 2018, the project has evolved into a comprehensive suite of tools designed to help you create and consume RSS feeds effortlessly.
12
12
13
13
---
14
14
15
-
###Our Mission
15
+
## Our Vision and Principles
16
16
17
17
Our mission is to provide a simple, powerful, and accessible tool that enables individuals and developers to create custom RSS feeds from any web page. We believe in the power of open standards and the freedom to access information on your own terms.
18
18
19
-
---
20
-
21
-
### The html2rss Ecosystem
22
-
23
-
The `html2rss` project is more than just a single tool. It's a collection of tools that work together to provide a complete RSS solution:
24
-
25
-
-**[`html2rss`](https://github.com/html2rss/html2rss):** The core Ruby gem that provides the main functionality for converting HTML to RSS.
26
-
-**[`html2rss-web`](https://github.com/html2rss/html2rss-web):** A web application that allows you to create and manage your RSS feeds through a user-friendly interface.
27
-
-**[`html2rss-configs`](https://github.com/html2rss/html2rss-configs):** A collection of pre-built feed configs for popular websites, so you can get started quickly.
28
-
29
-
---
19
+
Our project is guided by these core principles:
30
20
31
-
### Project Philosophy
21
+
-**User Empowerment:** Giving you the tools to customize your web experience.
22
+
-**Simplicity & Power:** Offering an easy-to-use interface with powerful underlying capabilities.
23
+
-**Open Source:** Fostering a collaborative environment where the community can contribute and improve the project.
24
+
-**Reliability:** Striving for a stable and dependable tool that consistently delivers.
32
25
33
-
-**User Empowerment:** Give users the tools to customize their web experience.
34
-
-**Simplicity & Power:** Offer an easy-to-use interface with powerful underlying capabilities.
35
-
-**Open Source:** Foster a collaborative environment where the community can contribute and improve the project.
36
-
-**Reliability:** Strive for a stable and dependable tool that consistently delivers.
26
+
For insights into our ongoing development, project roadmap, and how you can get involved, please visit our [Get Involved]({{ '/get-involved' | relative_url }}) page.
Connect with other users and contributors by joining our community discussions on GitHub. This is a vibrant space for general questions, sharing tips, discussing ideas, and getting feedback from the community.
12
+
13
+
[**💬 Join Discussions on GitHub**](https://github.com/orgs/html2rss/discussions)
14
+
15
+
We encourage you to participate, ask questions, and share your insights!
Want to participate in the `html2rss` project? Explore the options below to engage with our community and contribute to the project's growth.
11
+
12
+
---
13
+
14
+
-[**Report Bugs & Discuss Features**]({{ '/get-involved/issues-and-features' | relative_url }}): Found a bug or have a new feature idea? Learn where to report and discuss them.
15
+
-[**Join Community Discussions**]({{ '/get-involved/discussions' | relative_url }}): Connect with other users and contributors, ask questions, and share ideas.
16
+
-[**Contribute to html2rss**]({{ '/contributing' | relative_url }}): Ready to contribute code, documentation, or feed configurations? Find detailed guides here.
17
+
-[**📊 View Project Roadmap & Tasks**]({{ 'https://github.com/orgs/html2rss/projects/3/views/1' }}): See what's being worked on, planned, and needs attention across all `html2rss` projects.
18
+
19
+
---
20
+
21
+
We appreciate your interest in `html2rss` and look forward to your involvement!
We appreciate your help in improving `html2rss`! Please follow these guidelines when reporting issues or suggesting new features.
12
+
13
+
---
14
+
15
+
### Reporting Bugs
16
+
17
+
If you've found a bug, please open an issue on the appropriate GitHub repository. This helps us track and resolve problems efficiently.
18
+
19
+
[**➡️ Open an Issue on GitHub**](https://github.com/html2rss/html2rss/issues)
20
+
21
+
When opening a bug report, please provide as much detail as possible, including:
22
+
23
+
- The `html2rss` version you are using.
24
+
- Your operating system.
25
+
- Your configuration file (if applicable).
26
+
- The target URL you are trying to scrape.
27
+
- Any error messages you receive.
28
+
- Steps to reproduce the issue.
29
+
30
+
---
31
+
32
+
### Discussing New Features
33
+
34
+
For new feature ideas or enhancements, we encourage you to start a discussion on GitHub Discussions first. This allows for community input, refinement of the idea, and helps us prioritize development.
35
+
36
+
[**💬 Start a New Discussion on GitHub**](https://github.com/orgs/html2rss/discussions)
37
+
38
+
If the discussion leads to a concrete proposal, a formal feature request issue can then be opened.
Copy file name to clipboardExpand all lines: index.md
+9-16Lines changed: 9 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,30 +12,23 @@ Tired of missing updates from websites that don't offer RSS feeds? `html2rss` is
12
12
13
13
---
14
14
15
-
## The html2rss Ecosystem
16
-
17
-
`html2rss` is a suite of tools designed to help you create and manage RSS feeds.
18
-
19
-
-**[html2rss-web]({{ '/web-application' | relative_url }}):** A user-friendly web application that makes it easy to create, manage, and share RSS feeds. This is the recommended starting point for most users.
20
-
-**[html2rss (Ruby Gem)]({{ '/ruby-gem' | relative_url }}):** The core library that powers the web application. It provides a powerful and flexible command-line interface for creating custom RSS feeds.
21
-
-**[html2rss-configs](https://github.com/html2rss/html2rss-configs):** A community-driven repository of pre-built feed configurations for popular websites.
22
-
23
-
---
24
-
25
15
## Key Features
26
16
27
-
-**User-Friendly Web Interface:** The `html2rss-web` application provides a simple and intuitive interface for managing your feeds.
28
17
-**Automatic Feed Generation:** The `auto_source` scraper intelligently finds and extracts content from websites, so you can create feeds with minimal effort.
29
18
-**Precise Content Extraction:** Use familiar CSS selectors to target the exact content you want to include in your feed.
30
19
-**JavaScript Rendering:** Use a headless browser to render JavaScript-heavy websites and extract content that isn't available in the initial HTML.
31
20
-**Open Source:**`html2rss` is free to use, modify, and contribute to.
32
21
33
22
---
34
23
35
-
### Join the Community
24
+
## The html2rss Ecosystem
25
+
26
+
The `html2rss` project is more than just a single tool. It's a collection of tools that work together to provide a complete RSS solution:
36
27
37
-
Have a question, an idea, or a success story to share? Join the `html2rss` community on GitHub!
28
+
-**[html2rss-web]({{ '/web-application' | relative_url }}):** A user-friendly web application that makes it easy to create, manage, and share RSS feeds. This is the recommended starting point for most users.
29
+
-**[html2rss (Ruby Gem)]({{ '/ruby-gem' | relative_url }}):** The core library that powers the web application. It provides a powerful and flexible command-line interface for creating custom RSS feeds.
30
+
-**[html2rss-configs](https://github.com/html2rss/html2rss-configs):** A community-driven repository of pre-built feed configurations for popular websites, so you can get started quickly.
31
+
32
+
---
38
33
39
-
-**[Discussions](https://github.com/orgs/html2rss/discussions):** Ask questions, share ideas, and connect with other users.
40
-
-**[Issues](https://github.com/html2rss/html2rss/issues):** Report bugs and request new features.
41
-
-**[Contribute](https://github.com/html2rss/html2rss/fork):** Fork the repository and submit your own improvements.
34
+
Want to engage with the `html2rss` community or contribute to the project? Visit our [Get Involved]({{ '/get-involved' | relative_url }}) page for details on discussions, reporting issues, and contributing.
@@ -13,8 +13,8 @@ While basic selectors are straightforward, you can achieve very precise content
13
13
14
14
## Extractors
15
15
16
-
Learn how to extract specific attributes (like `src` for images) or static values. See [Extractors]({{ '/ruby-gem/configuration/selectors/extractors' | relative_url }}).
16
+
Learn how to extract specific attributes (like `src` for images) or static values. See [Extractors]({{ '/ruby-gem/reference/selectors/extractors' | relative_url }}).
17
17
18
18
## Post Processors
19
19
20
-
Manipulate extracted text, sanitize HTML, convert Markdown, or apply custom logic. See [Post Processors]({{ '/ruby-gem/configuration/selectors/post-processors' | relative_url }}).
20
+
Manipulate extracted text, sanitize HTML, convert Markdown, or apply custom logic. See [Post Processors]({{ '/ruby-gem/reference/selectors/post-processors' | relative_url }}).
0 commit comments