Move kubearmor.io to new static generator
ShubhamTatvamasi opened this issue · comments
I have an idea. We can directly use GitHub wiki page content for the blog for this we can use GitHub API.
What say? @ShubhamTatvamasi
We are doing that already. We want people to create a PR for posting new blogs and have a custom theme for our landing page.
https://github.com/kubearmor/KubeArmor/wiki
I understand it now.
We are doing that already. We want people to create a PR for posting new blogs and have a custom theme for our landing page. https://github.com/kubearmor/KubeArmor/wiki
When the PR having tag of blog is merged. It should be released in the blogs section of the website. I think we do it by setting up a github workflow for it.
We are doing that already. We want people to create a PR for posting new blogs and have a custom theme for our landing page. https://github.com/kubearmor/KubeArmor/wiki
Also theme and UI for website. If you want I can design.
I worked on this theme, can we improve it as per our needs?
https://hugo.shubhamtatvamasi.com
Yeah, we can definitely improve the theme. Even we can make or revamp whole website of kuberarmor.io using hugo unless its using any dynamic functionalities.
As I can see you are using theme provided by hugo-PaperMod. We need to add our own stylesheets, CSS files or CSS modules in order to customize the theme of the website.
My question is: Will we be revamping the whole kuberarmor.io or the blog part you are currently working on?
We will have to change the whole website. Come up with new design.
Fine👍! Should I create a Figma file and share the access of it via mail(mentioned in your profile) ? or we can do the vice-versa.
You do it.
Done🚀
I got the email, we have to get on a call for this.
Yup. Anytime in night. I'll be available and in any platform you choose.
Yup. Anytime in night. I'll be available and in any platform you choose.
Just notify me before hand if possible. I'll be there.
@ShubhamTatvamasi I'm just thinking of conducting an user survey in order to get an idea of what people think about current design and what changes or improvements they want in order to make the site more intuitive. Do you think this would work?
Also a new channel can only be create by the admin of the slack workspace. We need to talk to Rahul about this as he currently has the admin access.
@ShubhamTatvamasi I'm just thinking of conducting an user survey in order to get an idea of what people think about current design and what changes or improvements they want in order to make the site more intuitive. Do you think this would work?
Also a new channel can only be create by the admin of the slack workspace. We need to talk to Rahul about this as he currently has the admin access.
@nyrahul can you please create a new channel for #kuberarmor-website.
Also, I have a new framework suggestion. It's astro🚀. It uses .mdx instead of .md for content publication but customization it gives is out of the box. We can also use libraries like tailwind CSS in it.
Just checkout. Let me know .
Also, I have a new framework suggestion. It's astro🚀. It uses .mdx instead of .md for content publication but customization it gives is out of the box. We can also use libraries like tailwind CSS in it. Just checkout. Let me know .
Is it simple to read and write?
Can we generate static web pages with this?
Its just markdown having the access for jsx(its not mandatory, it uses javascript for more flexibility). React developers will have have fun. Yes, Astro mainly focuses on content based websites like blogs, portfolios, marketing and less dynamic e-commerce. So, I think this might be just the perfect framework for us.
I'm confirming about the best of the two within 2 days.
I'm confirming about the best of the two within 2 days.
That will be great, Thanks.
Astro🚀 V/S Hugo🔥
This is a competitive analysis between 2 frameworks.
Note: In this I have used basic boiler plate code that every framework gives.
GitHub Repo for Astro🚀: https://github.com/Aditya-150/hugo-test
GitHub Repo for Hugo🔥: https://github.com/Aditya-150/astro-blog
Both are hosted using Vercel.
Count the emojis to decide the winner.
🚀 -> Astro
🔥 -> Hugo
| Framework | SSG | Documentation | Build Speed | Community Support |
Markdown for Content Publication |
Developer Experience | 3rd Party Library Integration |
Real-time Data Loading | SEO | Performance (Lighthouse Score) |
Deployment Ease |
|---|---|---|---|---|---|---|---|---|---|---|---|
| Hugo🔥 |
|
Good & Detailed | 4ms🔥 | Larger🔥 & experienced |
.md file supported + .json etc | Good | Can Work | May work | Good | Killer🔥 | OK |
| Astro🚀 |
|
Good & Detailed | 407ms for For normal template 546ms for blog template |
Relatively New | .md + .mdx file supported🚀 | Better🚀 (fun for React developers) | Seamless🚀 | Works🚀 | Awesome🚀 | Good | Better🚀 |
| Winner⭐ | _ | _ | 🔥 | 🔥 | 🚀 | 🚀 | 🚀 | 🚀 | 🚀 | 🔥 | 🚀 |
Some more online resources found:
- https://onebite.dev/hugo-vs-astro-which-static-site-generator-to-choose-in-2023/
- https://www.reddit.com/r/gohugo/comments/zjwplq/thoughts_on_astro_vs_hugo/?rdt=37655
(Based on data available on internet, some tests and our requirements)
PS: I wasn't able to host Hugo site on GitHub pages due to some workflow issues for which I had to delete that repo🥲.
@Aditya-150 also check if these solutions can be deployed on GitHub pages.
I will try again and let you know.
Also if we host on Vercel we can still change the domain name by changing the DNS configuration.
Also if we host on Vercel we can still change the domain name by changing the DNS configuration.
I guess Vercel is a paid service.
@ShubhamTatvamasi just asking. Should I make any progress on the UI design part or wait for the content?
@ShubhamTatvamasi just asking. Should I make any progress on the UI design part or wait for the content?
Hi @Aditya-150, please feel free to progress on the UI design part, we are still in the process of gathering all the content.
Ok I'll be using content currently given in the website with some basic improvisations. Is that fine ? @ShubhamTatvamasi
Ok I'll be using content currently given in the website with some basic improvisations. Is that fine ? @ShubhamTatvamasi
Sure, that would be great. Thanks @Aditya-150 😄
Hey everyone While reading the whole conversation, I understood that we are building the site on Hugo or Astro. My question is why are we not using Javascript frameworks like ReactJs or NextJs.
Also, I'm interested in developing the website.
Hello @hanshal101. Nice to have you.
Thanks for going through the whole conversation. Also Thanks for showing so much interest in developing the website.
Coming to your question,
We aren't actually building our website with Hugo or Asto. We are using docusaurus which is open source framework by Meta for building our website which is a content driven framework too(Refer to the docusaurus official documentation for understanding linked above👆). Actually you are correct we could have used NEXTJS as it is a more dynamic framework and quite popular. We are using docusaurus as it is just a preference. Hope you understand.
Actually, currently we are at quite early stage of website. The first version is also yet to be released. There are a lot of thing to be done actually like documentation etc. So, you might need to wait for some time in order to start contributing. Thanks for showing so much interest. You can follow official documentation of docusaurus and get to know about kubearmor till then.
PS: Join the Slack Channel if you want to be part of this journey. 👉Join Slack
Thanks, @Aditya-150 for such a nice explanation. I'm currently learning ReactJs for frontend development, so I was quite interested in building the KubeArmor website. I truly understand the current requirements, and you are right, it's quite challenging to maintain a NextJS or ReactJS website in the early stages.
I will definitely look up the Docusaurus documentation and learn more about this framework.