confluence Добавить дочернюю вложенную страницу/раздел/группу страниц в дерево, иерархию
Предположим у вас уже есть какая-то иерархия страниц (обычно выводится в слева в инспекторе), тогда делаем так:
- Переходим на страницу, в которую хоти добавить дочернюю
- Далее нажимаем кнопку Create (в нашей версии она находилась сверху) — и просто создаем новую страницу и сохраняем, по умолчанию в иерархии она будет расположена как дочерняя, по отношению к ранее открытой
Добавить вложенный раздел раздел — группу страниц
Если в какую-то страницу добавлена дочерняя (см. выше), то она становится сама разделом и в иерархии дерева отображается как раздел (можно сворачивать и разворачивать)
Key Words for FKN + antitotal forum (CS VSU):
- Log in to post comments
- 2658 reads
Создавайте контент и сотрудничайте
Основные достоинства Confluence Cloud — это эффективность и гибкость. Продукт позволяет без труда создать насыщенный динамический контент. При этом все начинается со страницы — динамического документа, в котором размещается контент. В этом руководстве вы научитесь использовать Confluence для создания и редактирования страниц, добавления контента, поиска неопубликованных черновиков страниц, ограничения доступа к странице и многого другого.
Если вы используете вариант Confluence Data Center или Confluence Server, узнайте из этого обучающего руководства, как создавать и редактировать страницы в Confluence.
Создание новой страницы
Создать контент в Confluence Cloud очень легко: просто нажмите Create (Создать) и заполните страницу текстовой информацией, таблицами, изображениями и другим содержимым. В отличие от традиционного документа Word, созданные в Confluence страницы динамически изменяются в режиме реального времени. Любой пользователь, имеющий доступ к сайту Confluence, сможет увидеть, что вы написали (конечно, если вы захотите это показать). В этом разделе вы узнаете, как выбирать нужный шаблон, поймете разницу между черновиками и опубликованными страницами, научитесь управлять доступом к просмотру, редактированию и комментированию страниц и использовать метки для упорядочения контента.
Шаблоны
Вместе с Confluence Cloud поставляются более 70 шаблонов. С их помощью можно создавать любые страницы: от протоколов собраний до требований к продуктам и маркетинговых планов. В шаблонах есть все необходимое для создания прекрасного, эффективного и динамического контента.
Чтобы создать страницу на основе шаблона, нажмите Create (Создать) и выберите нужный шаблон. Подробнее о шаблонах страниц в Confluence см. в нашей документации.
Профессиональный совет
Если нужного шаблона нет в галерее, можно установить дополнительные шаблоны из Atlassian Marketplace, отредактировать существующие шаблоны с учетом потребностей команды или создать собственные шаблоны.
Черновики и опубликованные страницы
Значок: замок безопасностиПосле создания новой страницы и до момента публикации она остается в состоянии черновика, то есть отсутствует в дереве страниц, лентах событий и результатах поиска (после публикации страница появится во всех этих местах, если она не ). Черновики сохраняются автоматически, даже если вы их не публикуете. Чтобы увидеть неопубликованные черновики, выберите в верхнем меню Recents > Drafts (Последние > Черновики).
Профессиональный совет
Не хотите, чтобы все узнали о том, что вы опубликовали новую версию? Нажмите значок меню ••• (Другие действия), который находится в правом верхнем углу, рядом с кнопкой Close (Закрыть), и выберите команду Publish without notifying watchers (Опубликовать без уведомления наблюдателей).
Ограничение доступа к страницам
По умолчанию просматривать (а также комментировать и редактировать) страницы в разделе могут все, кто имеет доступ к разделу. Чтобы изменить права доступа к странице после ее публикации, нажмите значок в правом верхнем углу (при просмотре страницы она находится рядом с кнопкой Share (Поделиться)) и выберите нужный вариант из раскрывающегося меню. Подробнее об ограничениях доступа к страницам и о том, как эти ограничения взаимодействуют с правами доступа к сайту и разделам, см. в документации Confluence Cloud.
Почему доступ к страницам по умолчанию открыт?
Confluence имеет прозрачную интегрированную структуру и предназначен для предоставления доступа к нужной информации и контексту всем, кому это необходимо для эффективной работы. Когда все имеют доступ к проектам, целям и стратегии команды, проще обеспечивать согласованную работу команд и не допускать потери знаний в организации при изменении должностных обязанностей сотрудников или их увольнении.
Профессиональный совет
Доступ к странице можно ограничить и до ее публикации. Просто нажмите значок рядом с кнопкой Publish (Опубликовать) во время редактирования чернового варианта. После ограничения доступа к странице ее не смогут просматривать даже те, у кого есть ссылка, но отсутствуют необходимые права доступа.
Метки
Для упорядочения контента можно добавлять метки страницам и вложениям. Метки помогают легко распознавать сходный контент и быстро его находить, используя фильтрацию результатов поиска по метке.
Чтобы добавить метку к редактируемой странице:
- Нажмите значок меню ••• (Другие действия) и выберите команду Add labels (Добавить метки).
- Введите имя метки, которую вы хотите добавить, и нажмите Enter ⏎. Будет создана метка.
- Чтобы добавить метку странице, нажмите Add (Добавить).
- Нажмите Close (Закрыть).
Профессиональный совет
Для поиска всего содержимого с заданной меткой используйте префикс labelText: . Например, чтобы увидеть все страницы и вложения с меткой documentation, введите в строке поиска текст labelText:documentation .
Редактирование существующей страницы
Страницы Confluence — это «живые», динамически меняющиеся документы, которые могут обновляться при изменении ситуации. Для обновления страницы используют программу редактирования, с помощью которой можно тщательно настроить внешний вид и функциональную сторону страницы.
Чтобы отредактировать опубликованную страницу, во время ее просмотра нажмите значок карандаша в правом верхнем углу или клавишу e.
Возможности редактирования
Контент создается в программе редактирования. Здесь можно форматировать текст, управлять макетом страницы и выполнять многие другие действия:
- добавлять изображения и другие мультимедийные данные: загружать фотографии, видео и другие файлы, перетаскивая их на страницу;
- использовать разметку и фрагменты кода: выполнять встроенное форматирование с помощью языка разметки или ввести /code для добавления фрагмента кода;
- настраивать макет и ширину страницы: выбрать отображение в две или три колонки: обычное, широкое или по всей ширине;
- автоматически создавать умные ссылки: вставлять URL-адрес задачи Jira или страницы Confluence для создания Smart Link, которая будет автоматически обновляться при внесении изменений в исходный контент.
Можно также использовать расширенные возможности страниц, такие как действия или дорожные карты, и даже выполнять интеграцию с другими приложениями. Вот некоторые из наиболее популярных расширенных возможностей Confluence Cloud:
Расширенные возможности страниц
Описание
Команда слэш (косая черта)
Поместите на страницу текущую дату или выберите другую дату из календаря.
Команда слэш (косая черта)
- информационная панель ( /info )
- панель заметок ( /note )
- панель ошибок ( /error )
- панель успеха ( /success )
- панель предупреждений ( /warning )
Команда слэш (косая черта)
Создайте динамически обновляемое содержание.
Команда слэш (косая черта)
Встройте задачу Jira или отфильтрованный список задач.
Команда слэш (косая черта)
/jira или вставьте URL-адрес задачи
Создайте список всех вложений на странице.
Команда слэш (косая черта)
Создайте блок кода с подсветкой синтаксиса.
Команда слэш (косая черта)
Добавьте пользовательскую метку состояния.
Команда слэш (косая черта)
Команда слэш (косая черта)
Вставьте раскрывающийся текст.
Команда слэш (косая черта)
Фиксируйте и обобщайте решения.
Команда слэш (косая черта)
Планировщик дорожной карты
Создайте простую и наглядную дорожную карту для планирования проектов, релизов ПО и пр.
Команда слэш (косая черта)
Профессиональный совет
Для быстрого поиска и добавления расширенных возможностей страниц используйте команду «косая черта». Для просмотра всех доступных возможностей введите команду / во время редактирования или просмотрите приведенный выше список популярных расширенных возможностей страниц.
Неопубликованные изменения и версии
Когда вы редактируете страницу, выполняется автоматическое сохранение и синхронизация всех внесенных изменений, чтобы их могли видеть все пользователи, которые редактируют эту страницу. Но люди, просматривающие страницу, не увидят изменений, пока вы их не опубликуете. При каждой публикации изменений Confluence выпускает новую версию страницы и сохраняет ее в истории версий. Благодаря этому можно легко отслеживать изменения и при необходимости вернуться к предыдущей версии. Поэтому рекомендуем почаще сохранять изменения.
Профессиональный совет
Если внесенные в страницу изменения вас не устраивают, их можно отменить командой ••• > Revert to last published version (Другие действия > Вернуться к последней опубликованной версии).
Совместная работа
Разработка проектов в Confluence Cloud упрощает обмен информацией и совместную работу. Благодаря возможностям для совместной работы, которые предоставляет этот продукт, все сотрудники, независимо от должности, могут вносить предложения, делиться идеями и получать обратную связь. В этом разделе мы расскажем об этих возможностях и поясним, как они работают, чтобы вы и ваши коллеги могли эффективно сотрудничать.
Совместное редактирование
Одну страницу могут одновременно редактировать до 12 человек. Автоматическое сохранение и синхронизация изменений выполняются в режиме реального времени, так что все редактирующие видят одинаковую страницу. Аватары рядом с кнопкой publish (Опубликовать) показывают, какие пользователи в данный момент редактируют страницу, а значок + рядом с аватарами позволяет пригласить к участию в редактировании других пользователей.
Профессиональный совет
Чтобы пригласить кого-либо к совместной работе над неопубликованным черновиком, скопируйте URL-адрес из адресной строки своего браузера и отправьте его этим пользователям. URL-адрес будет содержать слово «edit» (редактировать).
Совместное использование и отслеживание
Делитесь страницами и записями в блогах со своими коллегами, чтобы пригласить из к совместной работе и запросить обратную связь. Чтобы поделиться страницей, нажмите кнопку Share (Поделиться) в правом верхнем углу во время просмотра страницы.
Значок глазаЗначок глазаВы можете также отслеживать страницы, записи в блогах и даже целые разделы и получать уведомления об их обновлении. Для отслеживания страницы, нажмите клавишу w или значок секундомера ( ) в правом верхнем углу во время просмотра страницы. Для отслеживания всего раздела, которому принадлежит страница, нажмите значок глаза ( ) и установите флажок Watch all content in this space (Отслеживать весь контент в этом разделе).
Профессиональный совет
Прежде чем поделиться страницей с кем-либо, проверьте права доступа к разделу и ограничения доступа к странице. Даже если вы поделитесь страницей, увидеть ее смогут только те пользователи, которые имеют право на ее просмотр.
Комментарии и отметки «Мне нравится»
Комментирование работы своих коллег поддерживает культуру открытости и вовлеченности, а просьба прокомментировать собственную работу позволяет повысить собственный уровень и взглянуть на сделанное под другим углом. Оставьте комментарий к странице, чтобы откликнуться на ее содержание в целом, или используйте встроенные комментарии, чтобы оставить отзыв о конкретном разделе или предложении на странице.
Как оставить встроенный комментарий.
- Выделите текст, на который вы хотите отреагировать.
- Нажмите Comment (Комментировать).
- Введите текст комментария и нажмите Save (Сохранить).
Кроме того, в Confluence Cloud вы можете помечать отметками «Мне нравится» страницы, записи в блогах и комментарии. Когда вы это делаете, авторы получают уведомления.
Профессиональный совет
Если страница или запись в блоге получит много отметок «Мне нравится» и комментариев, она появится на вкладке Popular (Популярные) раздела Activity (Действия) на боковой панели.
Настройте свой сайт и разделы
Узнайте, как настроить сайт Confluence и сгруппировать контент по разделам.
Навигация в Confluence
Освойте навигацию в Confluence Cloud, чтобы быстро находить нужную информацию.
Настройте свой сайт и разделы
Прежде чем начать работу с этим обучающим материалом, оформите подписку на бесплатную пробную версию Confluence Cloud. С помощью этого руководства вы настроите свой первый проект. Не закрывайте вкладку, пока будете оформлять подписку. Мы подождем вас.
Это руководство предназначено для Confluence Cloud. Если вас заинтересовала версия продукта с самостоятельным управлением, перейдите по ссылке >>
Если вы используете вариант Confluence Data Center или Confluence Server, узнайте из этого обучающего руководства, как создавать и редактировать страницы в Confluence.
Шаг 1. Изучение разделов
Сайт Confluence разбит на разделы. Разделы — это наборы связанных общим содержанием страниц, с которыми работаете вы и другие участники команды или сотрудники организации. В большинстве организаций используется несколько типов разделов: разделы для команд, разделы проектирования ПО, разделы документации и разделы баз знаний.
- Используйте разделы для команд, чтобы вовлечь участников команды в совместную работу для достижения масштабных целей и показателей OKR. Например, вы можете создать раздел для маркетинговой команды, чтобы она ориентировалась на OKR, была в курсе руководств по использованию брендов и основ рекламных сообщений и понимала общую маркетинговую стратегию организации.
- Используйте разделы проектирования ПО для отслеживания отдельных инициатив и проектов. Например, можно создать раздел проектирования, который станет единым источником достоверной информации обо всем, что связано с новой функциональной возможностью, которую разрабатывает компания: от требований к продукту и технических характеристик до протоколов собраний и ретроспектив.
- Используйте разделы документации для создания и упорядочения технической документации по продуктам и услугам, чтобы упростить ее дальнейшее применение.
- Используйте разделы баз знаний для хранения и извлечения ответов на распространенные вопросы, например разъяснения политик или ИТ-решений. Если вы оформили подписку на Jira Service Management, можно интегрировать этот продукт с сайтом Confluence, чтобы клиенты получили доступ к статьям из базы знаний.
- Используйте личный раздел в качестве «песочницы» для упорядочения своих заметок, отслеживания личных OKR и целей, а также черновых вариантов предложений по проектам, которые еще не попали в дорожную карту. Установите контакт с командой через записи в блоге. Это помогает познакомиться или сообщить, над чем вы в данный момент работаете.
Прежде чем создавать кучу разделов, подумайте о том, как организация будет использовать Confluence Cloud. Вот некоторые типовые примеры использования.
Описание
Примеры
- Документирование кадровой и правовой политики, рекомендаций, процедур и технических знаний.
- Написание статей, обучающих руководств и инструкций по и устранению неполадок и предоставление клиентам доступа к ним.
- Информирование клиентов об изменениях в продуктах, API и других сервисах.
- Если вы используете Confluence, чтобы делиться внутренними политиками и процедурами, возможно вам захочется создать отдельный раздел документации для каждой предметной области (например, для кадровой политики, правовой политики и ИТ).
- Если вы используете Confluence, чтобы делиться с клиентами статьями, задумайтесь о создании отдельного раздела документации и раздела базы знаний для каждого продукта или услуги.
Включите анонимный доступ к разделам и контенту, которые предназначены для просмотра клиентами. Можно также связать разделы с Jira Service Management, чтобы прикреплять статьи к запросам в службу поддержки.
Совместная работа над проектом
- Руководители проектов, дизайнеры и разработчики, определяющие требования к продукту и его технические характеристики.
- Маркетинговый план и план по информированию клиентов о предстоящем релизе.
- Исследователи, получающие исходную информацию о планах по изучению пользователей и предоставляющие результаты заинтересованным лицам.
- Создайте разделы для каждого продукта и страницу для каждого цикла релиза или запуска.
- Создайте раздел для каждой функциональной команды и страницу для каждого крупного проекта или инициативы.
- Используйте смешанный подход. Используйте командные разделы для важных стратегических инициатив (например, большого ребрендинга), а разделы проектирования — для тактических проектов и релизов.
Убедитесь, что все участники проекта имеют права доступа, необходимые для эффективной совместной работы.
Вовлечение сотрудников в работу
- Общий доступ к объявлениям в Confluence для поддержания культуры открытости и информирования участников.
- Публикация записей в блогах с целью представиться новой команде, поделиться знаниями, полученными на вебинаре или конференции, или рассказать коллегам о своей работе.
- Отслеживание популярных страниц и записей в блогах, чтобы понять, как чувствуют себя сотрудники компании и что для них в данный момент важно.
- Настройте блоги в каждом разделе и порекомендуйте сотрудникам использовать их, чтобы рассказать о своей работе.
- Предложите новым сотрудникам создать вступительную запись в блоге в рамках адаптации.
- Используйте для объявлений приветственное сообщение на главной странице сайта Confluence.
Установите приложения из Atlassian Marketplace, с которые позволят размещать на сайте Confluence Cloud каналы Slack, видеовызовы и многие другие элементы.
Шаг 2. Создание раздела
Если вы уже знаете, какие разделы нужны организации, пришло время создать свой первый раздел.
- Перейдите на сайт Confluence.
- Выберите на главной странице Create Space (Создать раздел).
- Выберите нужный тип раздела.
- Введите информацию в поля Space name (Название раздела), Space key (Идентификатор раздела) и другие.
- Настройте права доступа к разделу.
- Выберите Create (Создать).
После этого вы попадете в обзорную часть раздела. Здесь можно рассказать коллегам о назначении раздела и о том, кто может им пользоваться. На следующем шаге вы узнаете, как настроить обзорную часть нового раздела.
Шаг 3. Настройка обзорной части раздела
В каждом разделе есть обзорная часть, где можно рассказать участникам команды и другим заинтересованным лицам о назначении и содержании раздела. Если раздел был создан из шаблона, в его обзорной части будут присутствовать встроенные функции, которые помогут организовать большую часть раздела. Но даже в этом случае собственные настройки позволят превратить обзорную часть в идеальный центр предоставления всей информации, необходимой команде.
Значок карандашаДля настройки обзорной части выберите значок карандаша ( ) и отредактируйте обзорную часть как обычную страницу.
Чтобы повысить привлекательность обзорной части, используйте следующие рекомендации.
- Загрузите баннер или логотип, чтобы люди узнавали ваш раздел с первого взгляда.
- Опишите миссию и цели команды и добавьте ссылки на основные страницы.
- Добавьте содержание, календарь команды или дорожную карту.
Подробнее о том, как создать великолепную обзорную страницу, можно прочесть в документации Confluence Cloud или этой записи в блоге.
Нужен быстрый успех? Начните с шаблона главной страницы команды от Hubspot.
Шаг 4. Упорядочение контента
Теперь, когда первый раздел создан, можно приступить к его структурированию. Наша цель — облегчить навигацию в разделе, чтобы участники команды и другие заинтересованные лица могли быстро найти нужный контент.
Используйте родительские страницы для группирования сходного контента
В Confluence можно вкладывать одни страницы в другие и тем самым создавать в каждом разделе иерархию контента. Эта иерархия, представленная в виде дерева страниц, отображается на боковой панели раздела, слева от активной страницы.
Чтобы эффективно использовать дерево страниц, создайте отдельную страницу для каждой задачи или проекта, в которых участвует команда, и размещайте в ней связанные дочерние страницы. Если, к примеру, команда раз в две недели проводит ретроспективы, можно создать страницу верхнего уровня, назвать ее «Ретроспективы» и вкладывать в нее по одной странице на каждую проведенную ретроспективу.
В следующем примере показано, как одна из команд Atlassian использовала эту стратегию для организации своего раздела.
Создание ярлыков для важных страниц
Confluence позволяет создать для всех разделов сайта уникальные ярлыки разделов: ссылки, закрепленные на боковой панели раздела, над деревом страниц. Используйте их для выделения важного контента, чтобы его было просто найти.
Чтобы создать первый ярлык раздела, перейдите в нужный раздел и выберите + Add shortcut (+ Добавить ярлык) на боковой панели. Подробнее о ярлыках разделов, их редактировании и удалении, см. в части Настройка раздела.
Используйте метки для страниц и вложений
Метки позволяют легко выявить связанные страницы и вложения. Это облегчает участникам команд и другим заинтересованным лицам поиск нужной информации.
- Откройте страницу в Confluence.
- Выберите значок метки () в правом нижнем углу.*
- Введите имя нужной метки. Если метка с таким именем уже существует, она появится в меню автоподстановки.
- Чтобы добавить метку, выберите Add (Добавить).
- Для выхода из диалогового окна нажмите Close (Закрыть).
* Если вы не просматриваете, а редактируете страницу, перейдите в меню ••• (Другие действия) в правом верхнем углу и выберите команду Add labels (Добавить метки).
Давайте меткам понятные, содержательные имена. Например, метку для протоколов собраний можно назвать протоколы-собраний или собрания. Если добавить эту метку ко всем страницам с протоколами собраний, для просмотра всех протоколов собраний (из одного раздела или со всего сайта Confluence) можно будет просто выбрать эту метку. Можно также отобразить на одной странице все страницы, помеченные одной меткой, или искать контент по метке для упрощения поиска соответствующих страниц и вложений. Подробнее о метках см. в разделе Использование меток для упорядочения контента.
Профессиональный совет
Если добавить метку в шаблон страницы, эта метка будет автоматически добавляться к каждой странице, создаваемой на основе данного шаблона.
Сохраняйте порядок в контенте
Отводите время на просмотр контента в своем разделе, удаляйте или архивируйте устаревший контент и перемещайте страницы для поддержания нужной структуры. Если вы являетесь администратором сайта, установите для участников своей команды ритуалы обслуживания разделов и порекомендуйте администраторам разделов выделять время на просмотр и обновление разделов, привлекая к этому соответствующих пользователей.
- Привлеките специалистов, которые помогут вам работать с вкладками в разделе.
- Проведите аудит контента и просмотрите аналитику.
- Выявите устаревшие и неактуальные страницы и составьте план действий.
- Проанализируйте информационную архитектуру и приведите ее в соответствие с текущими потребностями.
Шаг 5. Управление пользователями и правами доступа
Администратор Confluence или администратор сайта с платной подпиской на Confluence может управлять пользователями, группами и правами доступа вручную или же включить публичную регистрацию и разрешить пользователям создавать собственные аккаунты. Подробнее о правах доступа для бесплатного плана см. в нашей документации.
Управление глобальными правами
Профессиональный совет
Для управления глобальными правами вы должны иметь права администратора Confluence.
Глобальные права доступа действуют в пределах всего сайта и позволяют контролировать:
- назначать пользователей, которые могут создавать разделы или личные разделы;
- назначать пользователей, которые будут иметь право доступа к профилям пользователей.
- разрешать или запрещать доступ к сайту нелицензированным пользователям;
- доступ к сайту для приложений.
Допустимое число пользователей
Чтобы изменить глобальные права доступа для лицензированных пользователей, выполните следующие действия.
- Нажмите значок шестеренки на верхней панели навигации, чтобы перейти к настройкам сайта.
- В настройках sidenav перейдите в раздел Global Permissions (Глобальные разрешения) (меню безопасности).
- Убедитесь, что вы находитесь на вкладке User groups (Группы пользователей) или Guest access (Гостевой доступ), если хотите управлять доступом для гостей, а затем нажмите кнопку редактирования.
- Установите или снимите флажок, чтобы предоставить или отозвать право.
- По завершении нажмите кнопку Save (Сохранить).
Изменения глобальных прав доступа вступят в силу только после того, как вы нажмете кнопку сохранения.
В режиме редактирования можно также искать и фильтровать группы пользователей.
Нелицензированные пользователи
Нелицензированными пользователями Confluence можно управлять двумя способами.
Нелицензированный доступ к Jira Service Management
- На вкладке доступа к JSM можно разрешить лицензированным агентам Jira Service Management (JSM) просматривать содержимое вашего сайта Confluence, даже если у этих агентов нет лицензии Confluence. Подробнее
Анонимный доступ
- На вкладке Anonymous access (Анонимный доступ) можно разрешить администраторам разделов сделать свои разделы доступными для всех нелицензированных пользователей (так называемых «анонимных пользователей» или «всех пользователей Интернета»). Подробнее
Управление правами доступа к разделу
Профессиональный совет
Чтобы редактировать права доступа, вы должны быть администратором раздела. Если вы являетесь администратором Confluence, то можете восстановить административные права доступа для любого раздела сайта. Подробнее см. в разделе Что такое права доступа к разделу.
- назначать пользователей, которые могут просматривать контент раздела;
- назначать пользователей, которые могут комментировать этот контент;
- назначать пользователей, которые могут создавать, редактировать и загружать контент.
Инструмент Confluence по умолчанию является открытым. Это означает, что если вы не ограничите права доступа к разделам, доступ к контенту любого раздела получат все пользователи сайта Confluence. Администраторы разделов могут настроить права доступа при создании нового раздела или скорректировать их позднее. Любой, кто имеет право редактировать страницу, может ограничить и права доступа к ней.
Для получения прав доступа к разделу выполните следующие действия.
- Перейдите в раздел.
- Выберите на боковой панели Confluence пункт Space settings (Настройки раздела).
- В настройках раздела выберите вкладку Permissions (Права).
* Вкладка Permissions (Права) отображается только для администраторов данного раздела.
Можно управлять правами доступа к разделам отдельных пользователей или целых групп. Если ваш сайт является публичным, можно также предоставлять анонимный доступ к отдельным разделам. Подробнее см. в статье Настройка публичного доступа.
Подробнее о правах доступа к разделам см. в статье Назначение прав доступа к разделам.
Как настроить права доступа к разделу?
Некоторые клиенты Confluence используют одну и ту же схему прав доступа для всех разделов сайта, тогда как другие настраивают права доступа к разделам по-разному, в зависимости от их назначения или сценариев использования.
Целевая аудитория
Права доступа
Поделитесь с клиентами справочной информацией от службы поддержки
- Анонимный доступ разрешен
- Создавать, редактировать и комментировать страницы могут только участники команды поддержки.
Поделитесь со своей организацией политиками, обучающими руководствами и советами по устранению неполадок
- Все пользователи вашего сайта Confluence
- Просмотр разрешен для всех пользователей вашего сайта Confluence
- Создавать, редактировать и комментировать страницы могут только профильные специалисты.
- Анонимный доступ запрещен
Ведите совместную работу над проектом или инициативой с другими сотрудниками
- Участники команды
- Лица, заинтересованные в проекте
- Просмотр разрешен для всех пользователей вашего сайта Confluence
- Заинтересованные лица могут оставлять комментарии
- Создавать и редактировать страницы могут только участники команды
- Анонимный доступ запрещен
Обменивайтесь конфиденциальной информацией (о сотрудниках, заработной плате или правовых вопросах)
- Участники команды
- Доступ имеют только основные участники команды
- Лица, не являющиеся участниками команды, не могут просматривать, редактировать или комментировать страницы
- Анонимный доступ запрещен
Приглашение участников команды на свой сайт
После настройки сайта и всех прав доступа вы можете пригласить участников команды для работы с Confluence Cloud (и другими продуктами Atlassian на сайте).
- Выберите значок настройки (шестеренку) в правом верхнем углу (рядом с аватаром).
- Выберите User management (Управление пользователями) на боковой панели.
- Выберите Invite users (Пригласить пользователей) в правом верхнем углу.
- Введите адреса электронной почты всех участников команды, которых вы хотите пригласить. За один раз можно ввести не более 10 адресов электронной почты.
- Выберите роль приглашенных участников команды. Она определяет уровень прав доступа к сайту в целом.
- Выберите продукты, к которым вы хотите предоставить доступ участникам команды.*
- Выберите группы, к которым вы хотите их отнести.
- Настройте свое приглашение и выберите Invite user (Пригласить пользователя).
* Только для участников команды с ролью Basic.
Как администратор сайта, вы можете в любое время изменить роль, права доступа и группу пользователя. Вы также можете удалить пользователя, отозвав права доступа к сайту, деактивировав или даже удалив его аккаунт (если, к примеру, сотрудник уходит из компании). Подробнее см. в разделе Приглашение и удаление пользователей.
Обзор Confluence
Узнайте, что такое Confluence и подходит ли этот инструмент вашей команде или организации.
Создание контента в Confluence
Узнайте, как создать насыщенный динамический контент в Confluence.
Confluence для публичной базы знаний: меняем дизайн и настраиваем разделение по языкам
У нас есть шесть продуктов, которые используют в России и за рубежом. Это значит, что документация к ним должна быть в одном месте, но разделена по продуктам и языкам.
Раньше мы использовали MediaWiki, но со временем она устарела. От платформы мы ожидали так же хорошую вёрстку статей, гибкий поиск и внутренний редактор текстов. В качестве альтернативы выбрали Confluence.
В процессе стало ясно, что возможностей этой платформы из коробки тоже недостаточно для всех наших задач. Пришлось докупить плагин Scroll Viewport и потратить некоторое время на его настройку.
Вы можете посмотреть, что в итоге получилось, а я расскажу, как меняла дизайн, настраивала разделение по языкам, внутренний поиск и индексацию.
Меняем дизайн
Компания начала переносить документацию с движка MediaWiki на Confluence год назад. Но когда я приступила к проекту, Confluence выглядел стандартно, предыдущий разработчик добавил наш логотип и скрыл ненужные анонимному пользователю элементы. К запуску надо было привести документацию к нашему стилю. Дизайнеры подготовили макеты, а я должна была их сверстать.
Но дело в том, что сам Confluence даёт очень мало гибкости в стилях и скриптах, а возможности из коробки нетривиальны для понимания и использования, да и непривычны веб-разработчику.
Отмечу, что Confluence — это Java-приложение, а вовсе не веб-сайт с привычными бэкендом и фронтендом. В разделе Внешний вид можно добавить таблицу стилей или настроить пользовательский HTML, но этого недостаточно для полноценного редизайна. Поэтому для вёрстки мы купили плагин Scroll Viewport. Тут-то и началось самое интересное.
Плагин Scroll Viewport
Scroll Viewport — это плагин для Confluence, который позволяет создавать темы, используя привычный редактор кода и файловый менеджер. С его помощью можно писать стили, работать с шаблонами страниц, добавлять изображения, настраивать поиск.
Темы создаются для пространств. Пространства в Confluence — это сущности контента, в которых хранится информация по одному проекту. У нас есть пространство для продуктов: ISPmanager, BILLmanager и т. д., а также для главной страницы. У пространства есть ключ, заголовок, ряд настроек и, собственно, тема.
Редактирование темы в Scroll Viewport: разметка, стили и html
Начнём осваивать Scroll Viewport. Когда плагин установлен и включён, надо кликнуть на шестерёнку и далее — Основные настройки — раздел Scroll Viewport — Themes.
Выбираем, копируем или создаём тему и нажимаем Edit. Открывается редактор темы Scroll Viewport.
Обратите внимание, Scroll Viewport рекомендует не создавать тему с нуля, а брать за основу Scroll WebHelp Theme.
Редактор темы Scroll Viewport: слева структура темы, сверху название файла, в основной части сами файлы
Когда тема создана, можно приступить к её настройке. Зададим разметку и структуру страниц, добавим стили и скрипты, а потом перейдём к редактированию HTML-разметки элементов контента.
Разметка: редактируем, добавляем классы и выводим однотипные элементы в цикле
Структура страниц по типу
В корне темы находятся основные шаблоны: page.vm, search.vm, error.vm, а также изображение-обложка темы thumbnail.png.
Шаблон “page.vm” задаёт структуру всех страниц темы. Здесь можно редактировать html и с помощью переменных placeholders задавать, где будет выводиться контент. Плейсхолдеры обращаются к контенту пространства или данным пользователя (заголовок материала, название пространства, имя автора), с их полным списком можно ознакомиться в хелп-центре разработчика Scroll Viewport.
“page.vm” обращается к шаблонам, которые лежат на уровень ниже, в папке “include”, и оборачивает их в теги и блоки. В этом файле (page.vm) мы собираем страницу по кусочкам, и дополняем разметку всеми необходимыми атрибутами html-документа. Именно здесь мы указываем doctype, прописываем head и body.
Составные элементы страницы
В папке “include” лежат кусочки страницы. По названиям файлов можно догадаться, какой за что отвечает:
- include-htmlhead.vm содержит всё то, что мы обычно указываем в head html-документа: обращения к таблицам стилей, файлам шрифтов, некоторым скриптам, включая стандартные скрипты Confluence и Scroll Viewport;
- include-headerbar.vm задаёт структуру хедера;
- include-footer.vm задаёт структуру футера;
- include-content.vm описывает структуру блока основного контента;
- include-sidebar.vm описывает разметку бокового меню, в котором обычно располагается список всех статей пространства.
Стилизация: добавляем стили, изображения и скрипты
Внутри папки “assets” хранятся файлы js и css. Так как мы не создавали тему с нуля, там уже содержатся файлы от разработчиков Scroll Viewport.
Чтобы кастомизировать стили, лучше создать новый css-файл и подключить его в head шаблона страницы. Файлы, которые начинаются на theme, содержат в себе правила базовой темы Scroll Viewport. Их стоит редактировать в случае, когда новые стили упираются в базовые. Будьте внимательны, удаляя и добавляя правила, помните об иерархии селекторов, она может выручить.
В “assets” я также добавила папку с изображениями и папку с файлами шрифтов. Файловый менеджер работает не идеально, добавить папку в нужную директорию нельзя, поэтому пришлось схитрить. Я создала папку на своём компьютере, добавила в неё файл, а потом загрузила в нужную директорию драг-энд-дропом. Как только папка создана, с загрузкой файлов проблем нет.
При создании нового дизайна мы учитывали возможности плагина и ориентировались на уже существующие темы в Scroll Viewport, поэтому внутри assets/js я задержалась ненадолго. Внесла небольшие изменения в существующие файлы скриптов и добавила файлы нужных библиотек. Если изменения будут более значительными, со скриптами придётся разобраться детальнее.
Редактор html-разметки контента статьи
В процессе работы со Scroll Viewport выяснилось, что верстать мы можем, да не всё. Полномочия шаблона плагина заканчиваются на переменной $page.renderContent. Как верстать элементы главной с классами и ссылками? Непонятно. Где HTML? По умолчанию его там и нет. Переменная подсказывает, что нам предстоит выполнить часть вёрстки непосредственно на странице статьи, правда, пока там можно редактировать лишь текст, но не теги.
Благо, всегда можно поискать плагины, и, какая удача, нужный нашёлся почти сразу. Это Confluence Source Editor. После его установки можно в режиме редактирования статьи прошерстить и старый добрый гипертекст. Наконец-то!
Плагин Source Editor
В Scroll Viewport верстаем шапку, сайдбар, футер и задаём стили. Контент верстаем с помощью Source Editor. Всего я создала две темы: для страниц статей и для главной страницы документации.
Настройки Viewport пространства: применяем тему
Когда тема создана, её надо связать с пространством. Для этого в настройках пространства нужно создать Viewport. Viewport — это то, что связывает пространство и тему. Только создав эту сущность, можно применить стили темы для пространства.
Войдите в пространство нужного продукта, откройте Настройки пространства — Дополнения. Здесь можно создать Viewport и управлять им: задавать темы, типы контента, разрешения, домен и путь.
Форма для связи пространства с темой, создания Viewport
Выбрать тему
На вкладке Themes представлены все созданные темы и одна тема по умолчанию, которая появляется вместе с плагином Scroll Viewport. Выберите тему и примените к пространству.
Вкладка Content позволяет выбрать тип контента, к которому будет применяться тема. Она нам наименее интересна, так как ключ пространства подтягивается автоматически.
Настроить адреса
На вкладке URL можно выбрать домен и путь, по которому будет открываться пространство, а также задать структуру адресов. Она так же понадобится, чтобы разделить документацию на два домена по языкам.
Есть два типа структуры URL:
- многоуровневая — путь отражает иерархию статей пространства и названия страниц,
- одноуровневая — все статьи доступны по адресам одинакового уровня с числовыми суффиксами
Но нужно учесть, что при выборе многоуровневых адресов URL будет зависим от названия статьи. Изменится название — изменится и адрес статьи. Если выбрать одноуровневую структуру, адрес будет менее читаем и понятен, но перестанет зависеть от заголовка страницы.
Мы выбрали многоуровневый тип структуры и читаемые адреса, но нам придётся следить за изменением названий статей и вовремя настраивать редиректы. И идеальный вариант мы всё ещё ищем. Мы также используем краткие ссылки, которые всегда ведут на статью и не меняются, такую ссылку можно найти в разделе Информация о странице.
Включить тему
Во вкладке Permissions можно обозначить, каким пользователям будет доступен просмотр пространства с применением Viewport.
Чтобы анонимные пользователи видели документацию только в заданном дизайне, нужно поставить две галочки:
- Restrict access to Confluence UI,
- Automatically redirect users to viewport.
Настройки вида пространства во вкладке Permissions
Настраиваем разделение по языкам
У нас документация на английском и русском, поэтому нужно, чтобы пространства на русском открывались на домене .ru, а на английском — на .com.
В Scroll Viewport такие настройки предусмотрены, но если просто ввести отличный от основного домен во вкладке URL в поле Domain Name, два домена не заработают. Это особенность плагина Scroll Viewport.
Надо настроить Reverse proxy, чтобы запросы пользователей передавались Confluence и там разруливались на два домена — см. инструкцию Scroll Viewport (конфигурации для Nginx и TOMCAT). После этого надо выключить режим совместного редактирования или внести дополнительные изменения. Теперь можно указывать один из двух доменов в настройках Viewport.
Темы для разных языков
Применить одну тему к пространствам на разном языке не получится, потому что тема включает в себя не только стили, но и шаблоны страниц. Это означает, что язык элементов, которые выводятся не переменными, не меняется. Например, текст-плейсхолдер в строке поиска, контакты в футере и др. Так что пришлось делать отдельные темы для пространств на русском и английском языках.
Фактически я создаю идентичные по стилям темы, но вот шаблоны для них различны, в основном по части текста. Это излишество и дублирование, да, но иного способа я пока не нашла. К тому же тема регулирует и работу поиска тоже, а это ещё один аргумент в пользу разделения по языкам.
В итоге у меня получилось четыре темы: две для главных страниц на русском и английском, и ещё по две для страниц контента для каждого языка.
Настраиваем поиск по сайту
Параметры поиска настраиваются в файлах из папки “include”. Внутри них мы задаём параметры поиска:
- include-quicksearch.vm отвечает за поле поиска на всех страницах контента,
- include-search.vm задаёт структуру страниц с результатами поиска.
Где искать
По умолчанию поиск работает только по текущему пространству. Например, в пространстве ISPmanager — только по статьям об ISPmanager. Если нужен поиск по списку пространств, в настройках include-quicksearch.vm нужно указать их ключи.
#set($search = "/search") #if ($stringUtils.equals($, "/") == false) #set($search = "$/search") #end Форма поиска для отдельного пространства
#set($search = "/search") #if ($stringUtils.equals($, "/") == false) #set($search = "$/search") #end Форма поиска по списку пространств
Как выводить результаты
Как будет выглядеть список с результатами поиска, задаёт шаблон include-search.vm. В моём случае у каждой найденной ссылки есть заголовок, описание и название пространства, к которому относится статья. Здесь же можно указать, что пользователь увидит, если поиск ничего не найдёт.
Из фрагмента шаблона ниже видно, что результаты поиска выводятся в цикле с использованием переменных-плейсхолдеров. Результатов поиска может быть довольно много, поэтому внизу страницы сделали пагинацию. Подробное руководство по шаблонам страниц поиска можно посмотреть в документации по поиску Scroll Viewport.
#if ($searchResults.total > 0) #foreach($result in $searchResults.items) #set( $space = '' ) #if( $result.type == 'page' ) #set( $space = $result.getObject().fromConfluence.getSpace().getName() ) #end $result.displayTitle
$result.getDescription(280)
#if( $space ) $space
#end #end #else Мы ничего не нашли :(
Проверьте запрос на ошибки, измените его или воспользуйтесь содержанием.
#end #if($pager.hasPrev) Назад #end #foreach ($pagerPage in $pager.pages) $velocityCount #end #if($pager.hasNext) Дальше #end 
