Версия для печати темы Нажмите сюда для просмотра этой темы в оригинальном формате

Форум программистов > wiki.vingrad.ru > Винграду необходима ваша помощь!

Автор: sergejzr 29.11.2005, 02:59

Как мы знаем, на форуме реализована наша подсветка кода. В своё время было выдвинуто интересное предложение, а именно ссылаться с ключевых слов кода на справочники. Долгое время эта задача была практически нерешаемая за отсутствием подходящих справочников. И вот теперь у нас есть Wiki!! Мы можем ссылаться на нашу Вики и параллельно пополнять её. В итоге образуется лучший справочник в РуНете. С примерами кода, дополнениями. Каждый сможет принимать участие в развитии. На данный момент необходим человек или группа, которая хорошо продумает структуру Вики в виде справочника. Необходимо продумать структуру страницы само ключевое слово описание ссылки на подобные функции в других языках программирования (межьязыковый словарь) ссылка на описалово этой функции на других языках (думаем сделать 3 языка: русский - англ. нем.) Примеры участников по применению этой функции Ну конечно, вставка своих идей приветствуется! несколько людей с форума уже безрезультатно поломали свои копья бившись над этой, в принципе несложной, интересной и ответственной, задачей. Однако ничего рабочего мы к сожалению не имеем до сих пор... Но я верю, что среди нас найдутся талантливые люди, способные взять быка за рога так, чтобы мы могли ввести проапгрейденую раскраску кода самое позднее с вводом нового дизайна! Примерный макет, как это должно будет выглядеть /------------------------------------------------------------------- код C++ 1 - 2 - int n;   cout<<"Enter the n = "; Конечно необходимо и дизайн будет разработать потом.

Автор: Cashey 29.11.2005, 17:31

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

Автор: eskaflone 29.11.2005, 18:29

а чем структура как в cout не нравится? Только поменять местами "примеры кода" и "про cout в других языках". И "Про cout в других языках программирования": не просто название языка ,а под ним еще и варианты эквивалентных операторов (бывает что их несколько). Плюс в основной секции ссылки на похожие операторы в этом же языке. Например cin.

Автор: sergejzr 29.11.2005, 18:57

Цитата(eskaflone @ 29.11.2005, 17:29) а чем структура как в cout не нравится? Тем, что я её написал за 3 минуты не напрягая ни одной извилины Надо, чтобы юзабильно было, продуманно. Примеры кода думаю будут очень большим куском. Ссылкам лучше остаться вверху, но может мрньшим шрифтом... Короче нужен ответсвенный чек, кто этим займётся Цитата(Cashey @ 29.11.2005, 16:31) а вот идея некой вики мне совершенно не понятно. можно ли по подробней, что за справочник ожидается и какие его требования? ведь известно, что в разных языках одно и то же слово может быть как заразервированным так и нет Покликай там на ссылки, поймёшь. В принципе я всё уже описал в посте. Это будет редактируемый межьязыковый словарь..

Автор: Mal Hack 29.11.2005, 21:47

Сереж, ну по хорошему тогда уже туда и FAQ надо переносить, но переносить FAQ на не обкатанный движок НЕЛЬЗЯ !! Идея хорошая. С PHP я в своенй подсветке такое реализвывал, правда там на сервере свкрипт работал.

Автор: eskaflone 29.11.2005, 21:53

http://wiki.vingrad.ru/index.php/MANUAL_RU_CPP:int случайно отредактировал страничку ,а хотел третью добавить. вторая http://wiki.vingrad.ru/index.php/MANUAL_RU_PASCAL:data_types

Автор: sergejzr 29.11.2005, 22:08

eskaflone, редактируй наздоровье. Две страницы с одним названием нельзя иметь, а эту можешь редактировать как хочешь..

Автор: eskaflone 1.12.2005, 14:52

1)Как можно в текст страницы из вики добавить ссылку (через редактирование нельзя ,не обрабатывается). Для этого надо непосредственно в движке вики добавление реализовать или как то по другому можно? 2)в <div> событие onClick обрабатывается? Проверил ,в Опере обрабатывается ,здесь убрана обработка из-за соображений безопасности? Можно ли как нибудь обойти? ЗЫ вот для чего http://wiki.vingrad.ru/index.php/MANUAL_RU_PASCAL:data_types2

Автор: sergejzr 1.12.2005, 15:03

