Makefile
author Oleksandr Gavenko <gavenkoa@gmail.com>
Tue, 10 Jul 2012 19:25:18 +0300
changeset 206 407f2a82ef26
parent 204 f93358e8be5b
child 207 3c96103ced32
permissions -rw-r--r--
Include common header for quick links. Exclude unnecessary .html files from build.

# To build dictionary you need to install:
#
#    $ sudo apt-get install dictfmt
#
# Available target:
#
#   all         build dictionaries
#   install     install dictionaries, so they been available in stardict, may require root permission
#   uninstall   remove dictionaries, they been unavailable in stardict, may require root permission
#   install-local install dictionaries in user HOME dir, so they been available in stardict for that user
#   uninstall-local remove dictionaries from user HOME directory
#   install-local-symlink create symlink from installed dir to user HOME dir, so dictionaries been available in stardict
#   uninstall-local-symlink remove symlink from user HOME directory
#
# You can override such variables in Makefile.config:
#
#   SF_USER     SourceForge user name.
#   prefix      Prefix to install path.
#   DESTDIR     Prefix to 'prefix' variable value.

SHELL = /bin/sh
export PATH := /bin:/usr/bin:${PATH}

# Disable built in pattern rules.
MAKEFLAGS += -r
# Disable built in variables.
MAKEFLAGS += -R
# Disable built in suffix rules.
.SUFFIXES:
# Default target.
.DEFAULT_GOAL = help

################################################################
# Build script definitions.

BUILD_SCRIPTS := $(firstword $(MAKEFILE_LIST))

ifneq '' '$(wildcard Makefile.config)'
  include Makefile.config
  BUILD_SCRIPTS += Makefile.config
endif

################################################################
# Version extracting/generation.

# Prevent from deploying and distributing with wrong version.
ifneq '' '$(filter deploy% dist%,$(MAKECMDGOALS))'
  ifeq '' '$(MAKE_RESTARTS)'
    $(info $(shell rm VERSION))
  endif
endif

# Here are vmajor and vminor. Look README section "Versioning rules."
-include VERSION

VERSION:
	\
vtagdist=$$(hg log -r . --template '{latesttagdistance}'); \
vatrelease=$$([ $$vtagdist -le 1 ] && echo yes || echo no); \
vtag=$$(hg log -r . --template '{latesttag}'); \
vmajor=$${vtag#t}; \
vmajor=$${vmajor%%.*}; \
vminor=$${vtag#*.}; \
vrev=$$(hg id -i); \
visclean=$$(case $$vrev in *+) echo no;; *) echo yes;; esac); \
vrev=$${vrev%+}; \
{ \
echo "vrev=$$vrev"; \
echo "vtag=$$vtag"; \
echo "vtagdist=$$vtagdist"; \
echo "visclean=$$visclean"; \
echo "vatrelease=$$vatrelease"; \
echo "vmajor=$$vmajor"; \
echo "vminor=$$vminor"; \
} >VERSION

################################################################
# Determine platform/environment.

host_os = unix
ifneq '' '$(COMSPEC)'
  ifneq '' '$(WINDIR)'
    # Probably under Windows.
    host_os = windows
    ifneq '' '$(wildcard /etc/setup/*cygwin*)'
      # Probably under Cygwin.
      host_os = cygwin
    endif
  endif
endif

################################################################
# Build tools definition/switches.

INSTALL = install
INSTALL_PROGRAM = $(INSTALL)
INSTALL_DATA = $(INSTALL) -m 644

RST_WARNING_FLAGS := --halt warning
RST_FLAGS := --strip-comments
RST_FLAGS += $(RST_WARNING_FLAGS)

RST2HTML := rst2html
ifeq '$(host_os)' 'cygwin'
  RST2HTML := rst2html.py
endif
RST2HTML_FLAGS := $(RST_FLAGS)

################################################################
# Install paths.

ifeq '$(origin prefix)' 'undefined'
  ifeq '$(shell id -u)' '0'
    prefix = /usr/local
  else
    prefix = $(HOME)/usr
  endif
endif
datarootdir := $(DESTDIR)$(prefix)/share
datadir = $(datarootdir)/dictd

