Fixed image links in blog posts
This commit is contained in:
parent 1e0928490e
commit adc44afb25
GPG key ID: 46D9F943C24A2EF9
9 changed files with 40 additions and 40 deletions
| | @ -21,46 +21,46 @@ To celebrate how BookStack has grown over the last year I thought we'd take a qu | |||
| ||||
The first commit was super simple. It was all and only about books. No users, chapters or pages. The project was also named 'Oxbow' at that time. | ||||
| ||||
 | ||||
 | ||||
| ||||
###### First Proper Design - 15 Jul 2015 | ||||
| ||||
A few days after the initial commit the design was cleaned up into something non-prototypey. The design was based on an abstract idea of a piece of paper on a desk, Inspired by DokuWiki's simple and clean stock design. Personally I still really like this kind of design but the project needed to find its own identity. | ||||
| ||||
| ||||
 | ||||
 | ||||
| ||||
 | ||||
 | ||||
| ||||
| ||||
###### BookStack with a Sidebar - 23 Jul 2015 | ||||
| ||||
Later in the month the project officially changed from Oxbow to BookStack. The main menu and navigation were put into a sidebar to make good use of vertical space (Later removed as it ended up empty most of the time). I like the contrast of the dark sidebar in this design as it gives a good separation of content and UI trim. Something to note is that there were still not chapters at this stage but pages could be infinitely nested within each other. | ||||
| ||||
 | ||||
 | ||||
| ||||
 | ||||
 | ||||
