Plaintext on Miro's World

Current Hugo setup on Github Pages

Fri, 22 Nov 2019 11:22:48 +0800

How does the blog setup and publishing work
#

Before I forget, here is how the current configuration works.

There are two repositories at play:

source repo - https://github.com/miroadamy/miroadamy.com
github pages repo (== GHPR) - https://github.com/miroadamy/miroadamy.github.io

The blog source repo contains only source files (.md, static media etc). This repo has usual submodules under the /themes - e.g. /themes/even which is one currently used.

From Jekyll to Hugo

Wed, 20 Nov 2019 23:22:48 +0800

I have decided to consolidate all piecemeal versions of my blogpost uder one roof and at the same to do these four things

technology upgrade - from Jekyll to Hugo
visual refresh of the page
review tagging and categorization
merge hidden posts from Wikis to one place

Why Hugo replaced Jekyll
#

The version 3 of my blog (see below for a bit of history) has been hosted on Github pages and using the default static site generators - Jekyll.

Recreate txt base graph generator

Tue, 09 Sep 2014 11:22:48 +0800

Graphviz
#

This time using brew

➜  DPS  brew install graphviz
==> Downloading https://downloads.sf.net/project/machomebrew/Bottles/graphviz-2.38.0.mavericks.bottle.tar.gz
######################################################################## 100.0%
==> Pouring graphviz-2.38.0.mavericks.bottle.tar.gz
🍺  /usr/local/Cellar/graphviz/2.38.0: 469 files, 68M
➜  DPS  dot -V
dot - graphviz version 2.38.0 (20140413.2041)
➜  DPS

Schema Spy
#

From http://sourceforge.net/projects/schemaspy/files/schemaspy/SchemaSpy%205.0.0/

To /opt/diagram

Run:

diagram java -jar ./schemaSpy_5.0.0.jar -cp .:/Users/miro/lib/jdbc/mysql-connector-java-5.1.26-bin.jar -t mysql -o library -host localhost -u training -db training_dev01 -p training

GitHub + Gollum vs BitBucket Wiki

Sat, 07 Apr 2012 11:22:48 +0800

both Wikis are backed by Git repo
both allow local edit

Gollum
#

See https://github.com/github/gollum#readme

Installation: http://alblue.bandlem.com/2011/05/git-tip-of-week-gollum.html

sudo gem install gollum

Running
#

git init TestWiki
gollum --page-file-dir wiki TestWiki
openurl http://localhost:4567

Parsers - separate install
#

gem install rdiscount
gem install wikicloth

Get Wiki for repo
#

git clone URL
  
URL:
- git@github.com:radegast/dotvim.wiki.git R+W
- https://radegast@github.com/radegast/dotvim.wiki.git R+W
- git://github.com/radegast/dotvim.wiki.git R

Pros
#

multiple markups
supports Markdown
List of all pages

Questions
#

How to link to page in subdir

ATG module graph

Mon, 02 Apr 2012 11:22:48 +0800

Notes from weekend hack:
#

Project is in Bitbucket - https://bitbucket.org/miroadamy/atgdiagram/overview

Run
#

in Diagrams/ATGDiagram

Radegast:ATGDiagram miro$ groovy -cp src src/listATGModules.groovy -e -m TWeStore.eStore >uml/test2.uml
Radegast:ATGDiagram miro$ ./processUml.sh uml/test2.uml
Radegast:ATGDiagram miro$ open uml/test2.png
Radegast:ATGDiagram miro$

=> Output test2.uml

the ‘.’ in names is converted to ‘_’ - GraphViz does not like it
the ‘-’ in names detto

