It seems like there are a lot of questions here, so I am going to do my best to answer them. In the future, please try and ask individual questions.
Please ignore wappalyzer. At the end of the day, Jekyll (and Gatsby, and Next, and HUGO, …) uses JAMStack concepts, which means it outputs pure, web-standard HTML, CSS, and JavaScript without any server-side processing.
The only way to tell what your website is running is to look at the gemfile
in the root of your specified branch folder.
I know my podcast website is using Jekyll 4.2.x because this is what it says in my gemfile:
gem "jekyll", "~> 4.2"
I know my corporate website is using Jekyl 3.9.x because this is what it says in my gemfile:
gem "jekyll", "~> 3.9"
Of course you will not know for sure that you are using that particular version until you run:
bundle install
(and bundle update just to be sure)
As for why you see Ruby on one repo and HTML in another, I would not worry about that. It is important to note that Jekyll is based on Ruby, so when you set it up, lots of Ruby dependencies are in there. GitHub uses analyzers to determine how much of one thing or another you are using and then displays what it assumes your site is using. For example, I have repos that say “HTML” and “Ruby” and “CSS”, but they are all Jekyll sites. Just like Wappalyzer, ignore this
There are a few things you should know about GitHub Pages. You can only have one, shall I say, instance of Jekyll per repo, but every repo can have GitHub Pages enabled. For example, I have at least 6 GitHub repos with Jekyll enabled.
Because of the link you shared, it sounds like you might like multiple instances of Jekyll on a single repo. I read the thread and it seems like GitHub is working on something to help you with that. I think it is probably better to just start using GitHub Pages and then figure out how it works with your development workflow.
For example, I had a product that I used to sell and kept the documentation updated frequently, but I did it with branches. For example, when I created a branch called new-feature
, I would update the docs in that branch. Once I merged new-feature
with main
, the new feature would release, as would the documentation.
There is no simple answer here, but I suggest if you are going to use Jekyll or any other JAMStack technology, you have to figure out how you want to structure the code and the docs and not try and force it to do something it can’t do (or is really hard to maintain).
I hope this helps!