| ||||
| ||||
###### Feature Dump and Polish - Aug 2015 | ||||
| ||||
Up to the end of August a lot of features were added and some removed. Now there were users, notifications, A WYSIWYG editor, page revisions & chapters. Nested pages were removed due to difficulty in discoverability. It was found that pages would become hidden, nested in a complex web of nesting so they were removed to keep things simple and to force a level of thought regarding structure. The design also got a bump up which included a fancy background image (courtesy of [unsplash.com](https://unsplash.com/)) on the login screen which stayed behind the sidebar throughout. This is where BookStack really aligned to what it is today. | ||||
| ||||
 | ||||
 | ||||
| ||||
 | ||||
 | ||||
| ||||
###### BookStack as we Know it - October 2015 | ||||
| ||||
By October, After another redesign, BookStack had become almost the same as it looks like now. It now had a logo, after a lot of playing about in inkscape, and the sidebar had been changed back into a header bar to maximise the utility of screen space. Since this change BookStack has had loads of major under-the-hood changes and a whole bucket load of features added but this core design has remained. | ||||
| ||||
 | ||||
 | ||||
| ||||
## Project Traffic | ||||
| ||||
Traffic to the website has steadily grown since the [100 stars](https://www.bookstackapp.com/blog/100-stars-on-github/) post but is overall still very low. No large spikes of traffic like before but, thanks to the new docs and referrals from [alternative.to](http://alternativeto.net/software/bookstack/), daily traffic has crept up: | ||||
| ||||
 | ||||
 | ||||
| ||||
## Moving Forwards | ||||
| ||||
| | | |||
| | @ -14,7 +14,7 @@ BookStack now has [over 100 stars on GitHub](https://github.com/ssddanbrown/Book | |||
| ||||
Most of those stars have come from my [initial posting on the Reddit](https://www.reddit.com/r/selfhosted/comments/3z06rb/bookstack_a_free_wikilike_information_store/) and a tweet about the project. These events can be seen in the site analytics: | ||||
| ||||
 | ||||
 | ||||
| ||||
The initial small spike is my Reddit post and the large middle spike is the twitter post: | ||||
| ||||
| | | |||
| | @ -30,7 +30,7 @@ A major benefit that this brings is `view` permissions on a role since this was | |||
Upon update all current roles in the system will be given view permissions automatically to match the permissions pre-update. To change these just edit the role and you will find a new column to edit `view` permissions shown in the screenshot below: | ||||
| ||||
| ||||
 | ||||
 | ||||
| ||||
#### Page Tagging | ||||
| ||||
| | @ -38,13 +38,13 @@ Tags have been a heavily requested feature for a while now but we wanted to ensu | |||
| ||||
To add tags simply go and edit a page. You will find a new sidebar on the right-hand side of the screen. This will show up on both WYSIWYG & Markdown editor options. Click the arrow or tag icon at the top of this sidebar to expand it. You can then enter your tags, as well as re-order them. To save them just save the page. Here's a screenshot of the tag edit interface: | ||||
| ||||
 | ||||
 | ||||
| ||||
Once you really get into using tags on your pages BookStack will provide auto-fill suggestions when typing tag names and values. | ||||
| ||||
Page tags are visible when viewing a page as shown here: | ||||
| ||||
 | ||||
 | ||||
| ||||
Clicking the tag name will start a search of everything with that tag name. Clicking the value will search the system for only pages that have that tag with that particular value. Tagging has been fully built into the search system in this format: `[tagname=tagvalue]`. You will see this when clicking on a tag name or value then looking at the search term used. Here are some example tag search terms with descriptions: | ||||
| ||||
| | | |||
| | @ -20,7 +20,7 @@ BookStack v0.11 has now been released. This version is a cleanup and bugfix rele | |||
| ||||
The WYSIWYG editor now supports callouts. These are styled blocks that can be used to highlight or alert specific bits of information. These are ideal for catching the attention of the user for snippets of text that are important. Here's a preview of how these look: | ||||
| ||||
 | ||||
 | ||||
| ||||
As you can see there are a few different types. There are success, info, danger & warning options. Callouts are created in the same way as headers and code blocks, Simply open the 'Formats' list on the editor toolbar and at the bottom is a new 'Callouts' menu. Open that and you will see the four options available. | ||||
| ||||
| | @ -41,7 +41,7 @@ A small update has been made to the markdown editor to enable scroll-syncing. No | |||
| ||||
Pages and Chapters have now been given a proper move interface so it's easier to change the location of a single item. Before, the only way to change the location of a page or chapter was to go to the book and go through the sort interface but that could be a bit tedious to move a single chapter or page. Now, in the toolbar dropdown menu when viewing a chapter or page, you can find a 'Move' action (As long as you have edit permissions). This will show a page where you can select a new book/chapter to move the current item to. Here's what it looks like when moving a page: | ||||
| ||||
 | ||||
 | ||||
| ||||
By default popular books and chapters are shown otherwise you can search for a particular item. Moving a chapter will also move all pages within that chapter. | ||||
| ||||
| | | |||
| | @ -20,11 +20,11 @@ BookStack v0.12.0 has now been released bringing a range of new features and bug | |||
| ||||
When editing a page you can now add a one-liner to summarise the changes you've made. This allows you to build a changelog of a page to assist with looking over revisions. The option to set a changelog summary can be found next to the save button when editing a page: | ||||
| ||||
 | ||||
 | ||||
| ||||
These summaries can then be seen on the revisions view for a page providing a full changelog that can be used to assist finding the right revision. | ||||
| ||||
 | ||||
 | ||||
| ||||
Adding a changelog is optional so if you don't want the hassle of setting a summary on every edit you don't have to but you won't get the benefits it brings. | ||||
| ||||
| | @ -32,17 +32,17 @@ Adding a changelog is optional so if you don't want the hassle of setting a summ | |||
| ||||
If you ever find yourself wanting to link to another Book, Chapter or Page and then have to open a new tab to find the URL for that page you will love this new link selector. Found on both editors, WYSIWYG & Markdown, the link selector displays in a popup and allows you to search for your Book, Chapter or Page without opening a new tab or window. The link selector can be found at the top of the markdown editor (or by pressing `Ctrl+Shift+K`). On the WYSIWYG editor you can access the link selector by clicking the browse icon in the insert/edit link menu: | ||||
| ||||
 | ||||
 | ||||
| ||||
Clicking the button will display a searchable listing of Books, Chapters & Pages. Find your item in this dialog then double click it or select it then press the 'Select' button. The URL and title of the link will be populated with the url and name of the entity you selected. | ||||
| ||||
 | ||||
 | ||||
| ||||
### Page Save Indicator | ||||
| ||||
Just want to note another little nice UI change, When a page draft is saved an indicator will now display to provide feedback of a successful save. Before, When saving within the same minute no feedback was given. This just adds a little bit of assurance your content has saved without displaying a large, distracting notification. | ||||
| ||||
 | ||||
 | ||||
| ||||
### Other Features, Changes & Bugfixes | ||||
| ||||
| | | |||
| | @ -26,11 +26,11 @@ The main new feature this release is page attachments. This allows a user to att | |||
| ||||
To create & edit attachments simply edit a page and attachments can be found in the sidebar along with tags. Note that edits to attachments are saved instantly. Once created, Attachments can be re-ordered via drag and drop. | ||||
| ||||
 | ||||
 | ||||
| ||||
Attachments will be shown in the sidebar when viewing a page. Different icons dictate the type of attachment, link or file. | ||||
| ||||
 | ||||
 | ||||
| ||||
The permissions for accessing attachments are controlled by whether the user has access to view the page. Create, edit and delete permissions have been added to the role settings. Upon update, Admins are automatically given these permissions but other roles must be given these permissions manually. | ||||
| ||||
| | @ -39,7 +39,7 @@ The permissions for accessing attachments are controlled by whether the user has | |||
When viewing the revisions of a page there is now a new action named 'Changes'. Clicking this will present a diff view displaying the changes in the revision, compared to the revision before. While you could preview old content before this new feature makes it much easier to see exactly what has changed. Here's what a diff looks like: | ||||
| ||||
| ||||
 | ||||
 | ||||
| ||||
| ||||
### Public Role & Guest User | ||||
| | @ -56,11 +56,11 @@ This new role also allows you to control guest permissions at an asset level as | |||
| ||||
Page navigation has been added to the sidebar to allow users to jump between headings on a page. The navigation will show up as long as the page contains more than one header and the navigation options are indented depending on the header used to provide a visual hierarchy. | ||||
| ||||
 | ||||
 | ||||
| ||||
To fit in with new navigation available, page headers have been tweaked in the WYSIWYG editor to provide a greater range of options: | ||||
| ||||
 | ||||
 | ||||
| ||||
As you can see from the above, There's now an additional size option and the names have been made much more descriptive. The tweaks in size also enable to page content to flow a little better. Note that these changes will have an effect on any existing pages although hopefully the change will be for the better and the chances of additional bugs is minimal. | ||||
| ||||
| | @ -68,7 +68,7 @@ As you can see from the above, There's now an additional size option and the nam | |||
| ||||
The URL system has been modified to allow a much wider range of characters in the URL. This means that when you create content with non-ASCII characters such as Japanese or Chinese these characters will also be used in the URL. URL's won't change automatically upon update but will change if you amend the name of your page, chapter or book. | ||||
| ||||
 | ||||
 | ||||
| ||||
### Other Features, Changes & Bugfixes | ||||
| ||||
| | | |||
| | @ -23,7 +23,7 @@ With that out of the way here are the new features in this update: | |||
| ||||
Previously in BookStack there have been three main roles. Admin, Editor and Viewer. This system has now been opened up so you can define as many custom roles as you want. To go with this you can now assign multiple roles to each user. Current Admins will be able to edit these roles from the 'Roles' tab in the settings menu. Here's a screenshot of the role configuration screen: | ||||
| ||||
 | ||||
 | ||||
| ||||
As you can see you can now really customise a role and change system and asset permission. New permissions have been added to restrict users to only be able to edit/create/delete their own content. | ||||
| ||||
| | @ -31,7 +31,7 @@ As you can see you can now really customise a role and change system and asset p | |||
| ||||
Within BookStack you are now able to restrict actions on individual books, chapters & pages. This ties in with the new roles system so that restrictions are done per role. These restrictions cascade down so restrictions set on books and chapters will affect child pages and/or chapters within then unless they have restrictions set which will override their parents. Restrictions can be found on the header tool bar when viewing a Book, Chapter or Page as long as you have permission to edit restrictions. Any restrictions set will be shown in the top-right when viewing a Book/Chapter/Page. Here's a screenshot showing this as well as the new overflow menu that's on Books to keep the toolbar tidy. | ||||
| ||||
 | ||||
 | ||||
| ||||
Restrictions are ignored and cannot be editing for admin users. | ||||
| ||||
| | @ -39,7 +39,7 @@ Restrictions are ignored and cannot be editing for admin users. | |||
| ||||
Within the settings you can now define a custom primary color for the application. This will affect all major component that are currently blue such as the header, buttons and links. Here's an example of a red themed BookStack: | ||||
| ||||
 | ||||
 | ||||
| ||||
### Better Search | ||||
| ||||
| | | |||
| | @ -34,17 +34,17 @@ As with the entity restrictions the effect will cascade down. If a whole book is | |||
| ||||
Below is a screenshot of the views of two different users. The one on the right cannot see the majority of the images since the book that contains the pages that contains the images is restricted | ||||
| ||||
 | ||||
 | ||||
| ||||
### Autosaving Drafts | ||||
| ||||
In the era of the modern internet we now expect things to be done automatically. One of these things is saving stuff. Accidents are easy and web-server sessions are not *usually* unlimited so every so often you can end up losing a whole load of work and that can really suck and make you not want to write stuff out. To prevent this from happening BookStack will now automatically save pages periodically (30 seconds to be exact) if changes have been made. | ||||
| ||||
 | ||||
 | ||||
| ||||
A little indicator at the top of the editing screen will let you know when the draft was last saved. You can click this to manually save the draft if you don't want to wait for it to be done automatically. On the right, Next to the save button you'll find an button which will discard the draft which will update the editor with the current, live, contents of the page. When you save the draft copy will be made into the published version. Only the creator can see their drafts. Every user can have their own draft copy of a page. | ||||
| ||||
 | ||||
 | ||||
| ||||
When editing a page that you have a previous draft of you will get the notification shown in the screenshot above to let you know you're editing a draft copy, not the current live page content. If the page has been saved since you created your draft the system will let you know in the same notification. | ||||
| ||||
| | @ -52,7 +52,7 @@ When editing a page that you have a previous draft of you will get the notificat | |||
| ||||
Along with saving drafts when updating a page, Drafts will now be created straight away when creating a new page. This give you the ability to work on a page, Saving it as you go, without being redirected or having the make the page visible to everyone. | ||||
| ||||
 | ||||
 | ||||
| ||||
As with updating a page, new page drafts will save every 30 seconds or you can save it manually. You can also delete the draft page from the system entirely. | ||||
| ||||
| | @ -60,23 +60,23 @@ Draft pages will show up in the system in a similar way to normal pages except t | |||
| ||||
Here are some screenshot of the new drafts in various places in BookStack: | ||||
| ||||
 | ||||
 | ||||
| ||||
 | ||||
 | ||||
| ||||
 | ||||
 | ||||
| ||||
### Multiple User Edit Warnings | ||||
| ||||
With the new autosaving functionality in BookStack we can use that to check if users have been editing a page within the most recent x minutes. Now when you edit a page the system will look over to see if there have been any autosaves within the last hour. If there have it will notify you as the editor opens. If there's just one other user it'll let you know who they are otherwise, If there's more than one, it'll let you know how many users have been editing the page. | ||||
| ||||
 | ||||
 | ||||
| ||||
### Better Default Logo | ||||
| ||||
The last update added the ability to set a custom primary colour theme for BookStack. In this update the logo has been updated to remove the blue outline so it fits better with the custom colours. | ||||
| ||||
 | ||||
 | ||||
| ||||
### Bugfixes and Other Changes | ||||
| ||||
| | | |||
| | @ -18,7 +18,7 @@ If you have not yet read through the changes of v0.8.2 I'd recommend doing so as | |||
| ||||
A much requested addition to BookStack was a markdown editor. An initial implementation has now been added which includes a live preview of your content. Here's what it looks like: | ||||
| ||||
 | ||||
 | ||||
| ||||
A drop down menu has been added in the settings to select what editor to use. This is an application-wide setting so will effect all users. This was done to keep formatting compatibility between all users in the system. After switching to the markdown editor, any pages that were created before will simply show as HTML plaintext content in the editor. | ||||
| ||||
| | @ -26,7 +26,7 @@ The editor uses GitHub flavoured markdown and the image manager from the WYSIWYG | |||
| ||||
### Image Manager Filters & Search | ||||
| ||||
 | ||||
 | ||||
| ||||
More work has been done on the image manager since the last release. To make it easier to find images you can now search by the image name. As well as search, when using the image manager on a page, you can now get a view of the images uploaded to the current Book & Page. | ||||
| ||||
| | | |||
Loading…
Add table
Add a link
Reference in a new issue