Suppose you want to replace some $STRING_ONE with $STRING_TWO in files and folders’ names (rename them) and in all files’ contents for some given directory $BASEDIR.

cd $BASEDIR

To rename all files and folders by replacing $STRING_ONE to $STRING_TWO:

find . -name "*$STRING_ONE*" -print \
 | sed "h; s/$STRING_ONE\([^/]*\)$/$STRING_TWO\1/; H; g" \
 | sed -n 'N; 1! G; $ p; h' | xargs -L 2 mv

To replace string $STRING_ONE with $STRING_TWO in all files:

grep -lr "$STRING_ONE" . \
 | xargs sed -i '' -e "s/$STRING_ONE/$STRING_TWO/g"

The second operation uses grep to select files that contain string to be replaced before actual replacement. This makes renaming more effective when there are a lot of files in the directory and only some of them contain $STRING_ONE, but there are a lot of such substrings to be replaced.

Code snippets were tested on Mac OS X 10.6.5.

When compiling a final document, typesetting engine (e.g. pdflatex) produces a lot of intermediate files, which should not be version controlled. One way to exclude such files from version control is Mercurial’s .hgignore file that should be placed in repository root.

Here’s such an example file that tells hg to ignore TeX intermediate stuff:

syntax: glob

*.aux
*.bbl
*.blg
*.brf
*.log
*.out
*.synctex.gz
*.thm
*.toc

LaTeX bundle defines a default shortcut Command+R to show a typesetting status dialog window with some buttons for additional actions – compiling bibliography, building index, previewing, etc. I wanted to have an additional action button to run MetaPost on the file with .mp extension:

To get the desired functionality, LaTeX bundle should be checked out from TextMate SVN and patched. Save the patch Latex.tmbundle.diff (file contents is listed below) to your Desktop and run the following commands in the Terminal:

$ cd ~/Desktop
$ svn co http://svn.textmate.org/trunk/Bundles/Latex.tmbundle
$ patch -p1 -d Latex.tmbundle < Latex.tmbundle.diff

To install updated LaTeX bundle into TextMate, simply double-click patched Latex.tmbundle, press “Update” in the dialog window. “Bundle Editor” TextMate window will be displayed, you may just close it.

That’s all. Your modified Latex.tmbundle was moved to ~/Library/Application Support/TextMate/Pristine Copy/Bundles and installed.

Latex.tmbundle.diff

The patch below was tested with TextMate 1.5.8, Latex.tmbundle SVN revision 11795 and LaTeX and MetaPost from MacTeX-2008.

diff -Naur Latex.tmbundle/Support/bin/texMate.py Latex.modified.tmbundle/Support/bin/texMate.py
--- Latex.tmbundle/Support/bin/texMate.py	2009-10-30 18:25:23.000000000 +0200
+++ Latex.modified.tmbundle/Support/bin/texMate.py	2009-10-30 18:26:29.000000000 +0200
@@ -140,6 +140,29 @@
         stat = runObj.wait()
     return stat,fatal,error,warning

