Краткое введение в Foswiki

Используйте кнопки навигации слайд-шоу в правом нижнем углу страницы

Что такое Wiki?

Hula girl

Основная функция Foswiki - это Вики (если такое пояснение поможет!)

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

  • "Вики" - происходит от сокращенного "wiki wiki", что с гавайского переводится как «быстрый» (это оправдывает изображение милой танцовщицы в юбке "хула")
  • Авторы идеи Macintosh Hypercard, через Ward Cunningham
  • По словам Уорда, Вики - это "наиболее простая оперативная база данных, которая способна работать"
  • в сущности, Вики - это постоянная интерактивная доска

Вики Foswiki

Whiteboard Foswiki реализует Вики-идею интерактивной доски

  • Каждый может добавлять контент
    ... или менять написанное
    ... или менять организацию контента
  • Все, что вы пишете
    ... будет хорошо представлено
    ... будет сохранено в памяти... и никогда не будет утеряно
  • Пишите, используя свойство текстового редактора «что видишь, то и получишь» (WYSIWYG)
    ... либо вы можете использовать простой текст с простым языком разметки тем, который можно быстро освоить и легко запомнить
    ... либо вы можете использовать полный HTML-формат для сложных задач форматирования

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

Foswiki - это разработка с открытым исходным кодом на сайте https://foswiki.org/
  • управляется Ассоциацией Foswiki
  • с множеством добровольных участников во многих странах
  • FOSWiki = Free Open Source Wiki (Вики с открытым исходным кодом)

Свойства Foswiki

Foswiki строится на оригинальной концепции Wiki и добавляет функции, которые делают ее очень полезной в деловой среде.
  • Контроль версий всех страниц регистрирует изменения на каждой странице
    r6 < r5 < r4 < r3 < r2
  • Мощные макросы позволяют пользователям создавать и использовать собственные онлайн-приложения
  • Точно настраиваемый внешний вид, благодаря использованию макросов и шаблонов
  • Упрошенный интерфейс плагинов
    • кастомизация
    • расширение
    • интеграция существующих приложений
  • Сотни видов расширения поддерживают дополнительные функции и позволяют интегрировать сторонние приложения
  • Безопасно и надежно

Приложения для базовой Foswiki

Foswiki может использоваться в качестве:
  • Интерактивной доски
  • Репозитория документации
  • Среды для совместной работы
  • Блокнота / альбома
  • Раздела чата

Расширенные приложения

Foswiki-с-расширениями может использоваться:
  • для управления контентом (CMS) сайтов
  • для разработки презентации
  • в качестве Блога
  • в качестве(простой) базы данных
  • в качестве системы управления проектами
  • для коллажей
  • в качестве инструмента отслеживания
  • (правда, что мы действительно не знаем его границ!)

Структура страницы Foswiki

Страницы Foswiki называются темами. Когда они просматриваются в браузере, они как правило состоят из четырех частей:
  • Верхний колонтитул
  • Меню
  • Основная часть
  • Нижний колонтитул

  • Верхний и нижний колонтитулы генерируются системой
  • Меню также генерируется системой, но в основном из контента, предоставленного вами
  • Основная часть содержит текст темы, введенный вами

Foswiki имеет очень изменяемую конфигурацию, его внешний вид может меняться. Однако все необходимое будет на странице (где-то!)

Верхний колонтитул

Верхний колонтитул страницы Foswiki, как правило, выделяется и, как правило, содержит значок, который дает вам представление о том, где вы находитесь, например логотип компании. Он также обычно содержит:
  • Поле Поиска, которое позволяет вам искать темы или контент по всему сайту Foswiki
  • Поле Перехода, в котором вы можете ввести имя уже знакомой вам страницы.

http://wiki.stack.sitishost.ru/pub/System/BeginnersStartHere/myco.gif
(это всего лишь пример. Ваш заголовок будет выглядеть намного лучше. smile )

Меню - часть 1

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

