mk_semi_lattice 0.3.1 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0d344bc5e5985d443acbd280d0c567b0e01be8635971e5155339d5b3b21e1b76
-  data.tar.gz: 3782664243e07f23a4e800505d08daf299963afb0df5923a489602ead09d84ad
+  metadata.gz: 638f66acbf8ab6be179d1ca6f40d5b4d945e645e4527340d8765fac9a323da50
+  data.tar.gz: 824274573342a78826f017f973b0e90a68b1e5e469f454ec1a9094c6a13c63d0
 SHA512:
-  metadata.gz: 9c9d8bd624f964fe520ba5b55dbad67cdac44a0791b1693f6d3d177e5c9555675cc88a853e764cbd99eea209c7c120a0d2b1e420911a128f34c68aa8148d7105
-  data.tar.gz: f3990badd3f2fbd9d7a0c1b4a99322c8203a018d9d0e80e30018da3d8736980599a37b9bfca0a77480b71f8a01bde7edbce8097584d5d26a5480295327f02134
+  metadata.gz: a709a137ac25b90a0a2e2d09ae0f2d262f73c2feec0e5a027213801bcd09fcaeb767104e7d34482a1fde9006b26e465b9d8c801f76fff2398c9df1e3088cbf1d
+  data.tar.gz: 0eaffd4bfa10e806642b6df13b275245c597aadb98a72a60fbeddb6b5b47e6df0e5022b8688b209f2a07d8185a92a169896dc334ebd54197a852c805c4c15101

data/README.org

@@ -1,9 +1,19 @@
-* MkSemiLattice
-Making semi-lattice graph from directory or other yaml files.
+#+OPTIONS: ^:{}
+#+STARTUP: indent nolineimages overview num
+#+TITLE: mk_semi_lattice, hc
+#+AUTHOR: Shigeto R. Nishitani
+#+EMAIL:     (concat "shigeto_nishitani@mac.com")
+#+LANGUAGE:  jp
+#+OPTIONS:   H:4 toc:t num:2
+#+SETUPFILE: https://fniessen.github.io/org-html-themes/org/theme-readtheorg.setup
 
-** Installation
+* Name
+セミラティス(semi lattice)構造を表示するmk_slコマンドと，
+英単語の習得を目指したhcコマンドです．
+
+* Installation
 'mk_semi_lattice' depends on 'ruby2d'.