################################################################
# Project dirs/files.

C5_FILES := $(wildcard *.dict-c5)
DICT_FILES := $(C5_FILES:.dict-c5=.dict)
DICTDZ_FILES := $(C5_FILES:.dict-c5=.dict.dz)
INDEX_FILES := $(C5_FILES:.dict-c5=.index)

RST_FILES := $(sort $(wildcard *.rst) STAT.rst VERSION.rst)
HTML_FILES := $(filter-out VERSION.html header.html,$(RST_FILES:.rst=.html))

pkgname = gadict
fullpkgname = $(pkgname)-$(vmajor).$(vminor)

DIST_DIR = $(fullpkgname)
DISTSRC_DIR = $(fullpkgname)_src

DIST_FILES = $(DICTDZ_FILES) $(INDEX_FILES) $(HTML_FILES) $(RST_FILES) VERSION

DISTSRC_HELPER_FILES = VERSION Makefile rst.css .dir-locals.el
DISTSRC_FILES = $(C5_FILES) $(RST_FILES) $(DISTSRC_HELPER_FILES)

DIST_TARBALLS = $(DIST_DIR).tar.gz $(DIST_DIR).tar.bz2
DISTSRC_TARBALLS = $(DISTSRC_DIR).tar.gz $(DISTSRC_DIR).tar.bz2

################################################################
# Deploy targets.

ifeq '' '$(SF_USER)'
  SF_USER := gavenkoa
endif

.PHONY: deploy
deploy: deploy2sf

# First time you deploy to SourceForge (sf) you need manually login to:
#   $ sftp $(SF_USER),$(pkgname)@web.sourceforge.net
# as it may require interactive input for accepting server public key.
# Next time any action fully automated.

.PHONY: deploy2sf
deploy2sf: deploy2sf-doc deploy2sf-release deploy2sf-src

# Will be accessed via http://$(pkgname).sourceforge.net
.PHONY: deploy2sf-doc
deploy2sf-doc: deploy-check $(HTML_FILES)
	( echo 'cd htdocs'; \
for f in $(HTML_FILES); do \
  echo "put $$f"; \
  echo "chmod 644 $$f"; \
done; \
echo 'quit'; \
) | sftp -b - $(SF_USER),$(pkgname)@web.sourceforge.net

.PHONY: deploy2sf-release
deploy2sf-release: deploy-check $(DIST_TARBALLS) $(DISTSRC_TARBALLS)
	( echo 'cd /home/frs/project/g/ga/gadict'; \
echo "put CHANGES.rst"; \
echo "chmod 644 CHANGES.rst"; \
echo "put  README.rst"; \
echo "chmod 644 README.rst"; \
echo "mkdir v$(vmajor).$(vminor)"; \
echo "cd v$(vmajor).$(vminor)"; \
for f in $(DIST_TARBALLS) $(DISTSRC_TARBALLS); do \
	echo "put $$f"; \
	echo "chmod 644 $$f"; \
done; \
echo 'quit'; \
) | sftp -b - $(SF_USER),$(pkgname)@frs.sourceforge.net

.PHONY: deploy2sf-src
deploy2sf-src:
	hg push ssh://$(SF_USER)@hg.code.sf.net/p/$(pkgname)/code

.PHONY: deploy-check
deploy-check:
	case ${visclean} in \
		no) echo "Local changes found. Build stop."; \
			exit 1;; \
	esac
	case $(vatrelease) in \
		no) echo "We are not at release. Build stop."; \
			exit 1;; \
	esac

################################################################
# Dist targets.

.PHONY: dist
dist: dist-dictd dist-src

.PHONY: dist-dictd
dist-dictd: $(DIST_TARBALLS)

.PHONY: dist-src
dist-src: $(DISTSRC_TARBALLS)

%.tar.gz: %
	tar zcf $*.tar.gz $*

%.tar.bz2: %
	tar jcf $*.tar.bz2 $*

$(DIST_DIR): $(DIST_FILES)
	rm -rf $@
	mkdir $@
	cp $(DIST_FILES) $@

$(DISTSRC_DIR): $(DISTSRC_FILES)
	rm -rf $@
	mkdir $@
	cp $(DISTSRC_FILES) $@