+def run_metapost(mpostfile=None,texfile=None,verbose=False):
+    """Determine targets and run the metapost command"""
+    # find all the mp files.
+    fatal,err,warn = 0,0,0
+    mpfiles = []
+    if texfile:
+        basename = texfile[:texfile.rfind('.')]
+    if mpostfile == None:
+        mpfiles = [f[:f.rfind('.mp')] for f in os.listdir('.') if re.search('\.mp$',f) > 0]
+    else:
+        mpfiles = [mpostfile]
+    for f in mpfiles:
+        print '<h4>Processing: %s </h4>' % f
+        runObj = Popen('mpost -interaction=nonstopmode -tex=latex '+shell_quote(f),
+                       shell=True,stdout=PIPE,stdin=PIPE,stderr=STDOUT,close_fds=True)
+        p = MetaPostParser(runObj.stdout,verbose)
+        f,e,w = p.parseStream()
+        fatal|=f
+        err+=e
+        warn+=w
+        stat = runObj.wait()
+    return stat,fatal,err,warn
+
 def findViewerPath(viewer,pdfFile,fileName):
     """Use the find_app command to ensure that the viewer is installed in the system
        For apps that support pdfsync search in pdf set up the command to go to the part of
@@ -572,6 +595,9 @@
     elif texCommand == 'index':
         texStatus, isFatal, numErrs, numWarns = run_makeindex(fileName)

+    elif texCommand == 'metapost':
+        texStatus, isFatal, numErrs, numWarns = run_metapost(texfile=fileName)
+
     elif texCommand == 'clean':
         texCommand = 'latexmk.pl -CA '
         runObj = Popen(texCommand,shell=True,stdout=PIPE,stdin=PIPE,stderr=STDOUT,close_fds=True)
@@ -661,6 +687,7 @@
         print '<input type="button" value="Re-Run %s" onclick="runLatex(); return false" />' % engine
         print '<input type="button" value="Run BibTeX" onclick="runBibtex(); return false" />'
         print '<input type="button" value="Run Makeindex" onclick="runMakeIndex(); return false" />'
+        print '<input type="button" value="Run MetaPost" onclick="runMetaPost(); return false" />'
         print '<input type="button" value="Clean up" onclick="runClean(); return false" />'
         if viewer == 'TextMate':
             pdfFile = fileNoSuffix+'.pdf'
diff -Naur Latex.tmbundle/Support/bin/texlib.js Latex.modified.tmbundle/Support/bin/texlib.js
--- Latex.tmbundle/Support/bin/texlib.js	2009-10-30 18:25:23.000000000 +0200
+++ Latex.modified.tmbundle/Support/bin/texlib.js	2009-10-30 18:26:29.000000000 +0200
@@ -49,6 +49,10 @@
     runCommand('index')
 };

+function runMetaPost(){
+    runCommand('metapost')
+};
+
 function runView(){
     runCommand('view')
 };
diff -Naur Latex.tmbundle/Support/bin/texparser.py Latex.modified.tmbundle/Support/bin/texparser.py
--- Latex.tmbundle/Support/bin/texparser.py	2009-10-30 18:25:23.000000000 +0200
+++ Latex.modified.tmbundle/Support/bin/texparser.py	2009-10-30 18:26:29.000000000 +0200
@@ -122,6 +122,20 @@
         self.done = True
         print '</div>'

+class MetaPostParser(TexParser):
+    """Parse and format Error Messages from metapost"""
+    def __init__(self, btex, verbose):
+        super(MetaPostParser, self).__init__(btex,verbose)
+        self.patterns += [
+            (re.compile('^This is MetaPost'), self.info),
+            (re.compile('^! '), self.error),
+            (re.compile('^Transcript written'), self.finishRun)
+        ]
+
+    def finishRun(self,m,line):
+        self.done = True
+        print '</div>'
+
 class LaTexParser(TexParser):
     """Parse Output From Latex"""
     def __init__(self, input_stream, verbose, fileName):

The code above should be saved as Latex.tmbundle.diff file.

Patch details

Here are some details on the code, added by Latex.tmbundle.diff.

The diff file above customizes 3 files in Latex.tmbundle package: texparser.py, texMate.py, and texlib.js, located in Latex.tmbundle/Support/bin.

According to Latex.tmbundle coding style, the main functionality and dialog window modifications should be placed to texMate.py; MetaPost output messages parser should be added to texparser.py; and JavaScript function, wiring texMate.py functionality to dialog window button, should be added to texlib.js file.

Messages parser: texparser.py

The following code provides a very simple MetaPost error messages parser:

class MetaPostParser(TexParser):
    """Parse and format Error Messages from metapost"""
    def __init__(self, btex, verbose):
        super(MetaPostParser, self).__init__(btex,verbose)
        self.patterns += [
            (re.compile('^This is MetaPost'), self.info),
            (re.compile('^! '), self.error),
            (re.compile('^Transcript written'), self.finishRun)
        ]

    def finishRun(self,m,line):
        self.done = True
        print '</div>'

Functionality and template: texMate.py

A new function should be defined to determine target MetaPost .mp files (files) and run mpost command on them:

def run_metapost(mpostfile=None,texfile=None,verbose=False):
    """Determine targets and run the metapost command"""
    # find all the mp files.
    fatal,err,warn = 0,0,0
    mpfiles = []
    if texfile:
        basename = texfile[:texfile.rfind('.')]
    if mpostfile == None:
        mpfiles = [f[:f.rfind('.mp')] for f in os.listdir('.') if re.search('\.mp$',f) > 0]
    else:
        mpfiles = [mpostfile]
    for f in mpfiles:
        print '<h4>Processing: %s </h4>' % f
        runObj = Popen('mpost -interaction=nonstopmode -tex=latex '+shell_quote(f),
                       shell=True,stdout=PIPE,stdin=PIPE,stderr=STDOUT,close_fds=True)
        p = MetaPostParser(runObj.stdout,verbose)
        f,e,w = p.parseStream()
        fatal|=f
        err+=e
        warn+=w
        stat = runObj.wait()
    return stat,fatal,err,warn

The following piece of code provides additional command-line argument metapost:

    elif texCommand == 'metapost':
        texStatus, isFatal, numErrs, numWarns = run_metapost(texfile=fileName)

And finally, the typesetting dialog window template customization:

        print '<input type="button" value="Run MetaPost" onclick="runMetaPost(); return false" />'

JavaScript layer: texlib.js

Just add a function that is invoked when the “Run MetaPost” button is pressed:

function runMetaPost(){
    runCommand('metapost')
};

P.S.

WordPress sourcecode shortcodes are cool!

1. Классификатор УДК на русском языке: http://teacode.com/online/udc.
2. Сервис ВИНИТИ для расшифровки формул УДК: http://scs.viniti.ru/udc.

Список кодов

• 00 – Общие вопросы науки и культуры
  • 001 – Наука в целом. Науковедение. Организация умственного труда
    • 001.5 – Научные теории, гипотезы и системы. Установление зависимости между научными фактами
      • 001.51 – Методы построения системы
    • 001.8 – Общая методология. Научные и технические методы исследований, изучения, поисков и дискуссий. Научный анализ и синтез
      • 001.89 – Организация науки и научно-исследовательских работ
        • 001.891 – Научно-исследовательские работы. Методы исследований
          • 001.891.5 – Практические, активные методы исследований. Эксперименты. Пробы. Испытания
            • 001.891.57 – Моделирование (исследования, испытания на моделях)
        • 001.895 – Нововведения (новшевства). Инновации
  • 004 – Информационные технологии. Компьютерные технологии. Теория вычислительных машин и систем
    • 004.5 – Человеко-машинное взаимодействие. Человеко-машинный интерфейс. Пользовательский интерфейс. Операционная среда пользователя
    • 004.8 – Искусственный интеллект
      • 004.82 – Представление знаний
        • 004.822 – Сети знаний. Семантические сети
      • 004.89 – Прикладные системы искусственного интеллекта. Интеллектуальные системы, обладающие знаниями
        • 004.891 – Экспертные системы
        • 004.896 – Искусственный интеллект в промышленных системах. Интеллектуальные САПР и АСУП. Интеллектуальные средства робототехники
      • 004.9 – Прикладные информационные (компьютерные) технологии
        • 004.94 – Компьютерное моделирование
          • 004.942 – Исследование поведения объекта на основе его математической модели
  • 007 – Деятельность и организация. Общая теория связи и управления (кибернетика)
    • 007.5 – Самодействующие системы
      • 007.51 – содержащие человека в качестве звена системы
• 30 – Теория, методология и методы общественных наук в целом. Социография
  • 303 – Методы общественных наук
    • 303.7 – Методы анализа
      • 303.73 – Уровни анализа
        • 303.732 – Системный уровень. Системный анализ
          • 303.732.4 – Системный анализ
• 51 – Математика
  • 510 – Фундаментальные и общие проблемы математики. Основания математики, математическая логика и т.п.
    • 510.6 – Математическая логика
      • 510.63 – Логические и логико-предметные теории. Классические (традиционные) логические системы
        • 510.635 – Логика предикатов и исчисление предикатов
          • 510.635.3 – Расширенное исчисление предикатов
            • 510.635.32 – Теория типов
  • 519.7 – Математическая кибернетика
    • 519.71 – Теория управляющих систем (математические вопросы)
      • 519.711 – Общие вопросы теории управляющих систем
        • 519.711.7 – Теория сетей
  • 519.8 – Исследование операций
    • 519.81 – Теория полезности и принятия решений
      • 519.816 – Теория принятия решений
• 68 – Различные отрасли промышленности и ремесла, производящие конечную продукцию. Точная механика. Лёгкая промышленность
  • 681 – Точная механика
    • 681.5 – Автоматика. Теория, методы расчета и аппаратура систем автоматического управления и регулирования. Техническая кибернетика. Техника автоматизации
      • 681.51 – Системы автоматического управления (САУ). Кибернетические характеристики систем. Системы по принципу действия
        • 681.518 – Информационные системы в автоматическом управлении

Примеры

• Семантические сети в теории принятия решений – 004.822:519.816.