X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2FGNUmakefile;h=2f99e82fd77c0ac53a88e1a3a1c00a818ddce9d8;hb=0387f04497978e37b335a8b99eec905499d6ad0f;hp=40b54c886bcbf10c2beb67f487e45f383348d14f;hpb=d098d33a41336f4966b5b3c8444d7646b5f80c88;p=lilypond.git diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile index 40b54c886b..2f99e82fd7 100644 --- a/Documentation/GNUmakefile +++ b/Documentation/GNUmakefile @@ -1,26 +1,127 @@ depth = .. NAME = documentation -SUBDIRS=user bibliography pictures topdocs ntweb misc +LANGS = $(shell $(PYTHON) $(top-src-dir)/python/langdefs.py) +SUBDIRS=user bibliography pictures topdocs misc po $(LANGS) STEPMAKE_TEMPLATES=documentation texinfo tex -LOCALSTEPMAKE_TEMPLATES=lilypond mudela +LOCALSTEPMAKE_TEMPLATES=lilypond ly +LILYPOND_BOOK_FLAGS=--extra-options '-e "(ly:set-option (quote internal-type-checking) \#t)"' +README_TOP_FILES= DEDICATION THANKS +EXTRA_DIST_FILES= TRANSLATION -README_TOP_FILES=NEWS DEDICATION CHANGES TODO -EXTRA_DIST_FILES= +include $(depth)/make/stepmake.make -include $(depth)/make/stepmake.make +HTML_PAGE_NAMES= index devel translations +OUT_HTML_FILES= $(HTML_PAGE_NAMES:%=$(outdir)/%.html) +OUT_CSS_FILES= $(CSS_FILES:%.css=$(outdir)/%.css) default: local-doc -local-WWW: copy-for-me txt-to-html $(outdir)/regression-test.ps.gz $(outdir)/regression-test.html footify +local-WWW-2: txt-to-html $(OUT_HTML_FILES) -copy-for-me: - $(foreach a, $(README_TOP_FILES), cp ../$(a) $(outdir)/$(a).txt && ) true +local-WWW-clean: deep-WWW-clean +deep-WWW-clean: + rm -rf $(outdir)/wiki-dump + +OUT_TXT_FILES = $(addprefix $(outdir)/, $(addsuffix .txt, $(README_TOP_FILES))) + +# cd $(outdir) rule gets bit hairy for --srcdir configure builds txt-to-html: - $(foreach a, $(README_TOP_FILES), \ - echo "" > $(outdir)/$(a).html;\ - cat $(outdir)/$(a).txt >> $(outdir)/$(a).html;\ - echo "" >> $(outdir)/$(a).html\ - && ) true - $(footify) $(addprefix $(outdir)/, $(addsuffix .html, $(README_TOP_FILES))) + $(foreach a, $(README_TOP_FILES), cp $(top-src-dir)/$(a) $(outdir)/$(a).txt && ) true + $(PYTHON) $(step-bindir)/text2html.py $(OUT_TXT_FILES) + +$(OUT_HTML_FILES): $(OUT_CSS_FILES) + +$(outdir)/%.css: %.css + ln -f $< $@ + +po-update: + make -C po po-update + +all-translations-update: po-update translation-status + $(foreach lang, $(LANGS), make ISOLANG=$(lang) skeleton-update snippet-update &&) true + +ifneq ($(ISOLANG),) +new-lang: + @if (( $$(file -b $(ISOLANG)) == directory )) 2>/dev/null; \ + then echo "Error: $(ISOLANG) directory already exists. Exiting." ; \ + exit 3 ; \ + fi + mkdir -p $(ISOLANG)/user + cp fr/GNUmakefile $(ISOLANG) + cp fr/user/GNUmakefile $(ISOLANG)/user + sed -i -e 's/ISOLANG *= *fr/ISOLANG = $(ISOLANG)/' $(ISOLANG)/GNUmakefile $(ISOLANG)/user/GNUmakefile + $(PYTHON) $(buildscript-dir)/texi-langutils.py -d $(outdir) -l $(ISOLANG) -o doc.pot --skeleton --gettext ../user/lilypond-learning.tely + mv $(outdir)/*.*tely $(ISOLANG)/user + msgmerge -U po/lilypond-doc.pot $(outdir)/doc.pot + cp po/lilypond-doc.pot po/$(ISOLANG).po + @echo "*** Please add a language definition for $(ISOLANG) in python/langdefs.py ***" + +CHECKED_FILES = $(ISOLANG)/index.html.in $(shell find $(ISOLANG)/user/ -maxdepth 1 -name '*.*te??') + +ifneq ($(NO_COLOR),) +CHECK_TRANSLATION_FLAGS = --no-color +endif + +TELY_FILES = $(call src-wildcard,$(ISOLANG)/user/*.tely) +skeleton-update: + $(PYTHON) $(buildscript-dir)/texi-langutils.py -d $(outdir) -l $(ISOLANG) --skeleton $(TELY_FILES:$(ISOLANG)/user/%.tely=../user/%.tely) + $(PYTHON) $(buildscript-dir)/texi-skeleton-update.py $(ISOLANG)/user $(outdir) + +snippet-update: + $(PYTHON) $(buildscript-dir)/update-snippets.py user $(ISOLANG)/user '*.itely' + +DOCUMENTS_INCLUDES:=-I $(ISOLANG)/user \ +-I $(top-build-dir)/Documentation/$(ISOLANG)/user/out-www \ +-I $(top-src-dir)/input/lsr \ +-I $(top-build-dir)/input/lsr/out-www \ +-I user -I $(top-build-dir)/Documentation/user/out-www + +else # ISOLANG is empty + +DOCUMENTS_INCLUDES:=-I user \ +-I $(top-build-dir)/Documentation/user/out-www \ +-I $(top-src-dir)/input/lsr \ +-I $(top-build-dir)/input/lsr/out-www + +endif # ISOLANG + +check-xrefs: + $(PYTHON) $(buildscript-dir)/check_texi_refs.py --batch \ + $(DOCUMENTS_INCLUDES) $(buildscript-dir)/manuals_definitions.py + +fix-xrefs: + $(PYTHON) $(buildscript-dir)/check_texi_refs.py --auto-fix \ + $(DOCUMENTS_INCLUDES) $(buildscript-dir)/manuals_definitions.py + +check-translation: + $(PYTHON) $(buildscript-dir)/check_translation.py $(CHECK_TRANSLATION_FLAGS) $(CHECKED_FILES) + +update-translation: + $(PYTHON) $(buildscript-dir)/check_translation.py --update $(CHECK_TRANSLATION_FLAGS) $(CHECKED_FILES) + +translation-status: + make -C po out=www messages + $(PYTHON) $(buildscript-dir)/translations-status.py + +local-help: extra-local-help + +extra-local-help: + @echo -e "\ + check-xrefs [ISOLANG=LL] validate Texinfo cross-references\n\ + fix-xrefs [ISOLANG=LL] interactively fix Texinfo cross-references (use with caution)\n\ +\n\ +Translations specific targets (see TRANSLATION for details):\n\ + new-lang ISOLANG=LL create and initialize subdirectory \'LL' for language \'LL\n\ + po-update update and replace PO files for documentation with msgmerged versions\n\ + check-translation ISOLANG=LL show changes in English docs since last translation update\n\ + update-translation ISOLANG=LL call $$$$EDITOR to help updating the translation\n\ + skeleton-update ISOLANG=LL update Texinfo skeleton files\n\ + snippet-update ISOLANG=LL update ly snippets in Texinfo translation according to\n\ + docs in English (use with caution)\n\ +\n\ +LL refers to the desired locale (most often only the ISO 639 language code).\n" + +info: + $(MAKE) -C user info