Смотри, как я делал. Читай доки. Ссылки добавляеются: внешняя - [http://тырыпыры текст_ссылки] внутренняя (по вики) [[название темы]] Если темы ещё не существует, автоматически будет ссылка на редактирование новой темы События вроде не обрабатываются, но это можно всё исправить, если очень надо будат

Автор: eskaflone 1.12.2005, 15:08

Вобщем ссылки там не нужны ,достаточно <div>а ,а вот события могут пригодиться. Посмотри по ссылке.

Автор: Dray 3.12.2005, 01:34

Небольшое пожелание: Мне кажется что было бы лучше если бы в коде ключевые слова не подчеркивались.

Автор: Cheba 8.12.2005, 01:54

Итак... На данный момент Wikimedia Wiki не поддерживает мультиязычность. Есть несколько вариантов. Первый и, казалось бы, самый очевидный - использование неймспесов. Это когда мы будем иметь ссылки (внутренние) типа En:PHP:substr, De:PHP:substr, Ru:PHP:substr. Но это не удобно. Хотябы потому, что прийдется все время этот язык таскать с собой. Единственным на мой взгляд преимуществом может быть только то обстоятельство, что мы имеем всего одну вики и ее проще мейнтейнить. Есть еще два подхода. Оба они себя хорошо зарекомендовали. Оба они основаны на множественных инсталляциях вики. В этом случе на каждый язык (не программирования, а национальный - русский, английский...) имеется отдельная вики - отдельная инсталляция и отдельная база. Мейнтейнить немножко сложнее, но в принуипе не сложно. В конце-концов они все будут отличаться только конфигом и, возможно, языковыми настройками. Один вариант - субдоменный. В этом случаее мы будем иметь en.wiki.wingrad.ru/PHP:substr, ru.wiki.wingrad.ru/PHP:substr и т.д. Этим подходом пользуется всем известная wikipedia. Второй вариант - "субфолдерный". В этом случае будем иметь ссылки типа wiki.wingrad.ru/en/PHP:substr, wiki.wingrad.ru/ru/PHP:substr. Этим методом пользуется Mozilla Developer Center. Эти два метода более предпочтительны для пользователя. Так, как ему не надо уже заботиться о языке. Ему надо только выбрать дефолтный (для себя) сервер. Таким образом мы будем по одной и той же внутренней ссылке получать информацию на разных языках в зависимости от выбранной вики. Теперь о структурировании. На первый взгляд эта задача может показаться сложной, но это не так. Просто она не так, как мы привыкли решается. Все это очень легко решается с помощью категорий. С помощью категорий можно выстроить некоторое подобие древовидной структуры, но они более удобны в использовании. Каждая статья имеет имя. Например, PHP:substr. Кроме того статьи могут состоять в категориях. Например, эту статью можно включить в категорию PHP:Strings. Категория - это тоже, некоторого рода статья. Она может тоже содержать текст, но лучше отдельно завести страницу PHP:String Functions, которая будет кратко описывать эти самые строковые функции и прочее, что к ним относится. Эту статью (как и предыдущую - PHP:substr) можно ключить в категорию PHP:Function Reference. А страницу PHP: Function Reference - в категорию PHP:Manual. Страницу с именем PHP, можно включить в категорию Programming Languages. В заключении посоветовал бы почитать хелп по вики и пописать статьи в другие вики, чтобы увидеть как это все работает. Сам много узнал о работе вики, когда начал писать статьи для DevMO. Добавлено @ 02:01 Mal Hack, движек очень даже обкатанный. Другое дело, что далеко не все умеют им пользоваться. Поначалу, наверное, будет хаос. Потому, стоит ограничить хотябы создание новых страниц только для зарегистрированных (на вики) пользователей. Это с одной стороны не удержит действительно жаждущих писать, а с другой стороны не даст всем подрад сходу создавать новые страницы.

Автор: Cheba 8.12.2005, 02:05

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

Автор: eskaflone 8.12.2005, 21:37

Cheba http://freepascal.ru/wiki/index.php/FreePascal.ru:Переводы

Автор: sergejzr 8.12.2005, 22:15

eskaflone, интересно. Конечно можно использовать как ориентир Cheba, спасибо, но скорее всего множественных инсталляций Вики не будет. Ссылки будут генериться автоматически в скрипте, так что проблем с этим у юзера не должно быть.

Автор: Cheba 8.12.2005, 22:33

eskaflone, спасибо за ссылку. Только как это относится к теме разговора - многоязычности? sergej.z, не понял про генерирование ссылок. Как это решит проблему многоязычности? И почему не подходит множественная инсталляция Вики?

Автор: eskaflone 9.12.2005, 08:53

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

Автор: Cheba 9.12.2005, 13:59

Цитата(eskaflone @ 9.12.2005, 08:53) Cheba это я про то что вики статика ,а не про языки. Походил, посмотрел... Стандартная вики. В ней вся днамика - это показать, спрятать оглавление. Или я опять что-то пропустил? Цитата(eskaflone @ 9.12.2005, 08:53) И еще ,если я правильно понял то для удобства пользователей структуру лучше организовать не линейно в виде простого дерева ,а для каждого элемента определить его принадлежность нескольким категориям. Верно. Только принадлежность к нескольким категориям тоже нужно правильно организовать чотбы большой каши не получилось.

Автор: Cheba 9.12.2005, 14:17

Я вот тут взвесил все "за" и "протипв"... Думаю, я мог бы взяться за вики. Не буду утверждать, что обрадаю всеохватывающими знаниями в области Вики, но на то я и человек разумный, чтобы учиться. ;) В общем, если надумаете - обращайтесь.

Автор: sergejzr 9.12.2005, 15:22

Дык считай, что надумали ) Кстати, мне понравился движёк: http://developer.mozilla.org/en/docs/index.php Он я так понимаю тоже на вики базируется. Может его взять?

Автор: Cheba 9.12.2005, 15:45

Там стандартная Вики. Как у нас. Только несколько плагинов (кстати, полезных) еще поставили. А заглавная страничка просто красиво оформленна. Мы тоже так можем. ;)

Автор: Cheba 9.12.2005, 18:39

Вот, например, http://wiki.vingrad.ru/index.php/%D0%AD%D0%BD%D1%86%D0%B8%D0%BA%D0%BB%D0%BE%D0%BF%D0%B5%D0%B4%D0%B8%D1%8F_%D0%9D%D0%B0%D1%87%D0%B8%D0%BD%D0%B0%D1%8E%D1%89%D0%B5%D0%B3%D0%BE_%D0%98%D0%B3%D1%80%D0%BE%D0%B4%D0%B5%D0%BB%D0%B0.

Автор: Cheba 17.12.2005, 18:27

