Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add rtds support. #24

Closed
wants to merge 4 commits into from
Closed

Conversation

panhaoyu
Copy link
Contributor

@panhaoyu panhaoyu commented Jan 20, 2019

I notice that you have tried to use mkdoc to generate the website.

Here's an example at readthedocs.org, powered by sphinx.

There's a little bug, but it is still great.

RTDs

@howie6879
Copy link
Owner

Hi @panhaoyu :
Great job, but i think mkdocs is better than readthedocs.
Can you update it based on the current Ruia documentation?

@howie6879
Copy link
Owner

For the project documentation, we just need to focus on the English version.

@panhaoyu panhaoyu closed this Jan 20, 2019
@panhaoyu panhaoyu deleted the rtds-support branch January 20, 2019 07:21
@panhaoyu
Copy link
Contributor Author

I haven't used mkdocs. Give me some time.

@howie6879
Copy link
Owner

I haven't used mkdocs. Give me some time.

haha, It's so friendly for every one
I just started using it.

@panhaoyu
Copy link
Contributor Author

BTW, I love sphinx because it can directly read the docstrings.
Sphinx means user should read the source code directly to find API.

@howie6879
Copy link
Owner

  1. Just update docs's md files
    2.PR
    2.I will build it by using mkdocs and update it to gh-pages branch

@howie6879
Copy link
Owner

mkdocs seems like supported it too

@panhaoyu
Copy link
Contributor Author

em? okay I live in last century233

@howie6879
Copy link
Owner

BTW, i want to bug a domain for ruia.
Do you have any suggestions about the name of the website?

@panhaoyu
Copy link
Contributor Author

ruia.com?

@howie6879
Copy link
Owner

ruia.org has been bought
ruia.com too

@panhaoyu
Copy link
Contributor Author

It is necessary? I think ghp is enough

@panhaoyu
Copy link
Contributor Author

after all it's a tiny library

@howie6879
Copy link
Owner

ok, i want to build a friendly website for beginners.
Every can write and run ruia spider script by using our website
Just like pyspider

@panhaoyu
Copy link
Contributor Author

So you want to host a whole website? from backend to frontend? That's a huge project

@howie6879
Copy link
Owner

Ruia as a tiny and light framework, so I want to develop its plugin ecosystem
The goal of Ruia is plugin driver development
May be i will write a plugins named ruia-frontend, it can write、run and search code by using this project

@howie6879
Copy link
Owner

How to attract users to use ruia development is something I have been thinking about

@panhaoyu
Copy link
Contributor Author

That's what I want to say

@panhaoyu
Copy link
Contributor Author

With enough users, the ecosystem is easy to build

@panhaoyu
Copy link
Contributor Author

I just searched python spider from baidu and bing, all I found was scrapy

@panhaoyu
Copy link
Contributor Author

I was learing aiohttp, and you once named the project aiospider, so I know this project

@panhaoyu
Copy link
Contributor Author

At that time I was confused, why you changed the name from aiospider to ruia. I searched aio-libs, there's no aio crawler. Maybe you can try to join aio-libs project.

@howie6879
Copy link
Owner

Do you have any suggestions about attract users to use ruia development

@howie6879
Copy link
Owner

How to make ruia join aio-libs project

@howie6879
Copy link
Owner

At that time I was confused, why you changed the name from aiospider to ruia. I searched aio-libs, there's no aio crawler. Maybe you can try to join aio-libs project.

Because I can't think of other names.

@panhaoyu
Copy link
Contributor Author

Maybe write more articles about is? Join aio-libs? The attractive point of ruia I think is it's using aiohttp. Everyone learns python asynchronous library may learn aiohttp, and then will want to write a spider with it. Then he'll search python asyncio spider, and if ruia is the only library, then ruia.

@panhaoyu
Copy link
Contributor Author

I mean aiospider perhaps is a better name than ruia, for it can attract people using aiohttp

@panhaoyu
Copy link
Contributor Author

If ruia can do as good as scrapy, then the name is not important

@howie6879
Copy link
Owner

2333

@panhaoyu
Copy link
Contributor Author

there's a google group of aio-libs, but my ladder just crashed. pity.

@howie6879
Copy link
Owner

image

@panhaoyu
Copy link
Contributor Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants