From f0b208e0d7875ba91b9733b30d73b0ac20c10070 Mon Sep 17 00:00:00 2001 From: Cem Keylan Date: Mon, 3 Aug 2020 23:36:01 +0300 Subject: update --- build | 14 ++++++- docs/blog/20200803.html | 103 ++++++++++++++++++++++++++++++++++++++++++++++++ docs/blog/20200803.txt | 75 +++++++++++++++++++++++++++++++++++ docs/blog/index.html | 1 + docs/blog/index.txt | 1 + docs/docs.html | 41 +++++++++++++++++++ docs/docs.txt | 16 ++++++++ docs/news.xml | 2 +- docs/rss.xml | 75 ++++++++++++++++++++++++++++++++++- src/blog/20200803.txt | 75 +++++++++++++++++++++++++++++++++++ src/blog/index.md | 1 + src/docs.md | 16 ++++++++ src/news.xml | 2 +- src/rss.xml | 75 ++++++++++++++++++++++++++++++++++- templates/docs-index | 15 +++++++ 15 files changed, 506 insertions(+), 6 deletions(-) create mode 100644 docs/blog/20200803.html create mode 100644 docs/blog/20200803.txt create mode 100644 docs/docs.html create mode 100644 docs/docs.txt create mode 100644 src/blog/20200803.txt create mode 100644 src/docs.md create mode 100644 templates/docs-index diff --git a/build b/build index 05b2322..85c74b6 100755 --- a/build +++ b/build @@ -72,7 +72,7 @@ blog_index() { printf '* %s - [%s](%s)\n' \ "$(date --date="$postdate" +%b\ %d\ %Y)" \ "$(gettitle "$post")" \ - "$(printf "$post" | sed 's#src/blog/##;s/.md/.html/')" + "${postdate}.html" done >> src/blog/index.md } @@ -90,6 +90,16 @@ site_index() { done } +docs_index() ( + cp templates/docs-index src/docs.md + find src/docs ! -name .git ! -name README | sort | while read -r file; do + case "$file" in src/docs) continue; esac + [ -d "$file" ] && printf '### %s\n' "${file#src/docs/}" && continue + filedest=${file#src} filedest=${filedest%.*}.html + printf '[%s](%s)\n' "$(gettitle "$file")" "$filedest" + done >> src/docs.md +) + genrss() { find "$1" -type f ! -name index.md | sort -r | while read -r post ; do postdate="${post##*/}" ; postdate="${postdate%.*}" @@ -118,7 +128,7 @@ main() { rm -rf docs; mkdir -p docs # Generate the indexes for blog and the wiki - site_index; blog_index + site_index; blog_index; docs_index # Generate rss feeds genrss index news index.html > src/news.xml diff --git a/docs/blog/20200803.html b/docs/blog/20200803.html new file mode 100644 index 0000000..33a8832 --- /dev/null +++ b/docs/blog/20200803.html @@ -0,0 +1,103 @@ + + + + August 2020 News Post | Carbs Linux + + + + + + +

Carbs Linux - a simple linux distribution

+
+ +
+
+August 2020 News Post
+================================================================================
+
+We are having some stalls during this summer, as I am currently working on
+university-related stuff. Nonetheless, there are some important changes that I
+want to share in this month's post.
+
+
+INDEX
+--------------------------------------------------------------------------------
+
+- Carbs Packaging Tools                                                    [1.0]
+- Docs                                                                     [2.0]
+- Re-opening the Carbs Linux server                                        [3.0]
+
+
+[1.0] Carbs Packaging Tools
+--------------------------------------------------------------------------------
+
+This month I have reworked `kiss` into a new package manager, now renamed as
+`cpt`. Updating `kiss` will now bootstrap the new package manager, so you don't
+have to manually edit your system. If you don't like the idea of this, you can
+look up the `post-install` script on `core/kiss` and apply the changes manually.
+
+You will also need to rename your KISS_* variables to CPT_*. So, KISS_PATH
+becomes CPT_PATH.
+
+The rework changes the previous commands on the package manager into standalone
+tools, and move the package manager functions to a library. This makes it easier
+for a user to import functions and variables from the package manager, and
+extend the package manager with their own intended way. Previously this required
+ugly hacks and workarounds to use the package manager functions. I will be
+making use of these changes to re-implement binary package management functions
+as well.
+
+If you want to use the library on your script you can simply do this:
+
+  +--------------------------------------------------------------------------+
+  |                                                                          |
+  | #!/bin/sh                                                                |
+  | . cpt-lib                                                                |
+  | (...)                                                                    |
+  |                                                                          |
+  +--------------------------------------------------------------------------+
+
+There are obviously some clean-up and simplifications needed in this new
+tool-based package management method.
+
+
+[2.0] Docs
+--------------------------------------------------------------------------------
+
+I have added documentation for the distribution, and finally updated the guide
+for installation. It is now _almost_ complete. These docs can be installed to
+your system for online viewing. I will also add a documentation crawler similar
+to how werc[1] works (but as an offline viewer). You can find `carbs-docs` from
+the repository. Currently, the documentation lacks but I will be adding new
+stuff. These will solely be distribution specific documentation and will not be
+a wiki-like source. If anyone would like to contribute to a wiki-like
+documentation source, I would happily re-open the distribution wiki. You can
+find the source on https://github.com/CarbsLinux/docs
+
+
+[3.0] Re-opening the Carbs Linux server
+--------------------------------------------------------------------------------
+
+Back in May, I had shutdown the Carbs Linux server due to financial issues, but
+I am slowly reverting to the self-hosted model. Back then, the git repositories
+were mirrored to GitHub, and the management was overall much more flexible. The
+server used to run Carbs Linux as well (that was fun and horrifying at the same
+time). Now, I will be relaunching the git server which will be the upstream
+source before the August 5. You can switch your remote, but GitHub will stay as
+a remote nonetheless.
+
+[1]: http://werc.cat-v.org
+
+ View Page Source +
+

Linux® is a registered trademark of Linus Torvalds

+

Copyright © 2019-2020 Cem Keylan

+ + diff --git a/docs/blog/20200803.txt b/docs/blog/20200803.txt new file mode 100644 index 0000000..ec7e7f9 --- /dev/null +++ b/docs/blog/20200803.txt @@ -0,0 +1,75 @@ +August 2020 News Post +================================================================================ + +We are having some stalls during this summer, as I am currently working on +university-related stuff. Nonetheless, there are some important changes that I +want to share in this month's post. + + +INDEX +-------------------------------------------------------------------------------- + +- Carbs Packaging Tools [1.0] +- Docs [2.0] +- Re-opening the Carbs Linux server [3.0] + + +[1.0] Carbs Packaging Tools +-------------------------------------------------------------------------------- + +This month I have reworked `kiss` into a new package manager, now renamed as +`cpt`. Updating `kiss` will now bootstrap the new package manager, so you don't +have to manually edit your system. If you don't like the idea of this, you can +look up the `post-install` script on `core/kiss` and apply the changes manually. + +You will also need to rename your KISS_* variables to CPT_*. So, KISS_PATH +becomes CPT_PATH. + +The rework changes the previous commands on the package manager into standalone +tools, and move the package manager functions to a library. This makes it easier +for a user to import functions and variables from the package manager, and +extend the package manager with their own intended way. Previously this required +ugly hacks and workarounds to use the package manager functions. I will be +making use of these changes to re-implement binary package management functions +as well. + +If you want to use the library on your script you can simply do this: + + +--------------------------------------------------------------------------+ + | | + | #!/bin/sh | + | . cpt-lib | + | (...) | + | | + +--------------------------------------------------------------------------+ + +There are obviously some clean-up and simplifications needed in this new +tool-based package management method. + + +[2.0] Docs +-------------------------------------------------------------------------------- + +I have added documentation for the distribution, and finally updated the guide +for installation. It is now _almost_ complete. These docs can be installed to +your system for online viewing. I will also add a documentation crawler similar +to how werc[1] works (but as an offline viewer). You can find `carbs-docs` from +the repository. Currently, the documentation lacks but I will be adding new +stuff. These will solely be distribution specific documentation and will not be +a wiki-like source. If anyone would like to contribute to a wiki-like +documentation source, I would happily re-open the distribution wiki. You can +find the source on https://github.com/CarbsLinux/docs + + +[3.0] Re-opening the Carbs Linux server +-------------------------------------------------------------------------------- + +Back in May, I had shutdown the Carbs Linux server due to financial issues, but +I am slowly reverting to the self-hosted model. Back then, the git repositories +were mirrored to GitHub, and the management was overall much more flexible. The +server used to run Carbs Linux as well (that was fun and horrifying at the same +time). Now, I will be relaunching the git server which will be the upstream +source before the August 5. You can switch your remote, but GitHub will stay as +a remote nonetheless. + +[1]: http://werc.cat-v.org diff --git a/docs/blog/index.html b/docs/blog/index.html index 75ea51b..3105528 100644 --- a/docs/blog/index.html +++ b/docs/blog/index.html @@ -23,6 +23,7 @@

This is the Carbs Linux Blog Index. You can find every post here. RSS Feed