Итак. Вижу, что дело не движется. Не есть гуд. Поговорив с Вовой, я выяснил, что это из-за того, что нет структуры. Расскажу о структуре в wiki. Эта самая структура создается не как обычно продумыванием каой-либо древовидной структуры, а категориями. Категория - это група статей. Любую статью можно отнести к каой-то категории или даже к нескольким просто добавив в статью нехитрую строчку. Код [[Category:<имя категории>]] Так вот. Статьи включаются в ктегории. Категории тоже можно относить к другим категориям, то есть таким образом создавать подкатегории. Вот так и создается структура wiki. Может показаться, что это не очень удобно. Никто с самого начала не знает какие категории есть (кстати, в wiki можно посмотреть список всех категорий), к каокой категории отнести ту или иную статью. Это мелочи. Совсем ведь не сложно определить основные темы статьи, ну хотябы язык программирования. Думаю, ни у кого не возникнет проблем в орпеделении того, относится ли статья к сетевому взаимодействию или к пользовательскому интерфейсу, или и к тому и к другому. Создавая статьи, изменяя их и дополняя редактьоры wiki постоянно сами упорядочивают эту самую структору. Приведу пример. Допустим, кто-то написал статью о каком-то способе создания красивого меню для веб-сайта. Значит вот и категории: Web-Design, HTML, CSS. Потом оказалось, что ИЕ (например, никого не хочу обижать =) ) не совсем правильно понимает написанный css и его можно скорректировать с помощью скрипта. Дополнили статью. Добавляем категории: JavaScript, JavaScript:IE Fixes. Почему я добавил JavaScript:IE Fixes, а не просто IE Fixes? Да потому, что фиксы могуть быть еще и на CSS (CSS: IE Fixes). При этом и те и ждругие могут состоять просто в IE Fixes. Таким образом, мы получаем не древовидную структуру (как, например, в нашем FAQ), а что-то вроде паутины, сетки. Когда к одной и той же статье можно добраться из разных уголков. Думаю, преимущества очевидны. Во-первых, не надо долго взвешивать куда же оно больше относится, к HTML, CSS или Javascript, оно относится ко всему. Во-вторых, при изменении статьи (по большей части при дополнении и уточнении) всегда можно добавить еще одну категорию и статья все равно будет находиться там, где ее находили раньше. Недостатком можно назвать разве-что отсутствие той самой жесткой структуры, к которой мы все так привыкли. Хотя, это еще как посмотреть. Ну, вот. Теперь осталось тольео писать, писать и писать, чтобы было из чего эту самую структуру создавать.

Автор: sergejzr 18.12.2005, 21:19

Цитата(Cheba @ 17.12.2005, 17:27) Ну, вот. Теперь осталось тольео писать, писать и писать, чтобы было из чего эту самую структуру создавать. Дело в том, что до сих пор никто не решился взятся за дело. Проще говоря нет желающих. Эта тема в принципе была создана для того, чтобы найти желающего заняться стрктурированием Вики. (Хотя бы разработкой макета )

Автор: Cheba 18.12.2005, 22:02

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

Автор: batigoal 18.12.2005, 22:20

Cheba Я бы например, и сам бы это сделал с удовольствием (тем более, что тоже недавно начал пользоваться движком Вики), но элементарно не смогу выкроить время на эту задачу, и Доместик. наверное, тоже. Так что найти людей будет трудновато.

Автор: Exception 18.12.2005, 23:01

Гхм.. А в чем, собссно, задача? Для .NET описание всего этого есть в MSDN. Для Delphi есть DRKB. Идея хороша, но не у всех есть время.

Автор: Cheba 19.12.2005, 00:23

Lamer George, а чего ты? Или Доместик? Найдется же народ чтобы элементарно стандартные функции, процедуры, классы описать. В конце концов, это не надо сделать сразу все. Мало помалу... Run-time error, в том-то и дело, что MSDN и DRKB. Первый полный, но на английском. Как показывает горький опыт, далеко не каждый программист обладает достаточным уровнем знания языка. Да и потом, на него так просто не сошлешься из подсвеченного кода, а именно это было изначальным применением вики. Потом уже размещение интересного и полезного, как это сделано в ДРКБ.

Автор: sergejzr 19.12.2005, 00:41

Только не путайте ФАК и справочник. Как должен выглядеить справочник - идеальный пример www.php.net/substr вот и описание функции substr. Только надо структуру такой страницы продумать с сылками на другие человеческие языки и языки программирования. Потом мы некопируем эти страницы для каждого ключегого слово каждого языка и сошлёмся на них непосредственно из кода. А весь контент уже люди сами забьют.

Автор: Exception 19.12.2005, 00:58

Так что конкретно нужно? Я могу составить список всех ключ. слов ВБ.НЕТ, их описаний и примеров. Потом можно взяться и за сам фрэймворк.. Только скажи, что нужно, и к каким срокам.

Автор: sergejzr 19.12.2005, 01:05

Всё есть ключевые слова определены в подсветке уже. См. первый пост и ссылки из кода на int и cout. Необходимо продумать структуру такой страницы. тое сть - где будут находится ссылки на другие чел. языки, где ссылки на другие языки программирования, где примеры кода, а гдеописание. Надо продумать стили страницы и может быть будет необходимл что нибудь ещё... Короче должно выглядеть красиво, солидно и легкочитаемо.

Автор: Exception 19.12.2005, 01:15

Мне нравится, как все это описано в MSDN for VS 2005. Завтра кину скриншоты

Автор: sergejzr 19.12.2005, 01:18

Скриншоты не надо. Предложения не нужны Нужен ответственный. Тогда и будет кому предлагать.

Автор: Cheba 19.12.2005, 03:17

sergej.z, давай я буду ответственным. Ну, хотябы сначала. Чтобы дать делу хоть какой-то ход. Теперь я примерно понял в чем застопорились...

Автор: sergejzr 19.12.2005, 03:37

Отлично!

Автор: batigoal 19.12.2005, 09:31

Цитата(Cheba @ 19.12.2005, 01:23) Lamer George, а чего ты? Или Доместик? Найдется же народ чтобы элементарно стандартные функции, процедуры, классы описать Не уверен. Ну ладно там еще ключевые слова, их четыре десятка. Но описывать стандартный Java API - это задача непосильная, а в некоторых случаях - еще и принципиально неразрешимая, т.к. имена классов частенько совпадают (java.util.Date, java.sql.Date). А особого смысла расписывать цикл for я не вижу. Цитата(sergej @ 19.12.2005, 01:41) Как должен выглядеить справочник - идеальный пример www.php.net/substr вот и описание функции substr. Это очень здорово, но там одному только этому оператору уделен десяток листов текста. Далее. Я не знаю, как это будет реализовываться, поэтому у меня вопрос - не вызовет ли это "утяжеление" страницы? Если к каждому if-у будет цепляться линк - объем листинга вырастет в десятки раз. Однако, если фича все-таки будет реализовываться, я постараюсь принять посильное участие (или предложить это кому-нибудь из постоянных посетителей раздела Java).

Автор: sergejzr 19.12.2005, 15:05

