# How to make changes to the Carsmos jekyll site

install github desktop version which is the easiest way to manage the project changes otherwise install the github toolchains

clone the repo

git clone https://github.com/ymote/ymote.github.io

cd ymote.github.io directory

change the Gemfile

uncomment the following line because it runs locally

> gem "jekyll"
>
comment out the following line

> gem "github-pages", group: :jekyll_plugins
>

and do the following update

bundle add webrick

bundle install

if you got errors, check your ruby and gem version. Mine is below.
/Users/ychen/.gem/ruby/3.1.2/gems/bundler-2.2.29

then run the bundle build commands

bundle exec jekyll serve --livereload

you should be able to open the webiste at
http://localhost:4000/

## template strucutre explaination

### menu entry

menu structure is defined in the
> https://github.com/ymote/ymote.github.io/blob/main/_data/menus.yml

the picutre shows the how the menu is defined in the menu.yml and how the menu entry HTML is organized


Menu are either single-entry or multi-entries.

single-entry menu does not have

    menu-has-children:

such as this

  - name: 'home'
    title: 'Home'
    link: '/'   
    

multi-entries menu can list all the sub-menu items below the menu-has-children

  - name: 'projects'
    title: 'projects'
    link: '/'
    menu-has-children:
      - name: 'Dora'
        title: 'Dora'
        link: '/projects/dora/'

      - name: 'Oasis'
        title: 'Oasis'
        link: '/projects/oasis/'

      - name: 'EmtyOS'
        title: 'EmtyOS'
        link: '/projects/emtyos/'  

      - name: 'AutoExpress'
        title: 'AutoExpress'
        link: '/projects/autoexpress/'

## menu structure
the screen below shows the menu entry URL is defined in the HTML file


## page template file

the jekyll content file is composed with page template file, page content data and template files seen below


a HTML page can specify a template file which is structured by multiple parts see below


## content page structure
a page content file is composed with template file, data file and rendering template file see below