-See the installation manual on https://www.ruby2d.com.
+See the installation manual on [[https://www.ruby2d.com/learn/linux/#install-packages][https://www.ruby2d.com]].
 
 Install the gem and add to the application's Gemfile by executing:
 
@@ -18,52 +28,39 @@ executing:
 gem install mk_semi_lattice
 #+end_src
 
-** Usage
+* Usage
 #+begin_src bash
-mk_semi_lattice is running...
-Usage: mk_semi_lattice PATH [options]
-Default PATH = '.'
-
-When using -I, always use '=' or quote the pattern, e.g.:
-    -I='_stack_*|*.yaml' -a
-    --ignore='_stack_*|*.yaml' -a
-  Multiple patterns can be separated by '|'.
-  Wildcards '*' and '?' are supported (like the 'tree' command).
-Do not use -ad; use -a -d for combined flags.
-
-    -L N                             Layer depth (default: 2)
-    -n, --node=FILE                  using File from node-edge
-    -t, --tree=FILE                  using File from tree
-    -i, --index                      Display node ids
-    -l, --log [BOOL]                 Enable/disable logging (true/false), and save to config
-    -v, --version                    show version
-    -d                               Show directories only
-    -a                               Show all (files and directories)
-    -Y                               YAML exclude mode
-    -I, --ignore=PATTERN             Ignore files/dirs matching PATTERN (e.g. '_stack_*|*.yaml')
+> hc -h
+Commands:
+  hc check           # check word for vocabulary builder
+  hc help [COMMAND]  # Describe available commands or one specific command
+  hc split_pdf       # split PDF files
+  hc stack           # make stacks
+  hc view            # View Semi Lattice Graph
 #+end_src
 
-** Development
-After checking out the repo, run =bin/setup= to install dependencies.
-Then, run =rake test= to run the tests. You can also run =bin/console=
-for an interactive prompt that will allow you to experiment.
+- [[./lib/mk_semi_lattice/docs/readme.org][hc view]]
+- [[./lib/mk_stack/docs/readme.org][hc stack]]
+- [[./lib/voca_buil/docs/readme.org][hc check]]
+- [[./lib/split_pdf/docs/readme.org][hc split_pdf]]
 
+* Development
 To install this gem onto your local machine, run
 =bundle exec rake install=. To release a new version, update the version
 number in =version.rb=, and then run =bundle exec rake release=, which
 will create a git tag for the version, push git commits and the created
 tag, and push the =.gem= file to [[https://rubygems.org][rubygems.org]].
 
-** Contributing
+* Contributing
 Bug reports and pull requests are welcome on GitHub at
 https://github.com/daddygongon/mk_semi_lattice. This project is intended
 to be a safe, welcoming space for collaboration, and contributors are
 expected to adhere to the [[https://github.com/%5BUSERNAME%5D/mk_semi_lattice/blob/main/CODE_OF_CONDUCT.md][code of conduct]].
 
-** License
+* License
 The gem is available as open source under the terms of the [[https://opensource.org/licenses/MIT][MIT License]].
 
-** Code of Conduct
+* Code of Conduct
 Everyone interacting in the MkSemiLattice project's codebases, issue
 trackers, chat rooms and mailing lists is expected to follow the
 [[https://github.com/%5BUSERNAME%5D/mk_semi_lattice/blob/main/CODE_OF_CONDUCT.md][code of conduct]].

data/exe/hc

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require "hc"

data/lib/hc.rb

@@ -0,0 +1,34 @@
+require 'thor'
+require_relative "mk_semi_lattice/version"
+require_relative "mk_stack/mk_stack"
+require_relative "voca_buil/multi_check"
+require_relative "split_pdf/split_pdf"
+
+
+class CLI < Thor
+  desc "view", "View Semi Lattice Graph"
+  def view(*argv)
+    system "mk_semi_lattice", *argv
+  end
+
+  desc 'stack', 'make stacks'
+  def stack(*argv)
+      MkStack.new(argv).run
+  end
+
+  desc 'split_pdf', 'split PDF files'
+  def split_pdf(*argv)
+    SplitPDF.new(argv).run
+  end
+  desc 'check_word', 'check word for vocabulary builder'
+  def check_word(*argv)
+    options = VocaBuil::OptionParserWrapper.parse
+    if options[:iter]
+      VocaBuil::IterativeCheck.new(options, options[:iter]).run
+    else
+      VocaBuil::BaseCheck.new(options).run
+    end 
+  end
+end 
+
+CLI.start(ARGV)

data/lib/mk_semi_lattice/docs/readme.html

@@ -0,0 +1,143 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="jp" xml:lang="jp">
+<head>
+<!-- 2026-01-06 Tue 16:20 -->
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>mk_sl, hc view</title>
+<meta name="author" content="Shigeto R. Nishitani" />
+<meta name="generator" content="Org Mode" />
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/htmlize.css"/>
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/readtheorg.css"/>
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/code-copy.css"/>
+<link rel="stylesheet" type="text/css" href="src/readtheorg_theme/css/search.css"/>
+<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/lib/js/jquery.stickytableheaders.min.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/search.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/readtheorg.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/code-copy.js"></script>
+</head>
+<body>
+<div id="content" class="content">
+<h1 class="title">mk_sl, hc view</h1>
+<div id="table-of-contents" role="doc-toc">
+<h2>Table of Contents</h2>
+<div id="text-table-of-contents" role="doc-toc">
+<ul>
+<li><a href="#orga30be58">1. Name</a></li>
+<li><a href="#orgaf6ac97">2. Help</a></li>
+<li><a href="#org47216ee">3. Usage</a>
+<ul>
+<li><a href="#org4773506">3.1. simple (with option Layer 3)</a></li>
+<li><a href="#org6bae69b">3.2. use option from tree</a></li>
+<li><a href="#org90a2f71">3.3. use option for dirs only</a></li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<div id="outline-container-orga30be58" class="outline-2">
+<h2 id="orga30be58"><span class="section-number-2">1.</span> Name</h2>
+<div class="outline-text-2" id="text-1">
+<p>
+Making semi-lattice graph from directory or other yaml files.
+</p>
+</div>
+</div>
+<div id="outline-container-orgaf6ac97" class="outline-2">
+<h2 id="orgaf6ac97"><span class="section-number-2">2.</span> Help</h2>
+<div class="outline-text-2" id="text-2">
+<div class="org-src-container">
+<pre class="src src-bash">&#57520; hc view -h
+mk_semi_lattice is running...
+Usage: mk_semi_lattice PATH [options]
+   or: hc view PATH [options]
+Default PATH = <span style="color: #8b7355;">'.'</span>
+    -L N                             Layer depth (default: 2)
+    -n, --node=FILE                  using File from node-edge
+    -t, --tree=FILE                  using File from tree
+    -i, --index                      Display node ids
+    -l, --log [BOOL]                 Enable/disable logging (true/false), and save to config
+    -v, --version                    show version
+    -d                               Show directories only
+    -a                               Show all (files and directories)
+    -Y                               YAML exclude mode
+    -I, --ignore=PATTERN             Ignore files/dirs matching PATTERN (e.g. <span style="color: #8b7355;">'_stack_*|*.yaml'</span>)
+
+        When using -I, always use <span style="color: #8b7355;">'='</span> or quote the pattern, e.g.:
+            -I=<span style="color: #8b7355;">'_stack_*|*.yaml'</span> -a
+            --ignore=<span style="color: #8b7355;">'_stack_*|*.yaml'</span> -a
+          Multiple patterns can be separated by <span style="color: #8b7355;">'|'</span>.
+          Wildcards <span style="color: #8b7355;">'*'</span> and <span style="color: #8b7355;">'?'</span> are supported (like the <span style="color: #8b7355;">'tree'</span> command).
+        Do not use -ad; use -a -d for combined flags.
+</pre>
+</div>
+</div>
+</div>
+<div id="outline-container-org47216ee" class="outline-2">
+<h2 id="org47216ee"><span class="section-number-2">3.</span> Usage</h2>
+<div class="outline-text-2" id="text-3">
+</div>
+<div id="outline-container-org4773506" class="outline-3">
+<h3 id="org4773506"><span class="section-number-3">3.1.</span> simple (with option Layer 3)</h3>
+<div class="outline-text-3" id="text-3-1">
+<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
+
+
+<colgroup>
+<col  class="org-left" />
+</colgroup>
+<tbody>
+<tr>
+<td class="org-left"><img src="./images/mk_semi_lattice.001.png" alt="mk_semi_lattice.001.png" /></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div id="outline-container-org6bae69b" class="outline-3">
+<h3 id="org6bae69b"><span class="section-number-3">3.2.</span> use option from tree</h3>
+<div class="outline-text-3" id="text-3-2">
+<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
+
+
+<colgroup>
+<col  class="org-left" />
+</colgroup>
+<tbody>
+<tr>
+<td class="org-left"><img src="./images/mk_semi_lattice.002.png" alt="mk_semi_lattice.002.png" /></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div id="outline-container-org90a2f71" class="outline-3">
+<h3 id="org90a2f71"><span class="section-number-3">3.3.</span> use option for dirs only</h3>
+<div class="outline-text-3" id="text-3-3">
+<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
+
+
+<colgroup>
+<col  class="org-left" />
+</colgroup>
+<tbody>
+<tr>
+<td class="org-left"><img src="./images/mk_semi_lattice.003.png" alt="mk_semi_lattice.003.png" /></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+</div>
+<div id="postamble" class="status">
+<p class="author">Author: Shigeto R. Nishitani</p>
+<p class="date">Created: 2026-01-06 Tue 16:20</p>
+<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
+</div>
+</body>
+</html>

data/lib/mk_semi_lattice/docs/readme.org

@@ -0,0 +1,50 @@
+#+OPTIONS: ^:{}
+#+STARTUP: indent nolineimages overview num
+#+TITLE: mk_sl, hc view
+#+AUTHOR: Shigeto R. Nishitani
+#+EMAIL:     (concat "shigeto_nishitani@mac.com")
+#+LANGUAGE:  jp
+#+OPTIONS:   H:4 toc:t num:2
+#+SETUPFILE: https://fniessen.github.io/org-html-themes/org/theme-readtheorg.setup
+
+
+* Name
+Making semi-lattice graph from directory or other yaml files.
+
+* Help
+#+begin_src bash
+ hc view -h
+mk_semi_lattice is running...
+Usage: mk_semi_lattice PATH [options]
+   or: hc view PATH [options]
+Default PATH = '.'
+    -L N                             Layer depth (default: 2)
+    -n, --node=FILE                  using File from node-edge
+    -t, --tree=FILE                  using File from tree
+    -i, --index                      Display node ids
+    -l, --log [BOOL]                 Enable/disable logging (true/false), and save to config
+    -v, --version                    show version
+    -d                               Show directories only
+    -a                               Show all (files and directories)
+    -Y                               YAML exclude mode
+    -I, --ignore=PATTERN             Ignore files/dirs matching PATTERN (e.g. '_stack_*|*.yaml')
+
+        When using -I, always use '=' or quote the pattern, e.g.:
+            -I='_stack_*|*.yaml' -a
+            --ignore='_stack_*|*.yaml' -a
+          Multiple patterns can be separated by '|'.
+          Wildcards '*' and '?' are supported (like the 'tree' command).
+        Do not use -ad; use -a -d for combined flags.
+#+end_src
+
+* Usage
+** simple (with option Layer 3)
+| [[./images/mk_semi_lattice.001.png]]
+
+** use option from tree
+| [[./images/mk_semi_lattice.002.png]]
+
+** use option for dirs only
+| [[./images/mk_semi_lattice.003.png]]
+
+

data/lib/mk_semi_lattice/option_manager.rb

@@ -15,15 +15,8 @@ class OptionManager
     OptionParser.new do |opts|
       opts.banner = <<~BANNER
         Usage: mk_semi_lattice PATH [options]
+           or: hc view PATH [options]
         Default PATH = '.'
-
-        When using -I, always use '=' or quote the pattern, e.g.:
-            -I='_stack_*|*.yaml' -a
-            --ignore='_stack_*|*.yaml' -a
-          Multiple patterns can be separated by '|'.
-          Wildcards '*' and '?' are supported (like the 'tree' command).
-        Do not use -ad; use -a -d for combined flags.
-        
       BANNER
 
       opts.on("-L N", Integer, "Layer depth (default: 2)") do |v|
@@ -94,6 +87,14 @@ class OptionManager
         @options[:ignore] = pattern
       end
 
+      opts.separator "
+        When using -I, always use '=' or quote the pattern, e.g.:
+            -I='_stack_*|*.yaml' -a
+            --ignore='_stack_*|*.yaml' -a
+          Multiple patterns can be separated by '|'.
+          Wildcards '*' and '?' are supported (like the 'tree' command).
+        Do not use -ad; use -a -d for combined flags.
+        "
     end.parse!
 
     if a_flag && d_flag

data/lib/mk_semi_lattice/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MkSemiLattice
-  VERSION = "0.3.1"
+  VERSION = "0.4.1"
 end

data/lib/mk_semi_lattice.rb

@@ -5,8 +5,14 @@ require 'yaml'
 require 'colorize'
 require 'rbconfig'
 require 'fileutils'
+require 'thor'
 
 require_relative "mk_semi_lattice/version"
+#require_relative "mk_semi_lattice/ruby2d_run"
+
+
+class Error < StandardError; end
+
 require_relative "mk_semi_lattice/ruby2d_action"
 require_relative "mk_semi_lattice/init_env"
 require_relative "mk_semi_lattice/option_manager"
@@ -14,9 +20,6 @@ require_relative "mk_semi_lattice/manage_yaml/mk_node_edge_yaml"
 require_relative "mk_semi_lattice/manage_yaml/mk_semi_lattice_yaml"
 require_relative "mk_semi_lattice/sl_components"
 
-class Error < StandardError; end
-
-
 def init
   puts "mk_semi_lattice is running..."
 
@@ -92,3 +95,5 @@ if defined?(RSpec) || defined?(Minitest)
 else
   ruby2d_run(*init())
 end
+
+

data/lib/mk_stack/.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "chat.agent.enabled": false,
+  "github.copilot.chat.codesearch.enabled": true,
+}

data/lib/mk_stack/docs/readme.html

@@ -0,0 +1,142 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="jp" xml:lang="jp">
+<head>
+<!-- 2026-01-06 Tue 16:19 -->
+<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>hc stack</title>
+<meta name="author" content="Shigeto R. Nishitani" />
+<meta name="generator" content="Org Mode" />
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/htmlize.css"/>
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/readtheorg.css"/>
+<link rel="stylesheet" type="text/css" href="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/css/code-copy.css"/>
+<link rel="stylesheet" type="text/css" href="src/readtheorg_theme/css/search.css"/>
+<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.3/jquery.min.js"></script>
+<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/lib/js/jquery.stickytableheaders.min.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/search.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/readtheorg.js"></script>
+<script type="text/javascript" src="https://fniessen.github.io/org-html-themes/src/readtheorg_theme/js/code-copy.js"></script>
+</head>
+<body>
+<div id="content" class="content">
+<h1 class="title">hc stack</h1>
+<div id="table-of-contents" role="doc-toc">
+<h2>Table of Contents</h2>
+<div id="text-table-of-contents" role="doc-toc">
+<ul>
+<li><a href="#org77f9c3b">1. Name</a></li>
+<li><a href="#org71c4689">2. Help</a></li>
+<li><a href="#org26b5647">3. What does 'stack' do?</a></li>
+</ul>
+</div>
+</div>
+<div id="outline-container-org77f9c3b" class="outline-2">
+<h2 id="org77f9c3b"><span class="section-number-2">1.</span> Name</h2>
+<div class="outline-text-2" id="text-1">
+<p>
+make stack structures.
+</p>
+
+<ul class="org-ul">
+<li>gitのrepositoryのように，
+<ul class="org-ul">
+<li>新しい作業を始める前に，</li>
+<li>バックアップの'stack'構造を作成するコマンドです．</li>
+</ul></li>
+<li>安心してcodeやdocsの改変に取り組むことが可能です．
+<ul class="org-ul">
+<li>gitに慣れると手戻り(rewind)ができるようになりますが，</li>
+<li>初心者が，いつでも過去のファイルを直接参照できるので，</li>
+<li>安心です．</li>
+</ul></li>
+</ul>
+</div>
+</div>
+<div id="outline-container-org71c4689" class="outline-2">
+<h2 id="org71c4689"><span class="section-number-2">2.</span> Help</h2>
+<div class="outline-text-2" id="text-2">
+<div class="org-src-container">
+<pre class="src src-bash">&gt; hc stack -h
+Usage: hc stack [options]
+    -n, --number=NUMBER              Add ordinal number
+    -d, --dryrun                     Dry run (<span style="color: #1c86ee;">do</span> not move or create anything)
+</pre>
+</div>
+</div>
+</div>
+<div id="outline-container-org26b5647" class="outline-2">
+<h2 id="org26b5647"><span class="section-number-2">3.</span> What does 'stack' do?</h2>
+<div class="outline-text-2" id="text-3">
+<table border="2" cellspacing="0" cellpadding="6" rules="groups" frame="hsides">
+
+
+<colgroup>
+<col  class="org-left" />
+</colgroup>
+<tbody>
+<tr>
+<td class="org-left"><img src="./mk_stack/mk_stack.001.png" alt="mk_stack.001.png" /></td>
+</tr>
+
+<tr>
+<td class="org-left">stack動作のポンチ絵.</td>
+</tr>
+</tbody>
+</table>
+
+<p>
+stackという動作名称は，昔のHyperCardシステムからの借用です．
+</p>
+
+<p>
+やってることは，current directoryで新しい_stack_ordinal_yymmdd という
+名前のdirectoryを作成し，そこに全てのファイル，directoryを
+移すという操作です．
+</p>
+
+<p>
+この後，
+</p>
+<ul class="org-ul">
+<li>directory名の修正</li>
+<li>必要なファイルの移動，copy</li>
+</ul>
+<p>
+を行い，新しく作業を上書きしていくことになります．
+昔のファイルを参照することが多い作業者には，便利なはずです．
+</p>
+
+<p>
+特に，mdでChatGPTとの会話を記録する必要がある作業者は，
+その場でmdを保存すると，
+</p>
+<ul class="org-ul">
+<li>treeコマンドで過去の履歴が一望，</li>
+<li>そこへcdすれば，その時の環境ですぐに検証可能，</li>
+<li>_stack_ordinal_yymmdd -&gt; .stack_ordinal_yymmdd</li>
+<li>などとhiddenにすることも容易
+<ul class="org-ul">
+<li>不要なmd, code fileなどを隠す</li>
+</ul></li>
+</ul>
+<p>
+ができます．
+</p>
+
+<p>
+整理の基本となる，chunking, tight bindingを
+強制するシステムコマンドです．ご活用ください．
+</p>
+</div>
+</div>
+</div>
+<div id="postamble" class="status">
+<p class="author">Author: Shigeto R. Nishitani</p>
+<p class="date">Created: 2026-01-06 Tue 16:19</p>
+<p class="validation"><a href="https://validator.w3.org/check?uri=referer">Validate</a></p>
+</div>
+</body>
+</html>

data/lib/mk_stack/docs/readme.org

@@ -0,0 +1,55 @@
+#+OPTIONS: ^:{}
+#+STARTUP: indent nolineimages overview num
+#+TITLE: hc stack
+#+AUTHOR: Shigeto R. Nishitani
+#+EMAIL:     (concat "shigeto_nishitani@mac.com")
+#+LANGUAGE:  jp
+#+OPTIONS:   H:4 toc:t num:2
+#+SETUPFILE: https://fniessen.github.io/org-html-themes/org/theme-readtheorg.setup
+
+* Name
+make stack structures.
+
+- gitのrepositoryのように，
+  - 新しい作業を始める前に，
+  - バックアップの'stack'構造を作成するコマンドです．
+- 安心してcodeやdocsの改変に取り組むことが可能です．
+  - gitに慣れると手戻り(rewind)ができるようになりますが，
+  - 初心者が，いつでも過去のファイルを直接参照できるので，
+  - 安心です．
+
+* Help
+#+begin_src bash
+> hc stack -h
+Usage: hc stack [options]
+    -n, --number=NUMBER              Add ordinal number
+    -d, --dryrun                     Dry run (do not move or create anything)
+#+end_src
+
+* What does 'stack' do?
+| [[./mk_stack/mk_stack.001.png]]
+| stack動作のポンチ絵.
+
+stackという動作名称は，昔のHyperCardシステムからの借用です．
+
+やってることは，current directoryで新しい_stack_ordinal_yymmdd という
+名前のdirectoryを作成し，そこに全てのファイル，directoryを
+移すという操作です．
+
+この後，
+- directory名の修正
+- 必要なファイルの移動，copy
+を行い，新しく作業を上書きしていくことになります．
+昔のファイルを参照することが多い作業者には，便利なはずです．
+
+特に，mdでChatGPTとの会話を記録する必要がある作業者は，
+その場でmdを保存すると，
+- treeコマンドで過去の履歴が一望，
+- そこへcdすれば，その時の環境ですぐに検証可能，
+- _stack_ordinal_yymmdd -> .stack_ordinal_yymmdd
+- などとhiddenにすることも容易
+  - 不要なmd, code fileなどを隠す
+ができます．
+
+整理の基本となる，chunking, tight bindingを
+強制するシステムコマンドです．ご活用ください．