Раздел Панель Инструментов обычно содержит следующие элементы

    • Toolbox

    • newtopic Create New Topic - for creating new topics via a menu

    • index Index - an alphabetical listing of all topics in the web

    • searchtopic Search - leads to a more advanced search page

    • changes Changes - shows a list of recently changed topics

    • notify Notifications - allows you to subscribe to receiving emails when topics change

    • feed RSS Feed

    • statistics Statistics - for the activities current web

    • wrench Preferences - settings for the current web

Часто администратор сайта упрощает набор инструментов, поэтому у вас может не быть всех этих элементов в строке меню.

Меню - часть 2

В разделе Сети перечислены все сети, к которым вы можете получить доступ

    • Webs

    • Main

    • Myco

    • Project

    • Sandbox

    • System

Сеть представляет собой набор страниц, которые тесно связаны друг с другом

Сеть Main содержит все домашние страницы пользователей. Сеть System содержит документацию для Foswiki и всех расширений. Сеть Sandbox - это игровая площадка.

Ваша вики может содержать любое количество сетей, а сети могут содержать другие сети.

Slide 10 of 31

Меню - часть 3

Помимо разделов «Инструменты» и «Сети», можно добавить свои собственные ссылки в важные места.

Эти пункты меню могут отличаться от одной сети к другой.

    • Myco

    • Important topic

    • Company philosophy

Slide 11 of 31

Нижний колонтитул

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

Edit | Attach | Print version | History: r2 < r1 | Backlinks | View wiki text | Edit wiki text | More topic actions
  • Элемент управления Редоктирование позволяет перейти на интерактивную страницу, где вы можете изменить содержимое страницы с помощью редактора WYSIWYG
  • Ссылка Прикрепить позволяет вам прикреплять файлы
  • Версия для печати показывает страницу без каких-либо меню или верхних строк - для печати на бумаге
  • История позволяет увидеть более старые версии и то, что изменилось от версии к версии
  • Обратные ссылки показывают, какие другие страницы ссылаются на эту страницу
  • Просмотр Текста Вики - для просмотра темы на языке разметки
  • Редактировать Текст Вики предназначен для редактирования темы с использованием языка разметки темы в простом текстовом редакторе
  • Дополнительные действия по темам - переход к меню менее часто используемых функций

Slide 12 of 31

Редактирование страниц

  • Вы прочитали страницу и решительно с ней не согласны! На ней сказано:
    Всем известно,что Земляплоская
    Но вы то знаете, что это в действительности она - сплющенный у полюсов одноосный эллипсоид! wink
  • Вы нажали на ссылку редактирования, и появилась страница редактирования
    • В зависимости от конфигурации вашего сайта, вы, вероятно, увидите редактор WYSIWYG и сможете начать писать прямо сейчас, как в текстовом процессоре
    • Но если вы нажмете на ссылку «Редактировать Текст Вики», то, то что вы увидите, будет не очень похоже на то, что было на странице раньше.

_Все_ *знают* что =Земля это %BLUE%плоскость%ENCDCOLOR%=
  • Что теперь?

Slide 13 of 31

Что на странице

  • Иероглифы - это то, что известно как «Язык Разметки Тем»
  • Это действительно простой способ сообщить браузеру, как вы хотите, чтобы страница выглядела
  • Вам не нужно их использовать
    • Foswiki прекрасно понимает страницы в виде простого текста.

      В действительности она - сплющенный у полюсов одноосный эллипсоид!

      отображается как

      В действительности она - сплющенный у полюсов одноосный эллипсоид!
  • Или вы можете использовать редактор WYSIYG

Slide 14 of 31

Иероглифы просто украшают страницы

... и их легче читать

_В действительности_ она - *сплющенный у полюсов* __одноосный эллипсоид__

отображается как

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

Slide 15 of 31

Обычно используемое форматирование

Foswiki прекрасно понимает страницы в виде простого текста, но вы можете смешать их начисто, используя несколько простых комбинаций форматирования. Вот некоторые из наиболее часто используемых:
  • ---+ обозначает верхний колонтитул. Добавьте больше +, чтобы получить более широкий верхний колонтитул.

You typeYou see
---+ This is a heading

This is a heading

