Ne v kontakte Antisocial programmer's blog

Докуметнация - это просто. PHP Doc Writer

Любой программист рано или поздно сталкивается с необходимостью документирования своего кода, особенно если он пишет opensource проект или работает в команде.

К сожалению (или к счастью?) сия проблема не минула и меня. В процессе написания документации к проекту Web Update я довольно быстро устал копаться в коде, выискивая каждую функцию и описывая ее.

Поразмыслив за кружечкой кофе я пришел к выводу, что неплохо бы написать какую-нибудь программу, которая будет сама извлекать определения функций из исходного кода и предоставлять удобный интерфейс редактирования описаний к этим функциям.

Результатом стал скрипт PHP Doc Writer. Этот скрипт работает со скриптами php и способен генерировать документацию в формате, совместимом с phpDocumentator. На сегодняшний день он может работать только с документированием классов и функций, но в будущем я планирую расширить возможности, а так же добавить возможность работы с несколькими файлами одновременно.

Read more →

phpMyAdmin 2.11.8.1.0 Russian Lite

Сегодня мне понадобилось быстро развернуть у одного из клиентов работающий phpMyAdmin и чтобы впредь не тратить лишнее время на скачивание и закачивание довольно толстого дистрибутива я создал урезанный пакет, включающий только жизненно необходимые файлы. И так, отличия от оригинального пакета:

  • Включены только русская и английские локализации
  • Убрана сопутствующая документация
  • Убран скин “darkblue_orange”, оставлен лишь дефолтный скин
  • Убраны все сопутствующие скрипты, кроме инсталлятора

Для его эта сборка была сделана? Единственная идея сборки - убрать все лишнее и ускорить процесс развертывания phpMyAdmin на хосте. Какой смысл загружать документацию, если мы и так умеем им пользоваться? Или для чего нам тестирующие скрипты, если мы ими вообще ни разу не пользовались? Именно по такому принципу и проходило усечение.

Ну и напоследок немного статистики (в скобках приведены показатели стандартного дистрибутива): 1) Размер архива bz2 - 1.3 Mb (3.0 Mb) 2) После распаковки - 3.8 Mb (12.3 Mb)

Read more →

Ап Яши, Гитара и полезные ссылки.

Вот опять случился ап у Яндекса. Случиться-то случился, но меня он почти не затронул. Единственная подвижка - снялся с одного сайта фильтр в 10 страниц, о котором я уже писал.

Теперь опубликую несколько ссылок, которые мне попались за последнее время: Массовый вывод PR страниц сайта Блог Гуглизация Генерация карт сайта для Google и Яндекса Академия phpBB (англ) break И на последок - сегодня я наконец-то купил себе электрогитару с комбиком. Гитарой стала красавица B.C. Rich Masterpiece: None

А комбиком недорогой, но качественный Kustom Dual 30RC: None

Держитесь, соседи!

Read more →

Что я читаю: избранные RSS ленты.

SEO & Манимейкинг

Веб-программирование

Read more →

Как работать эффективно.

Последнее время мне стало не хватать дня, чтобы успеть все, что было задумано или пришло в голову по ходу дела. Такова оборотная сторона любого интересного дела - чем дальше в лес, тем больше идей. Дошло до того, что, постоянно отвлекаясь туда на пять минут, сюда на две, я перестал успевать вообще что бы то ни было. Решение пришло из прошлого: в детстве я всегда требовал, чтобы мне с утра выдали список дел, лежащих на мне сегодня, выполнив которые, я смогу заниматься чем пожелаю. Иными словами, обычный TODO лист.

Честно говоря, я даже не мог предположить, насколько эффективным это окажется. Тратя пять минут с утра на составление списка и дополняя его по ходу дела я стал успевать в разы больше. Почему? Наверное, потому что вместо того, чтобы отвлекаться на каждую мелочь, я ее просто добавляю в todo-лист и сосредотачиваюсь на текущей задаче.

И так, как же организовать эффективный todo-лист? Несколько советов из личного опыта.

1) Нарежьте несколько десятков небольших листочков 10х10 см, не более и всегда держите их вместе с ручкой поблизости от рабочего места. Если вам что-то придет в голову всегда можно будет их записать и обдумать на досуге.

Read more →