@aothms said:
Why not have IfcOpenBot do a commit to the website repo? That would also trigger a rebuild and doesn't require that much logic in the site >generator script. Downsides would be the noise from the amount of commits maybe to the website repo? But it's more vanilla git, less >proprietary APIs, therefore more portable?
Agreed. IfcOpenBot can commit a machine readable file with url and some metadata which can then be picked up by static website generator. Way better!
We're in the process of switching branches in IfcOpenShell. Upgrading from 0.6 to 0.7. So getting the website updated and the fresh builds listed on the website is getting a bit higher priority.
In the meantime I've also experimented myself with static site generation for the IfcOpenShell academy https://academy.ifcopenshell.org/ https://github.com/IfcOpenShell/academy/tree/main/posts I just opted for Nikola because it's python based and because it supports notebooks for posts. Nikola doesn't seem very suitable though for the main web experience.
What can I do to speed up the progress on this?
Bump - @tetov, can we help in any way?
Hi! I'm not the most experienced web developer but I've done a couple of things. Let me know if I can help in any way.
Hey @Pagody ! That would be awesome! Does the original post make sense to you? Do you have any experience in Sphinx (as some of the project documentation is currently generated with Sphinx, and we want to expand on it)? It's a pretty simple static site for the most part apart from Sphinx I believe.
@Moult said:
Hey @Pagody ! That would be awesome! Does the original post make sense to you? Do you have any experience in Sphinx (as some of the project documentation is currently generated with Sphinx, and we want to expand on it)? It's a pretty simple static site for the most part apart from Sphinx I believe.
The original post makes sense to me. I have a familiarity with the basics of Sphinx, but if that's not enough I'm more than happy to study and learn. I'm transitioning to a more programming oriented career so anything that can help me build experience and knowledge would be very welcome. My background is mostly Python and the web developer basics (html, css, some javascript).
I think that'd be perfect. If I skim through the discussion here one of the first steps are:
blenderbim.org is generated with mustach templates and some makefiles, and skeleton. I suggest that I convert the mustach templates to a jinja/sphinx
and then use the same templates here https://github.com/IfcOpenShell/website/tree/main/templates
Maybe I'm wrong though, also not sure how much progress already was made on this front.
Sure! If you need help converting the mustach templates, let me know. I'll take a look at what you have so far in the IfcOpenShell templates. I think you guys have my email in my profile info, if you want to schedule a meeting or send more information or instructions as to how to move forward.
@Pagody just some thoughts, by the way for the blenderbim.org website what you see is what you get - it's literally a static HTML website - so viewing the source is literally what's in the backend. I have a little script which concatenates and header and footer together but there isn't any dynamic code :) I'm more than happy for you to reimagine / redesign the website and scrap the old stuff with your own inspiration. In other words - feel free to hack away, copy what you see fit from the old sites, and make new proposals also where you see fit.
If you feel both sites should share the same design, that works - if you feel they should be distinct, that also works. Just a 2 cents that I think IfcOpenShell should target itself at developers, whereas the BlenderBIM Add-on site should target at users. So IfcOpenShell should talk about downloading, conda/pip, show code copy paste examples with syntax highlighting, have super readable documentation, have developer builds, and show the 10-20 command line tools in the growing ecosystem. It should also show both C++ and Python examples, how it differs to other OpenBIM libraries, and so on. Whereas the BlenderBIM Add-on site should probably be more screenshots and visuals, nice clear download link, community and support, etc.
We've made some progresss with the live website (ifcopenshell.org) thanks to great mocks from @Pagody and we're continuing the discussion here https://github.com/IfcOpenShell/website/issues/2
Be sure to drop by the discussion and provide thoughts, ideas (and better yet) visuals!
Login or Register to reply.