Цитата(Lamer @ 19.12.2005, 08:31) Далее. Я не знаю, как это будет реализовываться, поэтому у меня вопрос - не вызовет ли это "утяжеление" страницы? Если к каждому if-у будет цепляться линк - объем листинга вырастет в десятки раз. Нет. Ссылки генерируются, а не вписываются. Цитата(Lamer @ 19.12.2005, 08:31) Это очень здорово, но там одному только этому оператору уделен десяток листов текста. Сколько необходимо, столько и уделено. В основном это примеры самих юзеров. Java Api jgbcsfnm необязательно. только те слова, которые подсвечиваются. Да и вообще ничего описывать не надо. Принцип Вики - она сама разрастётся где надо, а где не надо нет.

Автор: Cheba 19.12.2005, 20:25

sergej.z, у меня свои мысли по поводу оформления страницы, у тебя - свои. Поэтому давай согласовывать. Вот первоначальный вариант: http://wiki.vingrad.ru/index.php/PHP:if Ссылки "по теме" и на "то же в других языках" справа плавают. Как вариант, можно все это вниз поместить, как делается в большинстве публикаций - список использованной литературы, ссылки по теме и т.д. в конце документа.

Автор: sergejzr 19.12.2005, 21:19

Cheba, Отлично, мне нравится!

Автор: Cheba 20.12.2005, 02:46

Значит, утверждаем. Тогда, ребята, за работу. Все приглашаю поучавствовать в наполнении.

Автор: sergejzr 20.12.2005, 03:53

