I'm using a git-based CMS (Netlify CMS) and need to implement the content's search functionality. Is it possible in git-based CMS?
Found I could use the GitHub already built search functionality
Related
I was wondering if anyone has found a good solution for publishing their jsdoc/better-docs documentation on a website that isn't Github Pages (for privacy concerns)? I've built an api to retrieve the html files from the documented project but it loses the better-docs templating when it's no longer within the same project. Any recommendations would be appreciated. Thanks!
Github is pretty secure and you can also make everything private if needed.
I would recommend Github, if not you can always opt for any alternatives like:
GitLab
SourceForge
BitBucket
Launchpad
you can read here more: https://itsfoss.com/github-alternatives/
Is there a way to easily search for / list template repositories on Github?
Templates are quite interesting because they allow to create a new project from a, well, template without having to get all the history with it.
An example with Spring Boot : https://github.com/Spring-Boot-Framework/Spring-Boot-Application-Template.
I tried the usual search on Github itself but using the "template" query doesn't give any meaningful results because many repositories use the "template" string without the actual Github meaning. I couldn't find any way to tag those repos either.
Even the API search page doesn't seem to include proper qualifiers for template repositories.
That leaves me to wonder how they can actually become useful since the discoverability is so low at the moment.
Thanks!
Got an answer from Github support yesterday. As of now, it is not possible.
Hi Julien,
Thank you for writing to GitHub Support.
If I understand you correctly, you want a way to search for repositories but only show template repositories.
If so, then, unfortunately such functionality does not exist. If you want, I can pass this ticket to our product team which reads and evaluates feedback about our products.
Regards,
Paul
GitHub Support
What is the recommended approach on GitHub to organizing documentation when working on a new version that represents a major rewrite?
In my project pg-promise I rely on jsDoc to generate all the documentation, and then publish it into gh-pages, as one usually does.
And while working on a new version that's a major rewrite and a documentation change, what is the best approach to making the new/unreleased documentation available? -
1. Should I simply create a separate repository just for the sake of publishing updated documentation there?
2. Should I use an external hosting/solution altogether?
3. Is there any GitHub feature that will let me publish more than one documentation version?
Thanks in advance!
This is feasible using Github Actions along with a static site generator (SSG) of your choice such as VuePress, Gatsby, Jekyll etc.
In its simplest form, create a GH action to generate the static site folder of the branch/release, then push the folder to corresponding folder in the branch pointed to by GH pages, say gh-pages. One of the branches/releases should be pushed to root. GitHub Pages Deploy Action can be helpful. Add a dropdown list of versions to your static website pointing to the matching folder.
Example:
GitHub action
dropdown list implemented by Vue component
rendered site powered by GH pages
I find Jekyll to be very easy and useful to maintain static html sites and blogs, especially along with GitHub pages. Wanted to know if there are any Static site generators or CMS which helps in maintaining Jekyll sites with live preview, inline editing, layout management, file management etc.
There's an emerging market of "headless CMS" services that let you (or other writers) edit content through a web interface, and then access this content via an API. Most have webhooks that could be used to trigger regeneration of the static site when the content stored in the CMS is changed. Libraries for jekyll integrations already exist for these platforms.
List of headless CMSes:
Prismic (jekyll library)
Contentful (jekyll library)
Osmek
Storyblok (jekyll integration)
others
A few cool products fit the bill here:
CloudCannon
Siteleaf
Forestry.io
DatoCMS
Netlify CMS
jekyll-admin
Most of them sync directly with Git so devs can push directly on the repo, and non-techie users indirectly do the same by saving content (which trigger builds) in simpler UIs.
I personally like CloudCannon for its easy, more "visual" approach to editing stuff for non-technical folks (one of our dev wrote a full tuts on using CC + Jekyll for a multilingual site, should it be helpful).
Netlify CMS' open source approach is pretty neat too. The CMS is basically a react app you inject in any project.
Happy coding.
I have found these solutions:
http://www.siteleaf.com/
http://cloudcannon.com/
The second seems to be more promising to me. We basically want to develop the jekyll templates on our side, but want to have the possiblity for non-coders to edit the content online.
If you don't want to pay and you are okay with hosting a solution or do the editing offline, then you could try out this one: https://github.com/jekyll/jekyll-admin (Although I haven't tried it, but if you do, please share your experiences with me.)
I just finished with a simple editor for the same. You can find it on github here. It is still in initial release stage but it does come with live preview for editing posts on jekyll and managing them.
I'm searching for the same, as all Static site generators I found require Markdown knowledge which isn't suitable at all for my clients.
I found this great CMS (Kinda!) https://sitecake.com/
Still don't know how to manage collections with it, say listing of few products with lightbox details, but I believe it is possible.
I am hosting pages on GitHub Pages. These use Jekyll, but that shouldn't matter.
Since we have source code management for the web pages and even a publishing and hosting... why not add CI!
Is there a best practice for implementing a link checker using Travis CI scenario. Also, practically, is this the "right" thing to do since may use a lot of resources?
Thank you!
Check the official document of Jekyll.
(http://jekyllrb.com/docs/continuous-integration/)