saberland / saber

()==[:::::::::::::> Build static sites in Vue.js, without the hassle
https://saber.egoist.dev
MIT License
2.15k stars 113 forks source link

New docs #17

Open egoist opened 5 years ago

egoist commented 5 years ago

The new docs (https://saberjs.org/) is WIP, let me know if anything important is missing, or something you'd like to see in the docs.

matt-auckland commented 5 years ago

Do you want a PR fixing some grammar stuff in the docs or should I wait till you've added some more content first?

egoist commented 5 years ago

@matt-auckland Grammer fixes are welcome ๐Ÿ‘Œ

HerrBertling commented 5 years ago

I tried to use components/layout parts for different layouts.

Putting them into layouts/parts and then importing them within layouts/page.vue with e.g. import PageFooter from './parts/footer.vue made Webpack fail because it could apparently not import the file. Putting them into a root level components folder and importing relatively from layouts/page.vue (e.g. import PageFooter from '../components/footer.vue' did not work either.

Did I miss something or is this not possible at the moment? I'm fine with throwing the tiny bit of navigation logic for footer and header into a SFC as well, just thought I'd split these parts out ๐Ÿ˜„

egoist commented 5 years ago

@HerrBertling that should work, what's the error you ran into?

HerrBertling commented 5 years ago

I just checked the tutorial and wellโ€ฆ ๐Ÿคฆโ€โ™‚๏ธ โ€“ maybe I should add .vue to the files I import ๐Ÿ˜† ๐Ÿ™ˆ

HerrBertling commented 5 years ago

I did some digging. Iโ€™m not very good at Webpack, but I think the config in here would enable importing Vue files without extension? https://github.com/egoist/saber/blob/master/packages/saber/vue-renderer/lib/index.js - is something missing there? Seems not like it?

Iโ€™m so used to omitting the file extension from vue-cli, nuxt and VuePress that Iโ€™d say this should happen in Saber as well.

egoist commented 5 years ago

@HerrBertling It's better to import non JavaScript/JSON files with explicit extension.

egoist commented 5 years ago

@HerrBertling With that being said, I'll leave it up to you: https://github.com/egoist/saber/commit/186cb295cad8b16d2248a379e2af4f3c7591b3a1

luminarious commented 5 years ago

I can't seem to find a page in the docs that would list saber's CLI details. What parametres to use when.