Using conditional statement to create a project directory and project
Directory /home/kkcbal/vscode exists.
Directory /home/kkcbal/vscode/Asher exists.
 
Navigate to project, then navigate to area wwhere files were cloned
/home/kkcbal/vscode/Asher
list top level or root of files with project pulled from github
Gemfile       Makefile     [0m[01;34m_data[0m      [01;34m_notebooks[0m  [01;32mactivate.sh[0m  index.md
Gemfile.lock  README.md    [01;34m_includes[0m  [01;34m_posts[0m      csa.md       indexBlogs.md
LICENSE       _config.yml  [01;34m_layouts[0m   [01;34m_site[0m       [01;34mimages[0m       [01;34mscripts[0m
list again with hidden files pulled from github
[0m[01;34m.[0m        .gitignore    Makefile     [01;34m_includes[0m   [01;34m_site[0m        index.md
[01;34m..[0m       Gemfile       README.md    [01;34m_layouts[0m    [01;32mactivate.sh[0m  indexBlogs.md
[01;34m.git[0m     Gemfile.lock  _config.yml  [01;34m_notebooks[0m  csa.md       [01;34mscripts[0m
[01;34m.github[0m  LICENSE       [01;34m_data[0m        [01;34m_posts[0m      [01;34mimages[0m
list all files in long format
total 100
drwxr-xr-x 12 kkcbal kkcbal 4096 Aug 23 12:22 [0m[01;34m.[0m
drwxr-xr-x 14 kkcbal kkcbal 4096 Aug 24 11:13 [01;34m..[0m
drwxr-xr-x  8 kkcbal kkcbal 4096 Aug 23 12:42 [01;34m.git[0m
drwxr-xr-x  3 kkcbal kkcbal 4096 Aug 18 11:31 [01;34m.github[0m
-rw-r--r--  1 kkcbal kkcbal  104 Aug 18 11:31 .gitignore
-rw-r--r--  1 kkcbal kkcbal  122 Aug 18 11:31 Gemfile
-rw-r--r--  1 root   root   7293 Aug 18 11:46 Gemfile.lock
-rw-r--r--  1 kkcbal kkcbal 1081 Aug 18 11:31 LICENSE
-rw-r--r--  1 kkcbal kkcbal 3114 Aug 18 11:31 Makefile
-rw-r--r--  1 kkcbal kkcbal 5798 Aug 18 11:31 README.md
-rw-r--r--  1 kkcbal kkcbal  431 Aug 23 12:30 _config.yml
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [01;34m_data[0m
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [01;34m_includes[0m
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [01;34m_layouts[0m
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 24 11:22 [01;34m_notebooks[0m
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 23 12:33 [01;34m_posts[0m
drwxr-xr-x  7 kkcbal kkcbal 4096 Aug 23 12:34 [01;34m_site[0m
-rwxr-xr-x  1 kkcbal kkcbal 1291 Aug 18 11:31 [01;32mactivate.sh[0m
-rw-r--r--  1 kkcbal kkcbal   92 Aug 18 11:31 csa.md
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:57 [01;34mimages[0m
-rw-r--r--  1 kkcbal kkcbal  258 Aug 18 11:59 index.md
-rw-r--r--  1 kkcbal kkcbal   53 Aug 18 11:31 indexBlogs.md
drwxr-xr-x  3 kkcbal kkcbal 4096 Aug 18 11:31 [01;34mscripts[0m
 
Look for posts
/home/kkcbal/vscode/Asher/_posts
total 24
-rw-r--r-- 1 kkcbal kkcbal 1812 Aug 18 11:31 2023-08-15-Tools_Sprint.md
-rw-r--r-- 1 kkcbal kkcbal 4397 Aug 18 11:31 2023-08-16-Tools_Equipment.md
-rw-r--r-- 1 kkcbal kkcbal  468 Aug 18 11:31 2023-08-21-GitHub_Pages.md
-rw-r--r-- 1 kkcbal kkcbal    0 Aug 22 11:47 calculator.css
-rw-r--r-- 1 kkcbal kkcbal 1084 Aug 22 11:47 calculator.html
-rw-r--r-- 1 kkcbal kkcbal    0 Aug 22 11:47 calculator.js
-rw-r--r-- 1 kkcbal kkcbal   16 Aug 23 12:37 calculator.md
 
Look for notebooks
/home/kkcbal/vscode/Asher/_notebooks
total 48
-rw-r--r-- 1 kkcbal kkcbal  5415 Aug 18 11:31 2023-08-17-AP-pseudo-vs-python.ipynb
-rw-r--r-- 1 kkcbal kkcbal  8615 Aug 18 11:31 2023-08-21-VSCode-GitHub_Pages.ipynb
-rw-r--r-- 1 kkcbal kkcbal     0 Aug 23 12:38 2023-08-23-Java.ipynb
-rw-r--r-- 1 kkcbal kkcbal 27253 Aug 24 11:21 2023-08-24-bashteset.ipynb
 
Look for images in notebooks, print working directory, list files
bash: cd: /home/kkcbal/vscode/Asher/_notebooks/images: No such file or directory
/home/kkcbal/vscode/Asher/_notebooks
total 48
-rw-r--r-- 1 kkcbal kkcbal  5415 Aug 18 11:31 2023-08-17-AP-pseudo-vs-python.ipynb
-rw-r--r-- 1 kkcbal kkcbal  8615 Aug 18 11:31 2023-08-21-VSCode-GitHub_Pages.ipynb
-rw-r--r-- 1 kkcbal kkcbal     0 Aug 23 12:38 2023-08-23-Java.ipynb
-rw-r--r-- 1 kkcbal kkcbal 27253 Aug 24 11:21 2023-08-24-bashteset.ipynb
 
Navigate to project, then navigate to area wwhere files were cloned
show the contents of README.md
## Blog site using GitHub Pages and Jekyll
> This site is intended for Students.   This is to record plans, complete hacks, and do work for your learnings.
- This can be customized to support computer science as you work through pathway (JavaScript, Python/Flask, Java/Spring)
- All tangible artifact work is in a _posts or in a _notebooks.  
- Front matter (aka meta data) in ipynb and md files is used to organize information according to week and column in running web site.
## GitHub Pages
All `GitHub Pages` websites are managed on GitHub infrastructure. GitHub uses `Jekyll` to tranform your content into static websites and blogs. Each time we change files in GitHub it initiates a GitHub Action that rebuilds and publishes the site with Jekyll.  
- GitHub Pages is powered by: [Jekyll](https://jekyllrb.com/).
- Publised teacher website: [nighthawkcoders.github.io/teacher](https://nighthawkcoders.github.io/teacher/)
## Preparing a Preview Site 
In all development, it is recommended to test your code before deployment.  The GitHub Pages development process is optimized by testing your development on your local machine, prior to files on GitHub
Development Cycle. For GitHub pages, the tooling described below will create a development cycle  `make-code-save-preview`.  In the development cycle, it is a requirement to preview work locally, prior to doing a VSCode `commit` to git.
Deployment Cycle.  In the deplopyment cycle, `sync-github-action-review`, it is a requirement to complete the development cycle prior to doing a VSCode `sync`.  The sync triggers github repository update.  The action starts the jekyll build to publish the website.  Any step can have errors and will require you to do a review.
### WSL and/or Ubuntu installation requirements
- The result of these step is Ubuntu tools to run preview server.  These procedures were created using [jekyllrb.com](https://jekyllrb.com/docs/installation/ubuntu/)
- Run scripts in scripts directory of teacher repo: setup_ubuntu.sh and activate.sh.  Or, follow commands below.
```bash
## WSL/Ubuntu commands
# sudo apt install, installs packages for Ubuntu
echo "=== Ugrade Packages ==="
sudo apt update
sudo apt upgrade -y
#
echo "=== Install Ruby ==="
sudo apt install -y ruby-full build-essential zlib1g-dev
# 
echo "=== Install Python ==="
sudo apt-get install -y python3 python3-pip python-is-python3
#    
echo "=== Install Jupyter Notebook ==="
sudo apt-get install -y jupyter-notebook
# bash commands, install user requirements.
echo "=== GitHub pages build tools  ==="
export GEM_HOME="$HOME/gems"
export PATH="$HOME/gems/bin:$PATH"
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
echo "=== Gem install starting, thinking... ==="
gem install jekyll bundler
head -30 ./teacher/scripts/activate.sh
echo "=== !!!Start a new Terminal!!! ==="
```
### MacOs installation requirements 
- Ihe result of these step are MacOS tools to run preview server.  These procedures were created using [jekyllrb.com](https://jekyllrb.com/docs/installation/macos/). Run scripts in scripts directory of teacher repo: setup_macos.sh and activate_macos.sh.  Or, follow commands below.
```bash
# MacOS commands
# brew install, installs packages for MacOS
echo "=== Ugrade Packages ==="
brew update
brew upgrade
#
echo "=== Install Ruby ==="
brew install chruby ruby-install xz
ruby-install ruby 3.1.3
#
echo "=== Install Python ==="
brew install python
#    
echo "=== Install Jupyter Notebook ==="
brew install jupyter
# bash commands, install user requirements.
export GEM_HOME="$HOME/gems"
export PATH="$HOME/gems/bin:$PATH"
echo '# Install Ruby Gems to ~/gems' >> ~/.zshrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.zshrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.zshrc
echo "=== Gem install starting, thinking... ==="
gem install jekyll bundler
head -30 ./teacher/scripts/activate.sh
echo "=== !!!Start a new Terminal!!! ==="
```
### Preview
- The result of these step is server running on: http://0.0.0.0:4100/teacher/.  Regeneration messages will run in terminal on any save.  Press the Enter or Return key in the terminal at any time to enter commands.
- Complete installation
```bash
bundle install
```
- Run Server.  This requires running terminal commands `make`, `make stop`, `make clean`, or `make convert` to manage the running server.  Logging of details will appear in terminal.   A `Makefile` has been created in project to support commands and start processes.
    - Start preview server in terminal
    ```bash
    cd ~/vscode/teacher  # my project location, adapt as necessary
    make
    ```
    - Terminal output of shows server address. Cmd or Ctl click http location to open preview server in browser. Example Server address message... 
    ```
    Server address: http://0.0.0.0:4100/teacher/
    ```
    - Save on ipynb or md activiates "regeneration". Refresh browser to see updates. Example terminal message...
    ```
    Regenerating: 1 file(s) changed at 2023-07-31 06:54:32
        _notebooks/2024-01-04-cockpit-setup.ipynb
    ```
    - Terminal message are generated from background processes.  Click return or enter to obtain prompt and use terminal as needed for other tasks.  Alway return to root of project `cd ~/vscode/teacher` for all "make" actions. 
        
    - Stop preview server, but leave constructed files in project for your review.
    ```bash
    make stop
    ```
    - Stop server and "clean" constructed files, best choice when renaming files to eliminate potential duplicates in constructed files.
    ```bash
    make clean
    ```
    - Test notebook conversions, best choice to see if IPYNB conversion is acting up.
    ```bash
    make convert
    ```
end of README.md
 
Show the shell environment variables, key on left of equal value on right
SHELL=/bin/bash
PYTHONUNBUFFERED=1
WSL2_GUI_APPS_ENABLED=1
project=/home/kkcbal/vscode/Asher
CONDA_EXE=/home/kkcbal/anaconda3/bin/conda
_CE_M=
APPLICATION_INSIGHTS_NO_DIAGNOSTIC_CHANNEL=1
WSL_DISTRO_NAME=Ubuntu
ELECTRON_RUN_AS_NODE=1
VSCODE_AMD_ENTRYPOINT=vs/workbench/api/node/extensionHostProcess
NAME=big-man-upstairs
PWD=/home/kkcbal/vscode/Asher
NIX_PROFILES=/nix/var/nix/profiles/default /home/kkcbal/.nix-profile
LOGNAME=kkcbal
CONDA_PREFIX=/home/kkcbal/anaconda3
MOTD_SHOWN=update-motd
RECOMMENDER_API_URL=https://gw.api.openshift.io//api/v2
NOTEBOOK_BASH_KERNEL_CAPABILITIES=image,html,javascript
project_dir=/home/kkcbal/vscode
HOME=/home/kkcbal
LANG=C.UTF-8
WSL_INTEROP=/run/WSL/12_interop
LS_COLORS=rs=0:di=01;34:ln=01;36:mh=00:pi=40;33:so=01;35:do=01;35:bd=40;33;01:cd=40;33;01:or=40;31;01:mi=00:su=37;41:sg=30;43:ca=30;41:tw=30;42:ow=34;42:st=37;44:ex=01;32:*.tar=01;31:*.tgz=01;31:*.arc=01;31:*.arj=01;31:*.taz=01;31:*.lha=01;31:*.lz4=01;31:*.lzh=01;31:*.lzma=01;31:*.tlz=01;31:*.txz=01;31:*.tzo=01;31:*.t7z=01;31:*.zip=01;31:*.z=01;31:*.dz=01;31:*.gz=01;31:*.lrz=01;31:*.lz=01;31:*.lzo=01;31:*.xz=01;31:*.zst=01;31:*.tzst=01;31:*.bz2=01;31:*.bz=01;31:*.tbz=01;31:*.tbz2=01;31:*.tz=01;31:*.deb=01;31:*.rpm=01;31:*.jar=01;31:*.war=01;31:*.ear=01;31:*.sar=01;31:*.rar=01;31:*.alz=01;31:*.ace=01;31:*.zoo=01;31:*.cpio=01;31:*.7z=01;31:*.rz=01;31:*.cab=01;31:*.wim=01;31:*.swm=01;31:*.dwm=01;31:*.esd=01;31:*.jpg=01;35:*.jpeg=01;35:*.mjpg=01;35:*.mjpeg=01;35:*.gif=01;35:*.bmp=01;35:*.pbm=01;35:*.pgm=01;35:*.ppm=01;35:*.tga=01;35:*.xbm=01;35:*.xpm=01;35:*.tif=01;35:*.tiff=01;35:*.png=01;35:*.svg=01;35:*.svgz=01;35:*.mng=01;35:*.pcx=01;35:*.mov=01;35:*.mpg=01;35:*.mpeg=01;35:*.m2v=01;35:*.mkv=01;35:*.webm=01;35:*.webp=01;35:*.ogm=01;35:*.mp4=01;35:*.m4v=01;35:*.mp4v=01;35:*.vob=01;35:*.qt=01;35:*.nuv=01;35:*.wmv=01;35:*.asf=01;35:*.rm=01;35:*.rmvb=01;35:*.flc=01;35:*.avi=01;35:*.fli=01;35:*.flv=01;35:*.gl=01;35:*.dl=01;35:*.xcf=01;35:*.xwd=01;35:*.yuv=01;35:*.cgm=01;35:*.emf=01;35:*.ogv=01;35:*.ogx=01;35:*.aac=00;36:*.au=00;36:*.flac=00;36:*.m4a=00;36:*.mid=00;36:*.midi=00;36:*.mka=00;36:*.mp3=00;36:*.mpc=00;36:*.ogg=00;36:*.ra=00;36:*.wav=00;36:*.oga=00;36:*.opus=00;36:*.spx=00;36:*.xspf=00;36:
UTM_SOURCE=vscode
WAYLAND_DISPLAY=wayland-0
NIX_SSL_CERT_FILE=/etc/ssl/certs/ca-certificates.crt
THREE_SCALE_USER_TOKEN=207c527cfc2a6b8dcf4fa43ad7a976da
CONDA_PROMPT_MODIFIER=(base) 
PYDEVD_USE_FRAME_EVAL=NO
VSCODE_L10N_BUNDLE_LOCATION=
posts=/home/kkcbal/vscode/Asher/_posts
UUID=8dbe7f9c-788f-4a1a-9647-9416b7e56f79
GEM_HOME=/home/kkcbal/gems
LESSCLOSE=/usr/bin/lesspipe %s %s
VSCODE_HANDLES_SIGPIPE=true
TELEMETRY_ID=6ad85175-4141-4e50-8e18-eb3ae055a779
TERM=xterm-256color
_CE_CONDA=
LESSOPEN=| /usr/bin/lesspipe %s
USER=kkcbal
PYTHONIOENCODING=utf-8
notebooks=/home/kkcbal/vscode/Asher/_notebooks
CONDA_SHLVL=1
DISPLAY=:0
SHLVL=1
GOLANG_EXECUTABLE=go
PAGER=cat
project_repo=https://github.com/KKcbal/Asher
VSCODE_CWD=/mnt/c/Users/marle/AppData/Local/Programs/Microsoft VS Code
CONDA_PYTHON_EXE=/home/kkcbal/anaconda3/bin/python
XDG_RUNTIME_DIR=/mnt/wslg/runtime-dir
PS1=[PEXP\[\]ECT_PROMPT>
CONDA_DEFAULT_ENV=base
WSLENV=VSCODE_WSL_EXT_LOCATION/up
PROVIDE_FULLSTACK_ACTION=true
VSCODE_WSL_EXT_LOCATION=/mnt/c/Users/marle/.vscode/extensions/ms-vscode-remote.remote-wsl-0.81.0
XDG_DATA_DIRS=/usr/local/share:/usr/share:/var/lib/snapd/desktop
PATH=/home/kkcbal/gems/bin:/home/kkcbal/.vscode-server/bin/6c3e3dba23e8fadc360aed75ce363ba185c49794/bin/remote-cli:/home/kkcbal/.nix-profile/bin:/home/kkcbal/gems/bin:/home/kkcbal/anaconda3/bin:/home/kkcbal/anaconda3/condabin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/usr/lib/wsl/lib:/mnt/c/Program Files/Microsoft/jdk-11.0.16.101-hotspot/bin:/mnt/c/WINDOWS/system32:/mnt/c/WINDOWS:/mnt/c/WINDOWS/System32/Wbem:/mnt/c/WINDOWS/System32/WindowsPowerShell/v1.0:/mnt/c/WINDOWS/System32/OpenSSH:/mnt/c/Program Files/Docker/Docker/resources/bin:/mnt/c/Program Files/dotnet:/mnt/c/Program Files/Microsoft SQL Server/150/Tools/Binn:/mnt/c/Program Files/Microsoft SQL Server/Client SDK/ODBC/170/Tools/Binn:/mnt/c/Users/marle/AppData/Local/Microsoft/WindowsApps:/mnt/c/Users/marle/AppData/Local/Programs/Microsoft VS Code/bin:/mnt/c/Users/marle/.dotnet/tools:/snap/bin
VSCODE_NLS_CONFIG={"locale":"en","osLocale":"en","availableLanguages":{}}
HOSTTYPE=x86_64
PULSE_SERVER=unix:/mnt/wslg/PulseServer
VSCODE_HANDLES_UNCAUGHT_ERRORS=true
OLDPWD=/home/kkcbal/vscode/Asher/_notebooks
VSCODE_IPC_HOOK_CLI=/mnt/wslg/runtime-dir/vscode-ipc-1c25d454-c5a8-4976-a500-b5b5ac1339cc.sock
_=/usr/bin/env
 
show the secrets of .git
total 60
-rw-r--r--  1 kkcbal kkcbal    7 Aug 23 12:42 COMMIT_EDITMSG
-rw-r--r--  1 kkcbal kkcbal   91 Aug 23 12:42 FETCH_HEAD
-rw-r--r--  1 kkcbal kkcbal   21 Aug 18 11:31 HEAD
-rw-r--r--  1 kkcbal kkcbal   41 Aug 23 12:42 ORIG_HEAD
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [0m[01;34mbranches[0m
-rw-r--r--  1 kkcbal kkcbal  256 Aug 18 11:31 config
-rw-r--r--  1 kkcbal kkcbal   73 Aug 18 11:31 description
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [01;34mhooks[0m
-rw-r--r--  1 kkcbal kkcbal 4330 Aug 23 12:42 index
drwxr-xr-x  2 kkcbal kkcbal 4096 Aug 18 11:31 [01;34minfo[0m
drwxr-xr-x  3 kkcbal kkcbal 4096 Aug 18 11:31 [01;34mlogs[0m
drwxr-xr-x 21 kkcbal kkcbal 4096 Aug 23 12:42 [01;34mobjects[0m
-rw-r--r--  1 kkcbal kkcbal  112 Aug 18 11:31 packed-refs
drwxr-xr-x  5 kkcbal kkcbal 4096 Aug 18 11:31 [01;34mrefs[0m
look at config file
[core]
	repositoryformatversion = 0
	filemode = true
	bare = false
	logallrefupdates = true
[remote "origin"]
	url = https://github.com/KKcbal/Asher.git
	fetch = +refs/heads/*:refs/remotes/origin/*
[branch "main"]
	remote = origin
	merge = refs/heads/main
 
# This example has error in VSCode, it run best on Jupyter
cd /tmp
file="sample.md"
if [ -f "$file" ]; then
    rm $file
fi
tee -a $file >/dev/null <<EOF
# Show Generated Markdown
This introductory paragraph and this line and the title above are generated using tee with the standard input (<<) redirection operator.
- This bulleted element is still part of the tee body.
EOF
echo "- This bulleted element and lines below are generated using echo with standard output (>>) redirection operator." >> $file
echo "- The list definition, as is, is using space to seperate lines.  Thus the use of commas and hyphens in output." >> $file
actions=("ls,list-directory" "cd,change-directory" "pwd,present-working-directory" "if-then-fi,test-condition" "env,bash-environment-variables" "cat,view-file-contents" "tee,write-to-output" "echo,display-content-of-string" "echo_text_>\$file,write-content-to-file" "echo_text_>>\$file,append-content-to-file")
for action in ${actions[@]}; do  # for loop is very similar to other language, though [@], semi-colon, do are new
  action=${action//-/ }  # convert dash to space
  action=${action//,/: } # convert comma to colon
  action=${action//_text_/ \"sample text\" } # convert _text_ to sample text, note escape character \ to avoid "" having meaning
  echo "    - ${action//-/ }" >> $file  # echo is redirected to file with >>
done
echo ""
echo "File listing and status"
ls -l $file # list file
wc $file   # show words
mdless $file  # this requires installation, but renders markown from terminal
rm $file  # clean up termporary file
 
File listing and status
-rw-r--r-- 1 kkcbal kkcbal 809 Aug 24 11:25 sample.md
 15 132 809 sample.md
mdless: command not found