---++ And so is this

And so is this

  • %TOC% вставит оглавление

Slide 16 of 31

Более распространенное форматирование

  • Пустая строка дает разрыв абзаца
  • --- на отдельной строке выдает горизонтальную строку
  • Текст между звездочками *таким образом* выглядит так
  • Текст с подчеркиваниями _таким образом_ выглядит так
  • Текст в знаках равенства =таким образом= выглядит так
  • Маркированные списки используют три пробела, за которыми следует звездочка (*) в начале строки
  • Глубина маркера задается чмслом пробелов, кратным трем

You type You seeSorted ascending
   * Bullet
      * Sub-bullet
  • Bullet
    • Sub-bullet
  • Нумерованные списки используют число вместо *. Список нумеруется автоматически, так что вы можете просто использовать 1

Slide 17 of 31

И еще.....

  • Вы можете создать таблицу, используя вертикальные полосы

     | Cat | Feline |
     | Bear | Ursine |
     | Wolf | Lupine |
  • отображается как
Cat Feline
Bear Ursine
Wolf Lupine
  • %RED% .... %ENDCOLOR% изменяет цвет вложенного текста. Доступно много цветов (%RED%, %GREEN%, %BLUE% etc)

Slide 18 of 31

ВикиСлова

  • Один специальный иероглиф, который очень важен - это WikiWord
    • слово, которое начинается с заглавной буквы, продолжается строчными буквами и затем снова с заглавной буквы (это известно как CamelCase)
  • Это имеет особое значение для Foswiki. Если оно соответствует названию другой темы, Foswiki автоматически создаст для вас ссылку на эту страницу
  • Если такой страницы не существует, то слово подсвечивается по-другому, LikeThis
  • Если вы нажмете на слово, то Foswiki предлжит вам создать эту страницу.



  • Это позволяет вам вводить названия тем, которые, по вашему мнению, должны существовать, но еще не существуют
    • Вы или кто-то другой, всегда можете прийти позже и нажать на знак вопроса!

Slide 19 of 31

