22#
33# Inspired by https://github.com/kubernetes/website/blob/main/scripts/lsync.sh
44
5+ DEFAULT_LANG=" en"
6+ DEFAULT_TARGET=" content"
57EXTRA_DIFF_ARGS=" --numstat"
8+ FLAG_UPDATE=" "
9+ FLAG_VERBOSE=" "
10+ I18N_DLC_KEY=" default_lang_commit"
611TARGET_PATHS=" "
712
813function _usage() {
914 cat << EOS
10- Usage: $( basename " $0 " )
15+ Usage: $( basename " $0 " ) [ TARGET_PATH ...]
1116
1217 For each localized page target, this script reports whether the English
1318 language version of that page has changed since the localized file was
1419 first written or last edited.
1520
1621 TARGET_PATH can be a single markdown file of a localized page, such as
1722 'content/ja/_index.md', or a directory of localized pages, such as 'content/ja'.
23+ The default TARGET_PATH is '$DEFAULT_TARGET '.
1824
1925 -h Output this usage info.
2026 -d Output diff details.
21- -v Verbose mode.
27+ -u Update, or add, target commit hashes to match the last commit they were updated from.
28+ -v Enables verbose command progress and status output.
2229EOS
2330}
2431
@@ -29,16 +36,19 @@ function usage() {
2936}
3037
3138function process_CLI_args() {
32- while getopts " :hdv " ; do
39+ while getopts " :hduv " ; do
3340 case $opt in
3441 h)
3542 usage
3643 ;;
3744 d)
3845 EXTRA_DIFF_ARGS=" "
3946 ;;
47+ u)
48+ FLAG_UPDATE=1
49+ ;;
4050 v)
41- VERBOSE =1
51+ FLAG_VERBOSE =1
4252 ;;
4353 \? )
4454 echo " ERROR: unrecognized flag: -$OPTARG "
@@ -48,48 +58,79 @@ function process_CLI_args() {
4858 done
4959
5060 shift $(( OPTIND- 1 ))
51- if [ " $# " -lt 1 ]; then
52- echo " ERROR: target path argument is missing" >&2
53- usage 1
54- fi
55-
5661 TARGET_PATHS=" $@ "
5762
63+ if [[ -z " $TARGET_PATHS " ; then
64+ TARGET_PATHS=" $DEFAULT_TARGET "
65+ if [[ -n $FLAG_VERBOSE ]]; then echo " INFO: using default target path: $TARGET_PATHS " ; fi
66+ fi
67+
5868 if [[ -f " TARGET_PATHS" && ! -e " $TARGET_PATHS " ; then
5969 echo " Path not found: '$TARGET_PATHS '" >&2
6070 exit 2
6171 fi
6272}
6373
74+ function update_i18n_hash() {
75+ # Usage: update_i18n_hash <file> <commit>
76+ #
77+ # Adds to or updates the file's front matter's field
78+ # $I18N_DLC_KEY with value <commit>.
79+
80+ local LASTCOMMIT=" $1 "
81+ local f=" $2 "
82+
83+ if grep -q " ^$I18N_DLC_KEY :" " $f " ; then
84+ perl -i -pe " s/(^$I18N_DLC_KEY ):.*/\$ 1: $LASTCOMMIT /" " $f "
85+ else
86+ perl -i -0777 -pe " s/^(---.*?)(\n---\n)/\$ 1\n$I18N_DLC_KEY : $LASTCOMMIT \$ 2/sm" " $f "
87+ fi
88+ if [[ -n $FLAG_VERBOSE ]]; then
89+ echo -e " i18n commit ID\t$f $LASTCOMMIT - updated"
90+ fi
91+ }
92+
6493function main() {
6594 process_CLI_args " $@ "
6695
6796 if [ -f " $TARGET_PATHS " ; then
6897 TARGETS=" $TARGET_PATHS "
6998 else
70- TARGETS=$( find $TARGET_PATHS -name " *.md" )
99+ TARGETS=$( find $TARGET_PATHS -name " *.md" -not -path " */ $DEFAULT_LANG /* " )
71100 if [[ -z " $TARGETS " ; then
72101 echo " ERROR: target directory contains no markdown files: '$TARGET_PATHS '" >&2
73102 exit 1
74103 fi
75- # if [[ -n $VERBOSE ]]; then echo -e "All targets: $TARGETS"; fi
104+ # if [[ -n $FLAG_VERBOSE ]]; then echo -e "All targets: $TARGETS"; fi
76105 fi
77106
78107 SYNCED=1
79108 for f in $TARGETS ; do
80- # if [[ -n $VERBOSE ]]; then echo -e "Checking\t$f"; fi
109+ # if [[ -n $FLAG_VERBOSE ]]; then echo -e "Checking\t$f"; fi
81110 EN_VERSION=$( echo " $f " | sed " s/content\/.\{2,5\}\//content\/en\//g" )
111+
112+ # Try to get commit ref from file front matter
113+ LASTCOMMIT=$( perl -ne " print \"\$ 1\" if /^$I18N_DLC_KEY :\\ s*(.*)/" " $f " )
114+ if [[ -z $LASTCOMMIT ]]; then
115+ # Get commit hash from git commit info
116+ LASTCOMMIT=$( git log -n 1 --pretty=format:%h -- " $f " )
117+ fi
118+
119+ if [[ -n $FLAG_UPDATE ]]; then
120+ update_i18n_hash " $LASTCOMMIT " " $f "
121+ fi
122+
82123 if [[ ! -e " $EN_VERSION " ; then
83- echo " Base file renamed or removed: $EN_VERSION "
124+ echo -e " File not found\t $EN_VERSION - $f - $DEFAULT_LANG was removed or renamed "
84125 SYNCED=0
85126 continue
86127 fi
87128
88- LASTCOMMIT =$( git log -n 1 --pretty=format:%h -- " $f " )
89- git diff --exit-code $EXTRA_DIFF_ARGS $LASTCOMMIT ...HEAD " $EN_VERSION "
90- if [ $? -ne 0 ] ; then
129+ DIFF =$( git diff --exit-code $EXTRA_DIFF_ARGS $LASTCOMMIT ...HEAD " $EN_VERSION " )
130+ if [[ -n " $DIFF " ]] ; then # [[ $? -ne 0 ]]
131+ echo " $DIFF - $f "
91132 SYNCED=0
92- elif [[ -n $VERBOSE ]]; then
133+ elif [[ -n $FLAG_VERBOSE ]]; then
93134 echo -e " File is in sync\t$f "
94135 fi
95136 done
0 commit comments