2022-11-13
converting to Quarto
2021-12-20
Running log of steps used Each time you do some work enter the date on a new line Then one line per statement thereafter https://python-poetry.org/docs/basic-usage/
set up poetry
poetry new uclhal
poetry add nikola
poetry shell
git
git init
git branch -m main
https://getnikola.com/getting-started.html conflicts if you run the set up command from the root of the poetry project maybe something to do with their being a toml file there already? instead I did the install from a clean (naked) subdirectory site at ./uclhal/uclhal
?prob will need to publish the site from that subdirectoy if I wish to use github
2021-12-21
set up pylsp in sublime
updated pyproject.toml
[tool.poetry.dev-dependencies]
pytest = "^5.2"
python-lsp-server = "^1.3.1"
python-lsp-black = "^1.0.0"
mypy-ls = "^0.5.1"
pyls-isort = "^0.2.2"
then
poetry update
then copied settings from dashRep into uclhal.sublime-project used which pylsp
to find the path to pylsp
"settings": {
"LSP": {
"pylsp": {
"enabled": true,
"command": [
"/Users/steve/Library/Caches/pypoetry/virtualenvs/uclhal-XMZ_bNmG-py3.9/bin/pylsp",
],
"settings": {
"pylsp.plugins.flake8.executable": "/Users/steve/Library/Caches/pypoetry/virtualenvs/uclhal-XMZ_bNmG-py3.9/bin/flake8",
},
},
},
},
deploy to github uses the following tool https://github.com/c-w/ghp-import
Inside your repository just run ghp-import $DOCS_DIR where $DOCS_DIR is the path to the built documentation. This will write a commit to your gh-pages branch with the current documents in it.
to build
cd ./uclhal/uclhal
nikola build
to deploy
cd ./uclhal/uclhal
nikola github_deploy
2021-12-21t11:02:53 Woo hoo! Site up, running and deployed!
2021-12-22
Look into github actions for automatic deploy I don’t think it will work b/c the blog lives in a subdir hence made a symlink then edited the github actions file at https://github.com/docsteveharris/nikola-action/releases/tag/v3.1.0-alpha
… I think in the end this might have worked But was confused b/c failed b/c could not find path src
but maybe b/c I was working from a feature branch So abandoned (?prematurely) And moved all blog files to top level and reset to the default github actions yml file rather than my fork this worked only when I pushed from the src
branch
but staying with this approach ’cos seems cleaner anyway
2021-12-29
just getting my bearings back serving from port 8000 from command line
nikola build && nikola serve
useful pages themes https://themes.getnikola.com/v8/zen/ restructured text https://docutils.sourceforge.io/docs/ref/rst/restructuredtext.html#indirect-hyperlink-targets nikola https://getnikola.com/handbook.html#indexes
others work https://paulomarconi.github.io/blog/Nikola-guide/ http://louistiao.me/posts/how-i-customized-my-nikola-powered-site/ https://www.brainsorting.dev/posts/create-a-blog-with-nikola/ http://hannahbarton.org.uk/pages/handbook/
old websites https://github.com/docsteveharris/harris-data-lab/blob/main/content/authors/finn-catling/_index.md
canterville images served from files/images using url images/name_of_image e.g. placed the blog log there
lots of fiddling with the logo now only displays correctly on the landing page tried to set up separate pages for each lab member prob easier? just to introduce each person via blog post with an appropriate category? then use the category to index individuals
2022-01-04
just added a bunch of pages for each lab member still do the HYLODE team