Confluence is a powerful tool that allows you to create, organize, and collaborate on content in a centralized and accessible way. It is a wiki-based platform that provides a space for teams to work together, share information, and document their work. With Confluence, you can easily create and maintain pages, documents, and files, making it a versatile tool for a wide range of uses.
When using Confluence, it is important to understand how to navigate and utilize its various features. The main building blocks of Confluence are pages, which are the basic units of content within the platform. Pages can be used to create anything from simple text documents to complex project plans. You can organize pages into different spaces, making it easier to manage and find the content you need.
One of the key features of Confluence is its ability to embed content from other sources. This means that you can include files, images, and even entire webpages within your Confluence pages. For example, you can embed a Git repository or a Jira issue tracker into a Confluence page, allowing you to view and interact with these tools directly within Confluence.
Another useful feature of Confluence is the ability to create excerpts. An excerpt is a highlighted section of content that can be reused in different places within the same Confluence space. This is particularly helpful when you have a piece of information that you want to include in multiple pages, such as a disclaimer or a frequently asked question. By creating an excerpt, you can ensure that the information is consistent across all of your pages without having to manually update each one.
In addition to pages and excerpts, Confluence also allows you to create and manage menus. A menu is a collection of individual pages that are grouped together for easier navigation. By creating a menu, you can provide a clear and organized structure for your content, making it easier for users to find what they need.
So, why should you use Confluence? The answer is simple – it provides a centralized and collaborative platform for creating, organizing, and sharing content. Whether you are a writer, a project manager, a developer, or just someone who needs a place to store and share information, Confluence can help you do it more effectively. It offers a wide range of tools and features that can be tailored to suit your needs, giving you the flexibility to create and manage content in the way that works best for you.
In conclusion, Confluence is a powerful tool for creating, organizing, and sharing content. Whether you are writing a document, managing a project, or simply need a place to store and access information, Confluence can provide the solution you need. With its versatile features and user-friendly interface, Confluence is a valuable tool that can help you and your team work more efficiently and effectively.
Wikis
A wiki is a collaborative space for writing and organizing content. It allows individuals to create and edit pages in a shared location.
Wikis are different from other content management systems because they provide a simplified and easy-to-use interface. They are often used to store knowledge, document processes, and create user manuals.
In Confluence, you can create a wiki by simply creating a new page and organizing it into a space. You can also use wikis to collaborate on documents, share ideas, and track changes.
One of the main features of wikis is the ability to include content from different sources. You can embed files, images, and even excerpts from other pages. This makes it easier to reference and reuse content across different pages.
When working with wikis, it’s important to have a clear structure in place. You should define a menu structure and categorize your pages to make them easier to navigate. By using menus and organizing your content, you can ensure that users can quickly find the information they need.
Another advantage of using wikis is that you can track changes and revisions. Confluence uses a version control system similar to Git, which allows you to roll back changes, compare versions, and see who made modifications. This is especially useful when multiple people are collaborating on a wiki.
Overall, wikis are a powerful tool in Confluence that can help organize and share information. They provide a central place for teams to collaborate and document their knowledge. Whether you are creating a simple user manual or a complex knowledge base, wikis are a versatile and efficient way to manage and share content.
Embed Git files
If you are using Confluence for your wikis and pages, you may want to include Git files in your content. Git files can be embedded in Confluence in different ways, depending on how you want to use them.
Using excerpts:
One way to include Git files in Confluence is to use excerpts. Excerpts are short sections of content that can be used to highlight important information. You can create a page or an individual wiki and place excerpts in them. When you embed a Git file using an excerpt, it will be displayed along with the other content on that page or wiki.
Using the include menu:
Another way to embed Git files in Confluence is to use the include menu. The include menu allows you to select a Git file and insert it into your Confluence page or wiki. This is a great option if you want to include multiple Git files in one place.
Why use Git files in Confluence:
There are several reasons why you might want to embed Git files in Confluence. First, it allows you to keep all your project documentation in one place. Instead of having to navigate between different sources, you can have everything in your Confluence instance. Second, it makes it easier for others to access and reference the files. Instead of having to go to a separate source control system, they can find the files directly in Confluence. Third, it allows you to provide context around the files. You can include additional information about the files and why they are relevant to your project.
What not to do:
When embedding Git files in Confluence, there are a few things you should not do. First, do not embed the entire Git file into Confluence. This can make your page or wiki slow to load and difficult to navigate. Instead, use excerpts or the include menu to embed only the relevant parts of the file. Second, do not embed files that are too large. Large files can also slow down your Confluence instance. Instead, only embed files that are necessary for your project.
In conclusion, embedding Git files in Confluence is a powerful way to consolidate your project documentation and provide context around your files. By using excerpts or the include menu, you can easily embed individual Git files or multiple files in one place. Just make sure to use this feature wisely and avoid embedding large or unnecessary files.
How to use Confluence Excerpt Include and Why You Should Do It
Confluence is a powerful tool for collaboration and documentation, and one of its key features is the ability to create and manage content using wikis. But what if you want to include excerpts of content from different sources in one place? This is where Confluence Excerpt Include comes in.
When writing content in Confluence, you can use the Excerpt Include macro to embed excerpts from other Confluence pages or even from external sources like git repositories or files. This can be especially useful when you don’t want to duplicate content or when you want to create a repository of individual excerpts that can be reused across different pages and spaces.
Using the Excerpt Include macro is simple. First, you need to create an excerpt on the page where the original content is located. This can be done by selecting the text you want to include, clicking the “Insert” menu, and choosing “Excerpt.” Give the excerpt a meaningful name, and it will be saved in the page’s attachments.
Now, on the page where you want to include the excerpt, edit the page and place the cursor where you want the excerpt to appear. Then, click the “Insert” menu, choose “Other Macros,” and search for “Excerpt Include.” Select the macro, and in the configuration panel, specify the name of the excerpt you want to include.
That’s it! The selected excerpt will now be embedded in the page, and any changes you make to the original content will be automatically reflected in all the places where you’ve included it. This can save you a lot of time and effort when managing large documentation projects or when you have a lot of content that needs to be reused in different places.
So why should you use Confluence Excerpt Include? Here are some reasons:
- Reuse content: Instead of copying and pasting the same content in multiple locations, you can create excerpts and include them wherever needed.
- Centralized management: When the original content changes, all included excerpts will automatically update, ensuring consistency and making it easier to maintain.
- Easier navigation: By including excerpts from different sources, you can create a menu-like structure that allows users to quickly access the information they need.
- Git integration: If you’re using a git repository to store your Confluence content, you can include excerpts from git files directly in your Confluence pages.
So, the next time you find yourself in a situation where you need to include content from different sources in your Confluence pages, don’t just copy and paste – use the Excerpt Include macro! It will save you time, ensure consistency, and make your documentation more organized and easier to navigate.
Источники
When you use Confluence, you will have access to a variety of different sources that you can use to include in your wiki pages. These sources include:
- Confluence pages: You can use the content from other Confluence pages as sources for your wiki content. Just select the page you want to include and Confluence will automatically embed it for you.
- Git repositories: If you use Git for version control, you can link your repositories directly to Confluence. This will allow you to embed code snippets and files from your Git repositories into your wiki pages.
- Excerpts: With Confluence, you can easily create excerpts from your wiki pages. Excerpts are individual pieces of content that you can reuse in different places. This can save you time when you need to include the same content in multiple pages.
When you are writing your wiki content, you should consider where and how you use these sources. For example, if you want to include content from a Confluence page in your wiki, you can do so by using the “Excerpt Include” macro. On the other hand, if you want to embed code from your Git repository, you can use the “Files” menu to select the file you want to include.
Just keep in mind that when you use these sources, they should be used appropriately and in line with your overall wiki content. Don’t just include them for the sake of including them – think about why and how they will enhance the information you are presenting.
