Ne v kontakte Asocial programmer's blog

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

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

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

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

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

Регистрации для работы с Doc Writer’ом не требуется, единственное, что необходимо - это включенные cookies. Так как вся информация о документации хранится в данных сессии, поэтому потеряв сессию, вы теряете все сделанные правки, если не успели их скачать, конечно.

Постовой: История и современность рока в личном блоге Евгения Штольца Рок радио, рок музыка, рок А так же рекомендую почитать seo блог

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)

Скачать: phpMyAdmin-2.11.8.1-ru-en.tar.bz2

PS. Студия, занимающаяся продвижением сайтов более 5 лет. Так же на сайте есть раздел статей, содержащих немного полезной информации.

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

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

Теперь опубликую несколько ссылок, которые мне попались за последнее время: Массовый вывод PR страниц сайта Блог ГуглизацияГенерация карт сайта для Google и ЯндексаАкадемия phpBB (англ)

И на последок - сегодня я наконец-то купил себе электрогитару с комбиком. Гитарой стала красавица B.C. Rich Masterpiece:

B.C. Rich Masterpiece

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

Kustom Dual 30RC

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

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

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

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

Разное

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

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

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

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

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

  2. Каждое утро составляйте свежий todo-лист. Вчерашние помарки, сделанные дела и прочий мертвый груз - зачем он вам?

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

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

  5. Расставляйте дела в таком порядке, в каком их намерены делать и придерживайтесь единожды намеченного. Частые перестановки внесут лишнюю путаницу и отнимут драгоценное время.

  6. Наиболее важные/сложные дела ставьте в начало списка - к вечеру у вас просто не останется сил на них или не хватит времени.

  7. Не забывайте про перерывы :) Нет ничего худшего, чем непрерывная работа - это отупляет чрезмерно утомляет.

Надеюсь, эти советы помогут вам увеличить прибыль за единицу времени :)

Напоследок, фотография моей “тудушницы” - очень удобная вещь, всем рекомендую.

Тудушница

#1 Обзор закладок или что я видел интересного.

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

И так, поехали.

  1. О блоге Московского Полубомжа не знает только ленивый. Между тем, он проводит очень заманчивую акцию, которая проходит при поддержке небезызвестного Главмеда (крупнейшая партнерка в области фарма-seo), PeakClick - так же очень выгодная PayPer Click партнерка, замечательная хорошей отдачей и Jonn22 - производителя самого разнообразного софта для манимейкеров. Что в ней интересного? Во-первых, сама по себе возможность поработать с такими крупными партнерами - хороший шанс обеспечить своему кошельку достойное содержимое, а во вторых, очень лакомы приз в $5000 и неоднократно упомянутые дополнительные призы.

  2. Раскрутка и оптимизация сайта - краткий курс. Здесь довльно подробно и доступно для новичков описаны различные оспекты оптимизации сайтов и в качестве книжки на ночь эта страница может быть очень полезной. Для людей, у которых seo не является профильным занятием, но имеющих свой сайт этот документ просто незаменим.

  3. Как заработать на Smotri.Ru Все тот же Полубомж рассказываем о непыльном способе заколачивания денег. Правда, для того чтобы действительно зарабатывать хорошие деньги надо иметь творческую жилку и ориентироваться в актуальных темах.

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

  5. Уникальный Человек о сателлитах Если вы еще не пробовали себя в сателлитостроении, но хотите начать, то эта серия постов будет вам полезна и предупредит многие обидные ошибки.

На этом, наверное, на сегодня закруглюсь, ибо дел еще немеренно…

Всем успешной мохнатизации!

Апдейт тИЦ & выдачи Яндекса 12.08.08.

Что-то зачастили в последнее время апы у яндекса не прошло и двух недель с последнего апа от 29.07.08 и вот вновь. Да и не просто ап тиц, но и ап выдачи Яндекса, что не может не радовать.

Надо сказать и то, и другой событие в целом для меня стали позитивны. В ходе апа выдачи исчез тот лимит в 10 страниц, о котором я писал раньше.

Ап тица тоже порадовал: у трех моих сайтов тиц подрос на 10 и лишь у одного упал на столько же. Так же не так давно мой блог попал в DMOZ, что тоже должно дать некоторые бонусы.

Ну и чтобы пост не был совсем уж бесполезным поделюсь ссылкой на правильный детектор апдейтов Яндекса.

Удачных вам апдейтов!

Бесплатные шаблоны для сателлитов

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

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

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

Где же их можно взять? Вот небольшой список сайтов, которыми пользуюсь я: Template WorldOpen Source Web DesignFree CSS TemplatesZymic.com

Яндекс выбросил из индекса.

Два дня назад обнаружил, что Яндекс неожиданно вышвырнул большую часть страниц моего блога из индекса, оставив лишь 10, да и то не самых лучших. С чем это связано я пока не совсем понял, тем более, что аналогичная ситуация сложилась и с еще одним моим сайтом, у которого в индексе остались те же 10 страниц. Интересно, что раскручивал я их изначально по-разному и строго “белыми” способами, но такой вылет с ними случился одновременно.

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

Параноик Яндекс.

Видать, нынче модно у поисковых систем защищаться от DDOS атак путем блокировки IP, с которых совершается много запросов. Первым я это заметил у Гугля, а сегодня и у Яндекса. При этом, к сожалению, страдают в основном простые пользователи локальных сетей, у которых один внешний IP на несколько сотен/тысяч машин. И если Гугль еще предлагает ввести капчу и пользоваться дальше, то Яндекс тупо говорит: 403 - идите на фиг.

В прочем, причиной поста послужил другой факт. В конце длинного сообщения, что я, злой и завирусованный подлец пытаюсь завалить несчастный Яндекс, есть интересная приписка:

Рекомендуем вам проверить компьютер на вирусы или обратиться к администратору вашего компьютера или вашей сети. Для проверки компьютера вы можете воспользоваться бесплатной программой Я.Онлайн с антивирусной защитой Касперского, скачать которую можно с сайта Я.Онлайна.

Ради любопытства я кликнул на ссылочку и… 403!!! - иди лечись от вирусов.

“Вот и иди после этого к свету.” (с) Роджер Желязны.