На еврохосте (http://vingrad.eurohoster.net/index.php?&act=Login&CODE=00&tst=on) подсветка уже работает с сылками. ASM, CPP, PHP, ASP (остальные пока не успел). Пишите туда код проверяйте ссылки Добавлено @ 03:56 Cheba, держи пожалуйста языки в ссылках в верхнем регистре. То есть JAVASCRIPT вместо JavaScript. Так будет стандартнее.

Автор: batigoal 20.12.2005, 09:20

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

Автор: Wowa 20.12.2005, 11:53

Цитата(sergej @ 20.12.2005, 01:53) На еврохосте (вход здесь) подсветка уже работает с сылками. Просто здоровски! Добавлено @ 11:55 Цитата(Lamer @ 20.12.2005, 07:20) Если бы он был, я мог бы немного поделать на новогодних праздниках. А что именно ты мог бы поделать?

Автор: Cheba 20.12.2005, 12:17

Lamer George, вот шаблон страницы: http://wiki.vingrad.ru/index.php/Stub:LangRef. Жми редактировать и посмотри комментарии. Копируешь в свою статью и дописываешь что где надо. sergej.z, заголовки самих статей я вже держал бы в удобном для чтения регистре, без кричащих заголовков. Аббревиатуры еще ладно, но названия языков все же не стоит. Лучше сделать соответствующие алиасы, имхо. Добавлено @ 12:23 http://vingrad.eurohoster.net/index.php?act=ST&f=6&t=58233&unread=1 Уже нашлось несколько проблем... elseif - зеленый, хотя по логике должен быть синим. У if ссылка ведет на PHP:if . Этот   неплохо бы убрать. Этот же   есть у всех ссылок. Курсор pointer у всего кода, хотя далеко не везде можно ткнуть чтобы получить результат. Нельзя ли пофиксить?

Автор: sergejzr 20.12.2005, 12:23

Я имею в виду в ссылках. Так генерить легче и ориентироваться. Ещё: Ты через templates делал? В идеальном варианте потом можно будут поменять template и чтобы структура поменялась на каждой странице справочника. Можно добавить поле с ссылками на другие справочники по этому ключ. слову. дизайн можно каким нибудь образом под винград заточить ?

Автор: batigoal 20.12.2005, 12:38

Цитата(Wowa @ 20.12.2005, 12:53) А что именно ты мог бы поделать? Контент для операторов Java. А что, есть более интересные предожения? PHP не предлагать

Автор: sergejzr 20.12.2005, 12:39

Цитата(Cheba @ 20.12.2005, 11:17) Уже нашлось несколько проблем... Уже их нет. Ищите новые Добавлено @ 12:42 Вообще - с заголовками - делай как тебе удобно...

Автор: sergejzr 20.12.2005, 12:45

Только сообщи плиз мне, чтобы ссылки правильно генерились. У нас сейчас языки, которые на картинке в аттаче

Автор: Cheba 20.12.2005, 12:55

sergej.z, вариант с шаблоном далеко не идеален. Будут вылезать серьезные проблемы с кешированием, если быть более точном, то его вовсе не будет.Так делать не рекомендуется. Цитата(sergej @ 20.12.2005, 12:23) Можно добавить поле с ссылками на другие справочники по этому ключ. слову. По-подробней, пожалуйста. Цитата(sergej @ 20.12.2005, 12:23) дизайн можно каким нибудь образом под винград заточить ? Без проблем. только покажите на что оно должно быть похоже. sergej.z, а можно попросить народ в языковых разделах потестить? Или хотя бы дать куски программ для тестов, бо я далеко не каждый язык знаю...

Автор: sergejzr 20.12.2005, 13:24

Цитата(Cheba @ 20.12.2005, 11:55) Цитата (sergej.z @ 20.12.2005, 12:23) Можно добавить поле с ссылками на другие справочники по этому ключ. слову. По-подробней, пожалуйста. Ну онлайн справочники типа msdn или того же php. Туда ссылки с нашего справочника как на доп. информацию. Цитата(Cheba @ 20.12.2005, 11:55) sergej.z, а можно попросить народ в языковых разделах потестить? Или хотя бы дать куски программ для тестов, бо я далеко не каждый язык знаю... Даже наверное нужно попросить Цитата(Cheba @ 20.12.2005, 11:55) Цитата (sergej.z @ 20.12.2005, 12:23) дизайн можно каким нибудь образом под винград заточить ? Без проблем. smile только покажите на что оно должно быть похоже. smile На новый дизайн Цитата(Cheba @ 20.12.2005, 11:55) sergej.z, вариант с шаблоном далеко не идеален. Будут вылезать серьезные проблемы с кешированием, если быть более точном, то его вовсе не будет.Так делать не рекомендуется. Тогда надо хорошо продумать всю структуру, чтобы аотом не пришлось нам чего нибудь менять на каждой странице. А что с кэшированием? Оно нам действительно нужно?

Автор: Wowa 20.12.2005, 13:26

кеширование - это хорошо, если оно не глючит...

Автор: sergejzr 20.12.2005, 14:08

Я в смысле того, что "Викино" кэширование всё равно на сервере происходит. Хотя конечно я с ним там не эксперт Добавлено @ 14:08 А почему бы кстати ФАК по такому же принципу не кэшировать?

Автор: Wowa 20.12.2005, 14:29

Цитата(sergej @ 20.12.2005, 12:08) А почему бы кстати ФАК по такому же принципу не кэшировать? Меню итак кешируется. А статьи из базы легко выбираются.. Запрос легкий. Смысла кешировать ФАК, имхо нет. Он тормозит только из-за сложного внешнего интерфейса и фреймов.

Автор: Cheba 20.12.2005, 19:19

sergej.z, кеширование вики состоит в том, что у нее свой синтаксис разметки, а ФАК, если не ошибаюсь, хранит готовый HTML. Эго только достать из базы надо. А вот страницы wiki каждый раз перестраиваются, если там есть шаблоны. Просто если шаблон инклудится, то перестраивается только эта часть. В нынешних страницах это breadcrumbs сверху динавически генерятся и сайдбар со ссылками. Все остальное берется готовым из кеша. Теперь представь, что надо каждый раз распарсивать разметку, плюс вложенность шаблонов и т.п. и т.д. Вообще-то надо стремиться именно к виду наиболее подходящему для печатных изданий. С минимумом излишеств. Шаблон сайдбара я пересажу на CSS, чтобы его было проще потом покрасить.

Автор: skalex 21.12.2005, 18:25

Я бы мог написать небольшой справочник по вики-разметке ... Хотя бы для начала азы, а дальше развили бы ...

Автор: sergejzr 21.12.2005, 18:40

Mace было бы здорово! Особенно для тех, кто будет языковый справочник дополнять.

Автор: skalex 21.12.2005, 18:48

sergej.z, ок. Буду постепенно наполнять раздел "http://wiki.vingrad.ru/index.php/Vingrad:%D0%A1%D0%BF%D1%80%D0%B0%D0%B2%D0%BA%D0%B0".

Автор: skalex 21.12.2005, 19:58

Кое что успел набросать ...

Автор: batigoal 21.12.2005, 20:13

Странно, а я привык к немного дргому синтаксису (например, заголовки через !).

Автор: Cheba 22.12.2005, 02:47

Lamer George, и как зовется это чудо? Mace, а почему бы просто не заредиректить на русскую Википедию? Добавлено @ 02:50 Кстати, Mace, почему под другим ником зарегистрировался? Я тебя не узнал на Вики...

Автор: batigoal 22.12.2005, 08:59

Цитата(Cheba @ 22.12.2005, 03:47) и как зовется это чудо? Похоже, так: JSPWiki v2.2.28 Вот выдержка из её подсказки по синтаксису: Цитата ----            Horizontal ruler \\              Forced line break [link]          Create hyperlink to "link", where "link" can be either an internal                 WikiName or an external link (http://) [text|link]      Create a hyperlink where the link text is different from the actual                 hyperlink link. [text|wiki:link] Create a hyperlink where the link text is different from the                 actual hyperlink link, and the hyperlink points to a named Wiki.                 This supports interWiki linking. *                Make a bulleted list (must be in first column). Use more (**)                 for deeper indentations. #                Make a numbered list (must be in first column). Use more (##, ###)                 for deeper indentations. !, !!, !!!      Start a line with an exclamation mark (!) to make a heading.                 More exclamation marks mean bigger headings. __text__        Makes text bold. ''text''        Makes text in italics (notice that these are single quotes (')) {{text}}        Makes text in monospaced font. ;term:def        Defines 'term' with 'def'.  Use this with empty 'term' to make short comments. |text|more text| Makes a table. Double bars for a table heading.

Автор: skalex 22.12.2005, 11:22

Cheba. Цитата Mace, а почему бы просто не заредиректить на русскую Википедию? Думаю солиднее будет иметь свою справочную систему. Цитата Кстати, Mace, почему под другим ником зарегистрировался? Я тебя не узнал на Вики... Wowa обещал сменить мне ник на форуме, поэтому заведомо зарегистрировался на Вики под новым ником. Добавлено @ 11:30 Цитата Странно, а я привык к немного дргому синтаксису (например, заголовки через !). Да у каждого движка Wiki свой синтаксис ... Кстати синтаксис MediaWiki на мой взгляд наиболее странен, потому что перемешан с HTML тегами. Одно время я работал с http://wackowiki.com/WackoDokumentacija/WackoSintaksis?v=hf и http://forum.mozilla.ru/doku.php?id=wiki:syntaxru, и там все было как то нагляднее ...

Автор: AlDev 22.12.2005, 13:33

взялся так активненько за http://wiki.vingrad.ru/index.php/ActionScript %)

Автор: Mal Hack 22.12.2005, 17:35

sergej.z что конкретно надо сделать и в какой форме для PHP?

Автор: sergejzr 22.12.2005, 17:46

Пока подождём разметки от Чебы, потом останется в принципе только инфой заполнить...

Автор: Cheba 23.12.2005, 00:07

Да, собственно говоря, нечего ждать. Вроде ж уже утвердили основной момент... Mal Hack, для начала описываем все ключевые слова, на которые полсветка посылает в вики. А потом уже хочется уникального и интересного наполнения.

Автор: sergejzr 23.12.2005, 01:33

Cheba надо бы скриптик, чтобы одинаковую структуру для всех ключ. слов создал + возможные ссылки.

Автор: AlDev 23.12.2005, 13:59

а можно-ли добавить подсветку ActionScript?

Автор: Cheba 23.12.2005, 14:10

sergej.z, а разве нету? Пишем на НД кусок кода со всеми ключевыми словами и прчим. Заодно и проверим все ли в подсветке правильно ссылается и подсвечивается. Кстати, товарищи, понаписывйте такие куски кода в темах с заголовком "Тест подсветки" в соответствующих разделах. Бкдет прощу создать скелет документации.

Автор: sergejzr 23.12.2005, 14:25

http://vingrad.eurohoster.net/index.php?showtopic=58234&st=0&#entry464293 http://vingrad.eurohoster.net/index.php?showtopic=58236 http://vingrad.eurohoster.net/index.php?showtopic=58235 Просто хотелось бы, чтобы все страницы для любых языков выглядели одинакого и чтобя на них всё было.(ссылуи на др. справочники, др. языки, итд)

Автор: Wowa 23.12.2005, 14:30

Цитата(sergej @ 23.12.2005, 12:25) Просто хотелось бы, чтобы все страницы для любых языков выглядели одинакого и чтобя на них всё было.(ссылуи на др. справочники, др. языки, итд) ага

Автор: AlDev 23.12.2005, 15:31

Цитата(sergej @ 23.12.2005, 19:25) http://vingrad.eurohoster.net/index.php?sh...=0&#entry464293 http://vingrad.eurohoster.net/index.php?showtopic=58236 http://vingrad.eurohoster.net/index.php?showtopic=58235 не работает

Автор: sergejzr 23.12.2005, 15:47

Это временно было

Автор: Cheba 27.12.2005, 00:05

Гм... Новости из wiki. Ведутся работы над шкурой для wiki. Уже есть предварительный вариант. Заходим на wiki. В настройках выбираем шкуру Vingrad и лицезреем. Пока-что нормально смотрится в Лисе. В ИЕ разлазится... Также эта шкура с русским интерфейсом требует разрешения не меньше 1024 по ширине из-за длинных надписей "персонального" меню. С английским можно и 800.

Автор: sergejzr 27.12.2005, 00:15

Ух ты! Отличные новости! Красота. Чувствую, чтот грандиозное начинается PS: Там с коде генерится <a name="top" id="contentTop"></a> Можно заменить на <a name="top" id="contentTop" /> А то валидатор варнинги пускает. В остальном - даже код валидный

Автор: Cheba 27.12.2005, 00:23

Надо же. Я думал, там будет больше косяков. Мне нужна чья-то помощь, чтобы довести это до ума в ИЕ.

Автор: batigoal 27.12.2005, 09:11

Вроде все ОК. Начинаю работу над разделом Java со 2-го января

Автор: sergejzr 27.12.2005, 13:33

Из Вики приходят письма в странной кодировке. Каракули в общем невосстановимые...

Автор: Cheba 27.12.2005, 15:29

Странно. Мне нормальные приходили. Да и то только один раз. Что за письма?

Автор: sergejzr 27.12.2005, 17:21

Письмо - проверка мыла. Приходит при регистрации.

Автор: batigoal 27.12.2005, 17:22

Мне в нормальном виде пришло Добавлено @ 17:23 Слушайте, а верхний пост все видят в формате Цитата <table class="hltable_full" cellspacing="0"><tbody><tr><td><a href="javaScript: selectAll('cppY1Yzhl')"><img alt="Выделить всё" src="http://files.vingrad.ru/sergej.z/img/select.gif"></a><b>код C++</b></td></tr><tr><td><div class="simplepane" id="codecppY1Yzhl"><table class="codetable" id="codetablecppY1Yzhl" cellspacing="0"><tbody><tr><td class="code1"><table class="innertable_left" cellspacing="0"><tbody><tr><td>1:</td></tr><tr><td>2:</td></tr></tbody></table></td><td class="code2" id="codeCellcppY1Yzhl"><table id="codeIncppY1Yzhl" class="innertable" cellspacing="0"><tbody><tr><td><a href="http://wiki.vingrad.ru/index.php?title=MANUAL_RU_CPP:int"><span style="color: blue;">int</span></a>&nbsp;n;</td></tr><tr><td><b></b>&nbsp;&nbsp;<a href="http://wiki.vingrad.ru/index.php?title=MANUAL_RU_CPP:cout"><span style="color: blue;">cout</span></a>&lt;&lt;<span style="color: green;">"Enter&nbsp;the&nbsp;n&nbsp;=&nbsp;"</span>;</td></tr></tbody></table></td></tr></tbody></table></div></td></tr></tbody></table>

Автор: Cheba 27.12.2005, 21:19

Вот и мне приходило. Только там все было нормально. Получал на GMail'е.

Автор: Cr@$h 29.12.2005, 15:48

Можно будет Fortran в Wiki добавить?

Автор: Cheba 30.12.2005, 13:25

Cr@$h, конечно можно. Не стесняйся. На то она и wiki, что в нее можно что угодно добавить.

Автор: Cr@$h 30.12.2005, 20:26

Хорошо, да будет так. Я начну потихоньку. А может его и в подсветку добавить? Если да, то что для этого надо будет сделать?

Автор: sergejzr 30.12.2005, 20:32

торетически да, практически уже меню переполнено А ещё алекс предложил ActionScript.... Надо голосовать. А добавить - не проблема. Можно сделать только функционал, без меню...

Автор: AlDev 31.12.2005, 07:52

Цитата(sergej @ 31.12.2005, 01:32) торетически да, практически уже меню переполнено smile А ещё алекс предложил ActionScript.... Надо голосовать. А добавить - не проблема. Можно сделать только функционал, без меню... как вариант. + в правилах раздела написать, что подсветка работает, например, через [code=ActionScript] тогда и с меню не надо мучаться.

Автор: Cheba 31.12.2005, 18:03

sergej.z, перегружено, бо очень линное? Так вы его в два столбика пустите. ;)

Автор: Alx 1.1.2006, 20:55

начаниаю разбираться и потихоньку заполнять JS Добавлено @ 21:03 а где можно получить список выражений нашей подсветки?

Автор: sergejzr 1.1.2006, 21:20

Alx, кстати, яваскрипт как раз до сих пор не готов и подсвкчивает в основном яву. Если есть желание заняться - сотсавь список ключ. слов. А вообще, все слова как есть сейчас здесь: http://vingrad.eurohoster.net/index.php?showtopic=58234&st=0&#entry464293

Автор: Void 1.1.2006, 21:47

Меня всегда интересовало, почему было принято решение добавить в подсветку кода C++ (а возможно и других языков), названия ряда стандартных классов, как ключевых слов? Имхо, довольно неудачное решение, особенно с учетом того, что половина классов STL в этот список все равно не попала. Можете объяснить или дать линк на обсуждение?

Автор: Alx 1.1.2006, 22:15

Цитата(sergej @ 1.1.2006, 21:20) кстати, яваскрипт как раз до сих пор не готов и подсвкчивает в основном яву ты имеешь ввиду подсветку?

Автор: Wowa 1.1.2006, 23:34

Alx да, подсветку

Автор: Cheba 1.1.2006, 23:40

Внимание!!! Настоятельно рекомендую всем ознакомиться со следующими статьями: http://wiki.vingrad.ru/index.php/Vingrad:%D0%9A%D0%B0%D0%BA_%D0%BF%D0%BE%D0%BC%D0%BE%D1%87%D1%8C http://wiki.vingrad.ru/index.php/Vingrad:%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0 http://wiki.vingrad.ru/index.php/Vingrad:%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0_%D0%B8_%D1%80%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%B0:%D0%98%D0%BC%D0%B5%D0%BD%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_%D1%81%D1%82%D0%B0%D1%82%D0%B5%D0%B9 http://wiki.vingrad.ru/index.php/Vingrad:%D0%9F%D1%80%D0%B0%D0%B2%D0%B8%D0%BB%D0%B0_%D0%B8_%D1%80%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%B0:%D0%9E%D1%84%D0%BE%D1%80%D0%BC%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%81%D1%82%D0%B0%D1%82%D0%B5%D0%B9 В данный момент это особенно касается товарища Cr@$h'а и Alx'а. Cr@$h, настоятельно рекомендую к ознакомления две последние статьи. Кроме того, это русскоязычная вики. Поэтому там дожна быть информация только на русском. Если ты собираешься все это переводить, то включай в начало документа шаблон {{draft}}.

Автор: Alx 2.1.2006, 03:18

Cheba вообще-то я старался делать по образу раделов PHP и ActionScript... и матом вроде не ругался...

Автор: Cr@$h 2.1.2006, 15:28

Цитата(Cheba @ 2.1.2006, 00:40) Кроме того, это русскоязычная вики. Поэтому там дожна быть информация только на русском. Я ориентировался на: Цитата(sergej @ 29.11.2005, 03:59) описалово этой функции на других языках (думаем сделать 3 языка: русский - англ. нем.) Попрошу пожалуйста прокомментить этот вопрос: один язык или несколько? P.S. Спасибо за ссылки. Наверное, слишком рано стартовал, когда еще как раз трех последних правил не было. Сам я люблю определенность и обязательно переделаю, что следует.

Автор: Cheba 2.1.2006, 16:54

Пока-что решено создать только русскоязычную вики. Возможно, со времененм будут и другие национальные языки. Пока-что следует ориентироваться только на русский. И обрати внимание на именование и форматирование. Из того, что я заметил: Ты везде убираешь содержание и редактирование разделов. Это не есть хорошо. Если кто-то захочет дополнить статью, то ему прийдется редактировать вся страницу. Но ведь гораздо удобнее отредактировать только ту часть, к которой есть что добавить. Ссылки в заголовках - не наилучшее решение. Если хочешь сделать страницу-содержание, то пользуйся просто списком ссылок. Нумерование заголовков - тоже не прикольно. Вики сама их нумерует в содержании. Если надо сделать ссылку на другую часть документации, то не надо указывать"см. § 8.7.2". Лучше сразу дать ссылка "подробнее описано в статье о [[ProgLang:Переменные|переменных]]". Это и приятнее смотрится в статье и гораздо удобнее - вместо поисков того самого параграфа можно сразу перейти на нужную статью. Помните, это не печатное издание - это гипертектовый документ. Так давайте же использовать все его преимущества. Еще ты вставляешь лишние пробелы в названия статей и ту же нумерацию. Лучше этого не делать. Пользуйся расширением Title Override. Breadcrumbs вставляй в самом начале документа. Там его проще найти. И, конечно же, все статьи должны выглядеть одинаково не зависимо от авторства. Alx, а теперь замечания к тебе. Никто не забыт. Свою подпись в документ можно вставить гораздо проще. ~~~ - короткая подпись. Только ссылка на персональную страницу. ~~~~ - длинная подпись. Ссылка на персональную страницу и время ее проставления. Принято перед подписями проставлять два минуса: --~~~~ Однако, подпись проставляется только, если ты являешься автором статьи и разрешаешь ее распространение по лицензии, указанной в вики. У нас это GNU FDL. Документация, которая не является плодом твоей мозговой деятельности, не должна иметь подписи. Сюда относятся переносы из других источников, переводы и прочее в том же духе. В любом случае история документа хранит кто когда и что сделал, так-что не беспокойтесь - Вы не почините безвестности.

Автор: Cr@$h 2.1.2006, 18:40

Цитата(Cheba @ 2.1.2006, 17:54) Ты везде убираешь содержание и редактирование разделов. Это не есть хорошо. Если кто-то захочет дополнить статью, то ему прийдется редактировать вся страницу. Но ведь гораздо удобнее отредактировать только ту часть, к которой есть что добавить. Просто по части стандарта -- вряд ли его статьи часто придется редактировать В остальном согласен и до чего-то даже сам додумался. Так или иначе, русский так русский, я даже рад. Все статьи я засейвил у себя на компе. Нужно сносить англоязычный раздел. Как это проще сделать?

Автор: Cheba 2.1.2006, 20:02

Все статьи на снос помещай в категорию Junk: [[Category:Junk]] В комментарие правки указывайте причину, по которой статью нужно удалить.

Автор: batigoal 2.1.2006, 21:18

Такой вопрос. У нас будет возможость ссылаться из разных ключевых слов в подсветке синтаксиса на одну и ту же статью в Вики? Я имею в виду пары switch-case, if-else, try-catch, interface-implements и т.п. Или их нужно разносить в разные статьи и кидать линк?

Автор: sergejzr 2.1.2006, 22:02

Каждому слову - отдельную статью. По другому технически будет очень сложно реализовать.

Автор: Cheba 2.1.2006, 22:12

Нет, нет. Не нужно отдельных. Можно и без этого обойтись. Просто напиши статью "if else" и сделай на него ссылки из "if" и "else".

Автор: Cr@$h 2.1.2006, 22:25

Цитата(Cheba @ 2.1.2006, 21:02) Все статьи на снос помещай в категорию Junk Roger that. А как быть с категориями? Они автоматом удалятся, если в них статей не будет, или подкатегории пустые..?

Автор: Cheba 2.1.2006, 22:35

Кстати, коли у нас появился свой раздел, то теперь давайте создвать отдельные темы на отдельные вопросы.

Автор: Cheba 2.1.2006, 23:10

Цитата(Cr @ 2.1.2006, 22:25) как быть с категориями? Они автоматом удалятся, если в них статей не будет, или подкатегории пустые..? Категории будут удалены автоматом, если на их страницах нет текста. Иначе они будут сохранены.

Автор: Cr@$h 2.1.2006, 23:40

Цитата(Cheba @ 3.1.2006, 00:10) Категории будут удалены автоматом, если на их страницах нет текста. Иначе они будут сохранены. Done. Все англоязычные категории и статьи пометил Junk. Начну публиковать на родном языке.

Автор: Alx 3.1.2006, 22:42

Cheba понял, учту) sergej.z на счет мезъязыкового словаря. в связи с разработкой Вики (как я полагаю) наш Wowa предложил закрыть раздел с Межъязыковым словарём, как ты считаешь, нужно? просто я считаю, что ссылки на выражения из других языков в Wiki это хорошо, но словарь и энциклопедия это разные вещи. Я бы не стал отказываться от словаря, как проекта в пользу такого модуля в Вики, потому что теряется сама идея, которая вроде бы вызвала некоторое одобрение у наших форумчан. Если продвигать проекты по отдельности, то больше шансов что они будут востребоны теми, кто нуждается именно в одном, а не в другом. То что я говорю ни в коем случае не обозначает что я хочу чтобы делали отдельный словарь, а из Вики убрали поддержку, нет, просто мне кажется, что словарь сам по себе ценен как идея, проект и потенциальным программистам гораздо удобнее скачать к себе оффлайновую версию или зайти на сайт со словарём (сейчас он здесь - http://d-translit.alx.com.ru/), чем рыться в энциклопедии. Короче говоря я за оба проекта всеми руками и ногами, за их взаимосвязь, но против оставления чего-то одного и избавления от второго..)) вот так вот - что скажете?)

Автор: Wowa 3.1.2006, 22:59

Цитата(Alx @ 3.1.2006, 20:42) в связи с разработкой Вики (как я полагаю) наш Wowa предложил закрыть раздел с Межъязыковым словарём не столько из-за этого, сколько из-за того, что проект больше года не развивается, как мне показалось.

Автор: Cr@$h 3.1.2006, 23:17

Лично считаю, что Wiki больше подходит для этого, чем просто транслит (извиняюсь, если что, с проектом-словарем полностью не знаком, просто зашел по предоставленной ссылке). Можно объяснять в общих терминах конструкции структурного и ОО программирования, классы и даже библиотеки языков, давая конкретные ссылки в разные языки на эти термы. Так и понятнее будет язык осваивать (раз уж стали копаться), зная какой-то другой, напрмер, С.

Автор: sergejzr 3.1.2006, 23:30

Цитата(Alx @ 3.1.2006, 21:42) в связи с разработкой Вики (как я полагаю) наш Wowa предложил закрыть раздел с Межъязыковым словарём, как ты считаешь, нужно? Цитата(Wowa @ 3.1.2006, 21:59) не столько из-за этого, сколько из-за того, что проект больше года не развивается, как мне показалось. Угу. А на базе Вики словарь будет может развиваться самими пользователями. (Именно словарь, а не энциклопедия.). Другое дело, что потом можно будет очень легко приделать интерфейс переводчика, как он реализован на твоём сайте. Вообще самая большая проблема подобных проектов это даже не техническая реализация, а сбор и заполнение базы информацией. Лучше Вики для этого инструмента ИМХО пока не изобрели.

Автор: Kefir 17.9.2006, 09:41

Потихоньку начинаю заполнять ПХП функции.

Автор: Kefir 17.9.2006, 10:07

Этооо... у мя есть [[PHP:Функции:Функции DB++|Функции DB++]], но оно не преобразуется в линку - как сделать нормально? Добавлено @ 10:12  и ещё - нужно ваше мнение: 1. Использовать ли постоянно слово "функции" (напр. писать "Функции для работы с изображениями" или "Работа с изображениями") 2. Стоит оставить http://www.php.net/manual/ru/funcref.php или самому подправлять, чтобы шло в алфавитном порядке?

Автор: Cheba 17.9.2006, 14:12

Плюсы недопустимы в названиях. Замени их каким-нибудь "pp" или еще чем-то в том же духе. 1, 2) Зависит от того, что ты хочешь построить. Если хочешь перенести их доку в вики, то луше оставить как у них - потом будет легче содержать все в порядке и дополнять новыми материалами. Если хочешь сделать "по-своему"/"лучше"/"удобней" (в кавычках чтобы подчеркнуть субъективность понятий ), то делай как считаешь нужным. В этом случае проконсультируйся еще у кого-то, кто тесно работает с языком и его документацией - не будет лишним.

Автор: Kefir 17.9.2006, 14:22

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

Автор: Exception 18.9.2006, 00:39

Цитата(Kefir @  17.9.2006,  11:07 ) [[PHP:Функции:Функции DB++|Функции DB++]] [[PHP:Функции:Функции DB Plus Plus|Функции DB++]]

Автор: Cr@$h 18.9.2006, 03:16

Powered by Invision Power Board (http://www.invisionboard.com)
© Invision Power Services (http://www.invisionpower.com)