Using ATG_ROOT from environment variable $ATG_ROOT: /opt/ATG/ATG10.0.2
Using /opt/ATG/ATG10.0.2 installation
Dependants of module TWeStore.eStore => [DCS.Search.Query, B2CCommerce, DAF.Search.Query, DAF.Search.Base, DCS.Search.common, DPS.Search.Index, DAF.Search.common, DAS-UI, DCS.Search.Index, DPS, DCS, DCS.Search.CustomCatalogs, DCS.Search.CustomCatalogs.Query, DCS.Search.CustomCatalogs.Index, DAF.Search.Routing, DCS.Search.CustomCatalogs.common, DAF.Search.Index, DSS, DCS.CustomCatalogs, DAS]
@startuml
Object TWeStore_eStore
Object DCS
Object B2CCommerce
Object DCS_Search_CustomCatalogs
Object DAF_Search_Routing
Object DCS_CustomCatalogs
Object DPS
Object DCS_Search_CustomCatalogs_Query
Object DAF_Search_Base
Object DCS_Search_CustomCatalogs_Index
Object DSS
Object DAS_UI
Object DCS_Search_Query
Object DCS_Search_CustomCatalogs_common
Object DAS
Object DCS_Search_Index
Object DAF_Search_Query
Object DCS_Search_common
Object DPS_Search_Index
Object DAF_Search_Index
Object DAF_Search_common
TWeStore_eStore <|-- DCS
TWeStore_eStore <|-- DCS_CustomCatalogs
TWeStore_eStore <|-- B2CCommerce
TWeStore_eStore <|-- DCS_Search_CustomCatalogs
TWeStore_eStore <|-- DAF_Search_Routing
DCS <|-- DPS
DCS <|-- DSS
B2CCommerce <|-- DCS
DCS_Search_CustomCatalogs <|-- DCS_Search_CustomCatalogs_Index
DCS_Search_CustomCatalogs <|-- DCS_Search_CustomCatalogs_Query
DAF_Search_Routing <|-- DAS_UI
DAF_Search_Routing <|-- DAF_Search_Base
DCS_CustomCatalogs <|-- DCS
DPS <|-- DAS
DCS_Search_CustomCatalogs_Query <|-- DCS_Search_Query
DCS_Search_CustomCatalogs_Query <|-- DCS_Search_CustomCatalogs_common
DAF_Search_Base <|-- DAS_UI
DCS_Search_CustomCatalogs_Index <|-- DCS_Search_Index
DCS_Search_CustomCatalogs_Index <|-- DCS_Search_CustomCatalogs_common
DSS <|-- DPS
DAS_UI <|-- DAS
DCS_Search_Query <|-- DAF_Search_Query
DCS_Search_Query <|-- DCS_Search_common
DCS_Search_Query <|-- DCS
DCS_Search_CustomCatalogs_common <|-- DCS_Search_common
DCS_Search_CustomCatalogs_common <|-- DCS_CustomCatalogs
DCS_Search_Index <|-- DPS_Search_Index
DCS_Search_Index <|-- DCS_Search_common
DCS_Search_Index <|-- DCS
DAF_Search_Query <|-- DAF_Search_common
DCS_Search_common <|-- DAF_Search_common
DCS_Search_common <|-- DCS
DPS_Search_Index <|-- DPS
DPS_Search_Index <|-- DAF_Search_Index
DAF_Search_Index <|-- DAS_UI
DAF_Search_Index <|-- DAF_Search_Base
DAF_Search_common <|-- DAS_UI
DAF_Search_common <|-- DAF_Search_Base
DAF_Search_common <|-- DAF_Search_Routing
@enduml

Visualization (uml/test2.png)
#

Diagram generation - plain text approach

Fri, 30 Mar 2012 11:22:48 +0800

GraphViz
#

installed from package
See http://www.graphviz.org/

Radegast:diagrams miro$ dot -V
dot - graphviz version 2.28.0 (20110509.1545)
 
 
Radegast:diagrams miro$ which dot
dot is /usr/local/bin/dot

SchemaSpy
#

installed in /opt/diagrams
see http://schemaspy.sourceforge.net/

Radegast:schemaSpy miro$ java -jar ./schemaSpy_5.0.0.jar -cp .:/Users/miro/lib/java/jdbc/mysql-connector-java-5.1.7-bin.jar -t mysql -o library -host localhost -u twt_dX_core -db twt_dX_core -p twt_dX_core
Using database properties:
  [./schemaSpy_5.0.0.jar]/net/sourceforge/schemaspy/dbTypes/mysql.properties
Gathering schema details....................................................................................................................................................................................................................................................................................................................................................(36sec)
Writing/graphing summary.....
.......(353sec)
Writing/diagramming details.................................................................................................................................................................................................................................................................................................................................................(104sec)
Wrote relationship details of 337 tables/views to directory 'library' in 494 seconds.
View the results by opening library/index.html
Radegast:schemaSpy miro$
Radegast:schemaSpy miro$ ll
total 904

PlantUML
#

installed in /opt/diagrams
manual is attached: PlantUML Language Reference Guide.pdf
See http://plantuml.sourceforge.net/classes.html
in /opt/plantUML-DEMO/ there are sample files

@startuml img/sequence_img009.png   
  
Alice -> Bob: Authentication Request
alt successful case
    Bob -> Alice: Authentication Accepted
     
else some kind of failure
    Bob -> Alice: Authentication Failure
 
    group My own label
    Alice -> Log : Log attack start
        loop 1000       times
            Alice -> Bob: DNS Attack
        end
    Alice -> Log : Log attack end
    end
     
else Another type of failure
   Bob -> Alice: Please repeat
    
end
@enduml

Using Wiki markup without a Wiki

Thu, 17 May 2007 22:10:44 -0400

Even with having Wiki as the main documentation repository, not all documentation ends up in a Wiki. Some documentation needs to be managed as part of the source tree - e.g. Readme's, compilation instructions and similar. This information is usually either plain text or in some form of text processor format, mostly Microsoft Word compatible. Both have their selection of problems. Word documents are large, bloated, harder to version controlled and not readable in shell environment (try to cat or tail Word document :-)). The plain text format lacks visual structure and without headlines, bold/italic, font sizes etc is harder read.

Plaintext on Miro's World

Current Hugo setup on Github Pages

How does the blog setup and publishing work #

From Jekyll to Hugo

Why Hugo replaced Jekyll #

Recreate txt base graph generator

Graphviz #

Schema Spy #

GitHub + Gollum vs BitBucket Wiki

Gollum #

Running #

Parsers - separate install #

Get Wiki for repo #

Pros #

Questions #