ari/blog.ari.lt
1
0
Fork 0
mirror of https://git.ari.lt/ari.lt/blog.ari.lt.git synced 2025-02-04 09:39:25 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
The Ari-web blog. https://blog.ari.lt/
534 commits 1 branch 0 tags 7.2 MiB
Python 92.1%
CSS 7.5%
Shell 0.4%
Find a file
Ari Archer 66ba933e5b
update @ Tue Feb 20 05:08:41 EET 2024 
Signed-off-by: Ari Archer <ari.web.xyz@gmail.com>
2024-02-20 05:08:41 +02:00
content update @ Thu 30 Nov 20:16:15 EET 2023 2023-11-30 20:16:15 +02:00
scripts update @ Tue Feb 20 05:08:41 EET 2024 2024-02-20 05:08:41 +02:00
.editorconfig init 2022-03-11 13:35:37 +02:00
.gitignore update @ Sun Oct 29 17:41:58 EET 2023 2023-10-29 17:41:58 +02:00
blog.json update @ Tue Feb 20 05:02:17 EET 2024 2024-02-20 05:02:17 +02:00
LICENSE update @ Thu 30 Nov 20:16:15 EET 2023 2023-11-30 20:16:15 +02:00
netlify.toml update @ Mon 11 Dec 17:39:03 EET 2023 2023-12-11 17:39:03 +02:00
pyproject.toml total rewrite of the blogging system 2023-08-29 10:27:14 +03:00
README.md fix readme and redirects 2023-11-30 20:42:40 +02:00
requirements-extra.txt update @ Tue Oct 17 17:29:30 EEST 2023 2023-10-17 17:29:30 +03:00
requirements.txt update @ Sun Oct 8 07:37:55 EEST 2023 2023-10-08 07:37:55 +03:00
runtime.txt update @ Sat 5 Nov 20:05:57 EET 2022 2022-11-05 20:05:57 +02:00
tg-instaview.tg added tg instaview script 2023-11-22 21:23:26 +02:00
tox.ini total rewrite of the blogging system 2023-08-29 10:27:14 +03:00

README.md

ari-web blog

installing dependencies

$ python3 -m virtualenv venv
$ . venv/bin/activate
$ pip install -r requirements.txt

Or

$ python3 -m pip install --user -r requirements.txt

do the same with requirements-extra.txt if ur using stuff like new

creating a new blog

$ ./scripts/blog.py blog

building

  • generate full-on static site
$ CI=1 ./scripts/blog static
  • only build posts
$ CI=1 ./scripts/blog build

CI environment variable is optional, though setting it in a build/CI environment is good to save time on some operations that are useless in that context, for example sorting blogs

CI can have any value

NOCLR also disables colours

the API

features u might wanna add

why ari-web blog manager

  • writer friendly -- uses markdown, keeps tracks of dates useful custom markdown extensions, support for editing, removal of posts,, and u can style ur blog the way you want it to b using css, easy build directory cleanup, support for custom fonts, locales, licenses, etc
  • reader friendly -- the blog posts are sorted from newest to oldest making it easy to get latest blog posts, they can also get a shortcut on their device as it has a manifest.json so they can open ur blog as an app, also support for an rss feed meaning ur users can subscribe to ur blog to get latest posts on their rss feeder app
  • writer-developer friendly -- the script is easily extensible by developers, markdown extensions, etc,, testing of each component using subcommands and a built-in testing http server
  • reader-developer friendly -- api access to latest blog posts and ur blog as a whole though blog.json, apis are hashed and minified
  • search engine optimization ( seo ) -- generator tries to follow best seo practices and adds a bunch of metadata not only in html but in other files too -- robots.txt, manifest.json, sitemap.xml, rss.xml and ofc the apis ( recents.json, recents_json_hash.txt, blog_json_hash.txt )
  • payload size -- generator generates minified content ( all apis, rss.xml, generated html of blog posts and home page, all css and fonts ) making it fast to load for readers
  • accessibility -- the blog generator follows best a11y practices making it easy for people with disabilities to read ur posts
  • google pagespeed optimized -- this metric shows us how accessible and fast our pages r and this generator tries to optimize for it
  • fast -- the generator uses fast libraries, data structures and threading, it doesnt import useless libraries in build time ( unless theyre pointless to exclude ), meaning its very quick to build ur blog into a full-blown static website
  • open source -- this generator and all of the content on it are licensed under gplv3 and the code and content are free to the public making it open source
  • overall pleasant experience to grow ur blog :)