Yew: make a website for yew

Created on 11 Aug 2019  路  6Comments  路  Source: yewstack/yew

make a website for yew. like smithy

documentation

All 6 comments

I would like to take a stab at this at some point.

What I can see this getting blocked on is a lack of content for the website and a working router. Ideally a CSS framework baked into yew would make implementation a lot easier as well.

  • I think a reasonable plan would be to take whatever guide/book is written for yew and include its constituent .md files via either include_str!() or sending them over HTTP and then rendering them using the markdown->vdom code in the crm example.
  • The router lib I'm working on is nearly in a releasable state.
  • @gmorus seems to be working on a lib that wraps Bootstrap. If that is in a usable state by the time the book and router come together, implementation might become a whole lot easier.

Hi,

Yes, I'm working on Reactstrap inspired lib for Bootstrap implementation (mostly as my rust/yew learning side project), but i cannot promise when it could be prod ready :/ If anybody would be interested in contributing, please message me ;) Last time I was trying to implement it in real app i couldn't figure out how to create statefull component based on nested tree of other stateless lib components and pass an action there to get a component Message as a response. You know, I'm completely new in this environment ;) Unfortunately this week i cannot do any lib improvement, but then, next two weeks I am available a lot for an open source work so if anybody will be interested to help me in some, lets say, core problems, to speed up my learning progress, it would be sooo nice :innocent:

You can look at build process at develop branch here (CR highly recommended before prod usage :rofl:)

I was also trying a real app implementation while writing this lib, you can look at it here. I hope i did it as it should be done properly.

I've quickly thrown together an example component within my routing lib that allows you to express a basic gitbook-style interface as easily as:

html! {
    <Guide>
        <Page
            uri="https://raw.githubusercontent.com/hgzimmerman/YewRouter/master/examples/guide/chapters/01_intro.md"
            page_url="/intro"
            title="Intro"
        />
        <Page
            uri="https://raw.githubusercontent.com/hgzimmerman/YewRouter/master/examples/guide/chapters/02_router_component.md"
            page_url="/router_component"
            title="Router Component"
        />
    </Guide>
}

Available here: https://github.com/hgzimmerman/YewRouter/tree/master/examples/guide

It could be made to look nicer, but it serves as a basic presentation layer for instructional content. Aside from content, all that's needed would be a landing page and better router integration with this component.

Also @gmorus I _really_ like what you have so far. The only change I would make would be in the way you concatenate classes, which I've already opened an issue for, and I hope to get a PR related to it open soon.

I think we should leverage GitBook for the site. I've started one for the Yew organization here that I'll invite collaborators to once I get things setup https://app.gitbook.com/@yew

Was this page helpful?
0 / 5 - 0 ratings

Related issues

jstarry picture jstarry  路  4Comments

ghost picture ghost  路  5Comments

agausmann picture agausmann  路  3Comments

kellytk picture kellytk  路  3Comments

sanpii picture sanpii  路  3Comments