################################################################
# Build targets.

.PHONY: all
all: dist

.PHONY: dist
dist: $(DICTDZ_FILES) $(INDEX_FILES)

#  --case-sensitive
%.dict %.index: %.dict-c5
	sed '/^#/d' $< | dictfmt  -c5 \
	--headword-separator '; ' --break-headwords \
	--utf8 --allchars \
	-u "`sed -n '\|http://[[:print:]]\+/|{s=^.*\(http://\)=\1=;p;q;}' $<`" \
	-s "`sed -n '/^ABOUT: /{s=ABOUT: ==;p;q;}' $<`" \
	$*

%.dict.dz: %.dict
	dictzip -c $< >$@

################################################################
# Install/uninstall targets.

.PHONY: install
install: $(DICTDZ_FILES) $(INDEX_FILES)
	mkdir -p $(datadir)
	for f in $(DICTDZ_FILES) $(INDEX_FILES); do \
		$(INSTALL_DATA) $$f $(datadir); \
	done

.PHONY: uninstall
uninstall:
	for f in $(DICTDZ_FILES) $(INDEX_FILES); do \
		rm -f $(datadir)/$$f; \
	done

################################################################
# Documentation targets.

.PHONY: html
html: $(HTML_FILES)

$(HTML_FILES): %.html: %.rst header.rst rst.css VERSION.rst $(BUILD_SCRIPTS)
	$(RST2HTML) $(RST2HTML_FLAGS) --stylesheet=rst.css $*.rst $@

VERSION.rst: VERSION $(BUILD_SCRIPTS)
	{ \
	echo 'For ``$(pkgname)`` version: ``$(vmajor).$(vminor)``.'; \
	echo; \
	case ${visclean} in \
		yes) echo 'Source files are at revision: ``$(vrev)``.';; \
		no) echo 'Some source files was modified from revision: ``$(vrev)``.';; \
	esac; \
	echo; \
	case ${vatrelease} in \
		yes) echo 'Package is at release state.';; \
		no) echo 'Package is far from release state by $(vtagdist) changes.';; \
	esac; \
	echo; \
	echo 'Build date: ``'$$(date +%F)'``.'; \
	} >$@

################################################################
# Helpers targets.

.PHONY: help
help:
	@\
echo; \
echo Current configuration:; \
echo; \
sed 's=^=  =' <VERSION
	@if [ -f Makefile.config ]; then \
		echo; \
		echo User configuration:; \
		echo; \
		sed 's=^=  =' <Makefile.config; \
	fi
	@\
echo; \
echo Supported targets:; \
echo; \
sed -n -e '/^[[:alnum:]_-]*:/{s=^\(.*\):.*=  \1=;p;}' $(BUILD_SCRIPTS)

.PHONY: stat
stat: STAT.rst

STAT.rst: $(C5_FILES) header.rst VERSION.rst $(BUILD_SCRIPTS)
	{ \
echo '.. include:: header.rst'; \
echo; \
echo '============================'; \
echo ' gadict project statistics.'; \
echo '============================'; \
echo '.. contents::'; \
echo; \
echo 'Document version.'; \
echo '================='; \
echo; \
echo '.. include:: VERSION.rst'; \
echo; \
echo 'gadict article count.'; \
echo '====================='; \
echo; \
echo '======================================== ====='; \
echo '             Dictionary                  Count'; \
echo '======================================== ====='; \
total=0; \
for dic in $(C5_FILES); do \
  cnt=`grep '^_____' $$dic | wc -l`; \
  printf '%40s %5s\n' $$dic $$cnt; \
  total=$$(($$total + $$cnt)); \
done; \
printf '%40s %5s\n' '**Total**' $$total; \
echo '======================================== ====='; \
} >$@

################################################################
# Clean targets.

.PHONY: distclean
distclean: clean
	rm -f VERSION

.PHONY: clean
clean:
	rm -f $(DICTDZ_FILES) $(INDEX_FILES) $(HTML_FILES) STAT.rst VERSION.rst
	rm -rf $(DIST_DIR) $(DIST_TARBALLS)
	rm -rf $(DISTSRC_DIR) $(DISTSRC_TARBALLS)