Ссылки на другие страницы и URL

  • WikiWords автоматически ссылается на целевую страницу
    • Вы можете сделать эти ссылки более удобными для чтения, используя квадратные скобки:
      • [[WikiWords][bumpy words]] отображается как bumpy words
  • Обычный URL, вставленный в текст, будет отображаться в виде ссылки - http://www.google.com
    • Вы также можете предварительно оптимизировать URL-адреса, используя квадратные скобки:
      • [[http://www.google.com/][Google]] отображается как Google
  • Use %ПОИСК. Это интерфейс к сложной поисковой системе, которая встраивает результаты поиска на вашу страницу. См. System.Macros для полной информации..

Slide 20 of 31

Больше возможностей форматирования

  • Доступно гораздо больше возможностей форматирования,см. TopicMarkupLanguage
  • Если вы эксперт по HTML, вы можете даже ввести необработанный HTML!
  • Важно отключить нежелательное форматирование, используйте <nop>
    • <nop>_слово_ отображается как _слово_

Slide 21 of 31

Создание новых страниц

  • Альтернативные способы:
    • Нажмите на знак вопроса после WikiWord
    • Введите название темы в поле «Перейти:»
    • Введите название темы в URL
  • Каждый раз, когда вы пытаетесь посетить несуществующую страницу, Foswiki предложит вам ее создать.
  • Убедитесь, что названия тем всегда WikiWords.

Slide 22 of 31

Вложения

  • Вложения - это файлы, которые были загружены и прикреплены к теме Foswiki с помощью ссылки [Прикрепить] на панели инструментов.

IAttachmentActionSizeDateWhoComment
txt Sample.txt manage 0.1 K 22 Jul 2000 - 19:37 ProjectContributor Just a sample
gif Smile.gif manage 0.1 K 22 Jul 2000 - 19:38 ProjectContributor Smiley face

Ссылки в приведенной выше таблице просто для наглядности и никуда не денутся

  • Вложения - это просто файлы в любом формате.
  • Foswiki распознает некоторые форматы файлов, особенно файлы изображений (.gif, .jpeg, ...)
    • Напишите %ATTACHURL%/myco.gif, чтобы увидеть это: myco.gif

Slide 23 of 31

Вики-культура

Достаточно слов о механике; как на самом деле используется Вики? Что ж, это действительно зависит от вас, но есть несколько приемов, разработанных Ввики-сообществом для совместной работы:
  • Что я могу редактировать?
    • Все, что угодно. Однако принято подписывать свой вклад
    • Если кто-то не желает, чтобы вы редактировали страницу, он может сказать об этом прямо на странице
  • Но что, если кому-то не нравятся мои правки?
    • В Foswiki они всегда могут восстановить старую версию и восстановить ее, если они действительно хотят
    • В противном случае они должны рассматривать ваши изменения как возможность для обсуждения
  • Страницы в Вики (обычно) находятся в одном из трех "режимов"
    • РежимДокумента
    • ТематическийРежим
    • СтруктурированныйРежим
Foswiki автоматически не различает эти режимы; они чисто семантические.

Slide 24 of 31

Это хорошо для Интернета, но ...

Люди часто говорят, что культура Вики не подходит для корпоративной среды. Не верьте им! Обмен информацией помогает любой компании работать более эффективно. Однако могут вознимать настоящие вопросы безопасности, поэтому:
  • Просмотр/редактирование тем может быть ограничено любым человеком или группой лиц
  • Foswiki может быть интегрирован с корпоративными решениями единого входа

Slide 25 of 31

РежимДокумента

  • Страница в РежимеДокумента, как правило, состоит из вклада, написанного от третьего лица и оставленного без подписи.
  • Часть текста является собственностью сообщества
    • У него может быть несколько и меняющихся авторов, поскольку он обновляется, чтобы отражать согласие сообщества

Slide 26 of 31

ТематическийРежим

  • Тематический Режим - это форма обсуждения, где сообщество ведет беседу
  • Обсуждение обычно начинается с заявления в верхней части страницы, которое впоследствии обсуждается
  • Страница может периодически подвергаться редактированию для удаления некоторых комментариев
    • Пока комментарий точно отражается в том, что его заменяет, обычно никто не возражает.
    • Не забывайте всегда поддерживать полный список участников!
Вы можете увидеть поле для комментариев на странице в ТематическомРежиме, что позволяет быстро добавлять свои входные данные. Ввод комментария и добавление его на страницу таким способом называется «ведение блога» wink
  • ТематическийРежим скорее напоминает на тему электронной почты
    • За исключением того, что новые комментарии обычно добавляются в конец
  • Страницы Тематический<nop>Режим часто преобразуется в РежимДокумента

Slide 27 of 31

СтруктурированныйРежим

  • Страница в СтруктурированномРежиме следует некоторой предопределенной структуре, например
    • Повестка дня
    • Набор минут встречи
    • Описание требования.
  • Страницы в СтруктурированномРежиме обычно имеют правила, кторые определяют их редактирование.

Slide 28 of 31

Добавленные функции

Базовый Foswiki содержит множество функций, однакоеще больше обогащается дополнительными модулями расширения, которые могут (или не могут!) быть установлены в вашем Foswiki. Они обычно классифицируются как скины (модули, которые изменяют внешний вид), плагины (модули, улучшающие функциональность), вики-приложения (наборы тем, реализующих приложение) или вкладки (модули, которые настраивают foswiki на глубоком уровне).

Когда Foswiki впервые устанавливается, он поставляется с предварительно установленным набором расширений по умолчанию; Вы можете увидеть список, посетив страницу InstalledPlugins page.

Существует огромное количество других расширений, доступных по адресу https://foswiki.org/Extensions

Slide 29 of 31

Получить дополнительную информацию

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

Если вы уперлись в стенку, вы можете перейти на страницу https://foswiki.org/Support, где есть множество онлайн-ресурсов, или присоединиться к дружественному IRC-каналу Foswiki по адресу irc://irc.freenode.net/foswiki

Slide 30 of 31

Благодарности

Slide 31 of 31

This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback