Update to 2.3.1:

* Fix: Compatibility with sqlite3 version >= 3.52.0

Changelog

@@ -0,0 +1,40 @@
+2.3.1:
+  * Fix: Compatibility with sqlite3 version >= 3.52.0
+
+2.3:
+
+  * New: access 'url' entry in sqlite databases.
+
+2.2.1:
+
+  * Fix: Missing quotes in filter interpreter.
+
+
+2.2:
+
+  * New: Allow for the value of other entries to be in the 'sed' command of a
+	 filter. (May break existing configurations in cases where sed command
+	 uses a '%'.)
+
+2.1.5:
+
+  * Fixed: Properly escape entries with a '%'
+
+
+2.1.4:
+
+  * New: Allow for comma separated list of references in aux_cmd.
+
+
+2.1.3:
+
+  * Fixed: entries that contain a '%' do not cause a failure.
+
+  * New: access 'bibtex' entry in sqlite databases
+
+
+2.1.2:
+
+  * Fixed: 'extra' entries would override database entries if they shared the
+           same token
+

Makefile

@@ -1,4 +1,4 @@
-## Copyright Ian Jauslin 2015-2017
+## Copyright Ian Jauslin 2015-2023
 ## 
 ## Licensed under the Apache License, Version 2.0 (the "License");
 ## you may not use this file except in compliance with the License.

NOTICE

@@ -1,2 +1,2 @@
 BBlog
-Copyright Ian Jauslin 2015-2017
+Copyright Ian Jauslin 2015-2026

bin/BBlog

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-## Copyright Ian Jauslin 2015-2017
+## Copyright Ian Jauslin 2015-2026
 ## 
 ## Licensed under the Apache License, Version 2.0 (the "License");
 ## you may not use this file except in compliance with the License.
@@ -15,11 +15,10 @@
 ## limitations under the License.
 
 # directory containing the engine files
-enginedir=/usr/share/BBlog/engines
-enginedir=/home/ian/Programs/BBlog2/engines
+enginedir=/home/ian/Programs/BBlog2/src/engines
 
 # version
-version=2.1
+version=2.3.1
 
 function print_config {
   echo "engine: $engine"
@@ -223,18 +222,27 @@ function replace_format {
 
     # apply filter
     if [ -n "$filter" ]; then
-      sed_cmd=$(eval "echo \$filter_$filter")
+      # replace '%' inside filter text
+      sed_cmd=$(replace_format "$(eval echo \$filter_$filter)")
       replacement=$(eval "echo \$$field" | sed -r "$sed_cmd" )
     else
       replacement=$(eval "echo \$$field")
     fi
   
+    # escape '%' in replacement
+    replacement="${replacement//\%/::iansays:percent::}"
+
+
     out="${out//\%$command\%/$replacement}"
   done
 
   # finish replacing newlines
   out="${out//\\n/%}"
   out=$(echo "$out" | tr "%" "\n")
+
+  # un-escape '%' in replacement
+  out="${out//::iansays:percent::/\%}"
+
   echo "$out"
 }
 
@@ -266,17 +274,20 @@ function inverse_map_citeref {
 
   foundref=0
   # sift through aux file
-  grep -h "$aux_cmd" $aux | while read -r ref; do
-    eval "ref=\${ref#$aux_cmd}"
-    ref="${ref%\}}"
-    # replace the ref via the ref_map
-    possibleref=$(map_citeref "$ref")
-    # check whether the ref is the right one
-    if [ "$possibleref" = "$newref" ]; then
-      echo "$ref"
-      foundref=1
-      return 1
-    fi
+  grep -h "$aux_cmd" $aux | while read -r refs; do
+    eval "refs=\${refs#$aux_cmd}"
+    refs="${ref%\}}"
+    # can be a comma separated list
+    for ref in $(echo -n "$refs" | tr ',' '\n'); do
+      # replace the ref via the ref_map
+      possibleref=$(map_citeref "$ref")
+      # check whether the ref is the right one
+      if [ "$possibleref" = "$newref" ]; then
+	echo "$ref"
+	foundref=1
+	return 1
+      fi
+    done
   done && echo "$foundref$newref"
 }
 

engines/sqlite.sh

@@ -1,5 +1,5 @@
-base_SQL="SELECT title,author,journal,year,token,doi,arxiv,citeref,prauth FROM bibliography"
-base_SQL_noprauth="SELECT title,author,journal,year,token,doi,arxiv,citeref FROM bibliography"
+base_SQL="SELECT title,author,journal,year,token,doi,arxiv,citeref,prauth,bibtex,url FROM bibliography"
+base_SQL_noprauth="SELECT title,author,journal,year,token,doi,arxiv,citeref,bibtex,url FROM bibliography"
 
 # add quotes
 function SQL_addquotes {
@@ -7,7 +7,6 @@ function SQL_addquotes {
     # add quotes and escape string
     if [ -n "$line" ]; then
       line=$(escape_string "$line")
-      line="${line/%=/= }"
       line="${line/ = /=\"}"
       line="${line/%/\"}"
     fi
@@ -23,69 +22,17 @@ function generate_SQL_alpha {
   exists_citeref=0
 
   # sift through aux file
-  grep -h "$aux_cmd" $aux | while read -r citeref; do
-    eval "citeref=\${citeref#$aux_cmd}"
-    citeref="${citeref%\}}"
+  grep -h "$aux_cmd" $aux | while read -r citerefs; do
+    eval "citerefs=\${citerefs#$aux_cmd}"
+    citerefs="${citerefs%\}}"
 
-    # replace the citeref with a ref_map if there is any
-    if [ -n "$ref_map" ]; then
-      citeref=$(map_citeref "$citeref")
-    fi
+    # can be a comma separated list
+    for citeref in $(echo -n "$citerefs" | tr ',' '\n'); do
 
-    # Only query the db if there is no matching extra entry
-    foundit=0
-    if [ ${#extra} -gt 0 ]; then
-      for entry in "${extra[@]}"; do
-	ref="${entry#*:*:}"
-	ref="${ref%%:*}"
-	if [ "$ref" = "$citeref" ]; then
-	  foundit=1
-	  break
-	fi
-      done
-    fi
-    
-    if [ "$foundit" = 0 ]; then
-      echo -n "$citeref' OR citeref='"
-      exists_citeref=1
-    fi
-  done
-
-  # if there are no citerefs close '
-  [ $exists_citeref = 0 ] && echo -n "'"
-}
-
-# fetch entries by alphabetical order
-function fetch_BBlog_entries_alpha {
-  SQL="$(generate_SQL_alpha)"
-  SQL="${SQL% OR citeref=\'} ORDER BY prauth,year"
-  sqlite3 -line "$db" "$SQL" | SQL_addquotes
-  # add an empty line
-  echo ""
-}
-
-# fetch entries by order of appearance
-function fetch_BBlog_entries_appearance {
-  # keep track of citerefs to avoid repetitions
-  citeref_list=""
-
-  # sift through aux file
-  grep -h "$aux_cmd" $aux | while read -r citeref; do
-    eval "citeref=\${citeref#$aux_cmd}"
-    citeref="${citeref%\}}"
-
-    # replace the citeref with a ref_map if there is any
-    if [ -n "$ref_map" ]; then
-      citeref=$(map_citeref "$citeref")
-    fi
-
-    # check whether the reference was already cited
-    citeref_list="$citeref_list;"
-    if $(echo "$citeref_list" | grep -q ";$citeref;"); then
-      # remove trailing ';'
-      citeref_list="${citeref_list%;}"
-    else
-      citeref_list="$citeref_list$citeref"
+      # replace the citeref with a ref_map if there is any
+      if [ -n "$ref_map" ]; then
+	citeref=$(map_citeref "$citeref")
+      fi
 
       # Only query the db if there is no matching extra entry
       foundit=0
@@ -101,15 +48,75 @@ function fetch_BBlog_entries_appearance {
       fi
       
       if [ "$foundit" = 0 ]; then
-	SQL="$base_SQL_noprauth WHERE citeref='$citeref'"
-	sqlite3 -line "$db" "$SQL" | SQL_addquotes
-      else
-	echo "citeref=$citeref"
+	echo -n "$citeref' OR citeref='"
+	exists_citeref=1
+      fi
+    done
+  done
+
+  # if there are no citerefs close '
+  [ $exists_citeref = 0 ] && echo -n "'"
+}
+
+# fetch entries by alphabetical order
+function fetch_BBlog_entries_alpha {
+  SQL="$(generate_SQL_alpha)"
+  SQL="${SQL% OR citeref=\'} ORDER BY prauth,year"
+  sqlite3 "$db" ".mode line --colsep ' = '" "$SQL" | SQL_addquotes
+  # add an empty line
+  echo ""
+}
+
+# fetch entries by order of appearance
+function fetch_BBlog_entries_appearance {
+  # keep track of citerefs to avoid repetitions
+  citeref_list=""
+
+  # sift through aux file
+  grep -h "$aux_cmd" $aux | while read -r citerefs; do
+    eval "citerefs=\${citerefs#$aux_cmd}"
+    citerefs="${citerefs%\}}"
+
+    # can be a comma separated list
+    for citeref in $(echo -n "$citerefs" | tr ',' '\n'); do
+
+      # replace the citeref with a ref_map if there is any
+      if [ -n "$ref_map" ]; then
+	citeref=$(map_citeref "$citeref")
       fi
 
-      # add an empty line
-      echo ""
-    fi
+      # check whether the reference was already cited
+      citeref_list="$citeref_list;"
+      if $(echo "$citeref_list" | grep -q ";$citeref;"); then
+	# remove trailing ';'
+	citeref_list="${citeref_list%;}"
+      else
+	citeref_list="$citeref_list$citeref"
+
+	# Only query the db if there is no matching extra entry
+	foundit=0
+	if [ ${#extra} -gt 0 ]; then
+	  for entry in "${extra[@]}"; do
+	    ref="${entry#*:}"
+	    ref="${ref%%:*}"
+	    if [ "$ref" = "$citeref" ]; then
+	      foundit=1
+	      break
+	    fi
+	  done
+	fi
+	
+	if [ "$foundit" = 0 ]; then
+	  SQL="$base_SQL_noprauth WHERE citeref='$citeref'"
+	  sqlite3 -line "$db" "$SQL" | SQL_addquotes
+	else
+	  echo "citeref=$citeref"
+	fi
+
+	# add an empty line
+	echo ""
+      fi
+    done
   done
 }
 

man/man1/BBlog.1

@@ -1,5 +1,5 @@
-.Dd $Mdocdate: May 2 2017 $
-.Dt BBLOG 2.1
+.Dd $Mdocdate: July 26 2026 $
+.Dt BBLOG 2.3.1
 .Os
 .Sh NAME
 .Nm BBlog
@@ -194,6 +194,6 @@ automatically adds a letter (from 'b' to 'z') at the end of non-unique tokens, i
 .Nm
 was written by Ian Jauslin.
 .Sh COPYRIGHT
-copyright Ian Jauslin 2015-2017
+copyright Ian Jauslin 2015-2026
 .Sh SEE ALSO
 .Sx BBlog-sqlite Ns (7)

man/man7/BBlog-sqlite.7

@@ -1,4 +1,4 @@
-.Dd $Mdocdate: May 2 2017 $
+.Dd $Mdocdate: July 26 2026 $
 .Dt BBLOG-sqlite
 .Os
 .Sh DESCRIPTION
@@ -28,11 +28,13 @@ label of the reference
 .It prauth
 bibliography entries are ordered alphabetically with respect to this entry
 label of the reference
+.It url
+link to paper
 .El
 .Sh AUTHORS
 The sqlite BBlog engine was written by Ian Jauslin.
 .Sh COPYRIGHT
-copyright Ian Jauslin 2015-2017
+copyright Ian Jauslin 2015-2026
 .Sh SEE ALSO
 .Sx BBlog Ns (1) ,
 .Sx sqlite3 Ns (1)