BookStack Code Mirror - website/blob - content/blog/2023/project-update-march-23.md

1 +++

2 categories = ["News"]

3 tags = ["News"]

4 title = "BookStack Project Update for March 2023"

5 image = "/images/blog-cover-images/pexels/flowers-tim-gouw.jpg"

6 author = "Dan Brown"

7 slug = "project-update-march-23"

8 draft = false

9 date = 2023-03-31T07:20:00Z

10 +++

11

12 There's no new feature release for BookStack this month, due to various distractions

13 and the type of work done in this release cycle, so I thought it'd be good to instead provide

14 a general project update to highlight what has happened in the last month or so.

15

16 {{<toc>}}

17

18 ### Patch Release

19

20 Within the last week I published [BookStack v23.02.2](https://github.com/BookStackApp/BookStack/releases/tag/v23.02.2).

21 Since we're still a little far from a feature release, I thought it'd be worthwhile to package up a patch release

22 just to address a couple of user-management bugs and to merge in the latest translations.

23

24 ### New Hacks

25

26 A bunch of new hacks have been added to the site.

27 If you're unfamiliar with this part of the site you can find out more [in my blogpost here](/blog/hacks-on-the-site/).

28 The newly added hacks are as follows:

29

30 - [Render TeX/LaTeX Mathematics with MathJax](/hacks/mathjax-tex/) - *Provided by @codemicro.*

31 - [IFrame Specific Tweaks](/hacks/iframe-specific-tweaks/) - *Provided by @vincent.*

32 - [Custom WYSIWYG Editor Buttons](/hacks/wysiwyg-custom-buttons/)

33 - [Page Export Contents List](/hacks/page-export-contents/)

34

35 ### New API Script

36

37 While assisting a user on Discord, with using PowerShell to call the BookStack API, I ended up

38 creating a new REST API example script in the repo:

39

40 [PowerShell - Create BookStack Pages from HTML Files](https://codeberg.org/bookstack/api-scripts/src/branch/main/powershell-files-to-pages)

41

42 I don't really know PowerShell, and I've never gotten on with Microsoft's documentation, but this was my first case

43 of finding ChatGPT very useful to at least provide tailored examples to work from until I got something working.

44

45 ### Noted Interview

46

47 This month I did something a bit different & outside my comfort zone, by being interviewed

48 by Jeremy at Noted about BookStack.

49

50 [You can find the full interview here](https://noted.lol/dev-debrief-bookstack/).

51

52 The interview delves into the origin of the BookStack while also touching on the challenges

53 experienced maintaining the platform over the last 7 or so years.

54

55 ### Development & CodeMirror 6

56

57 For the next release, so far my focus has primarily been on filling in gaps within the API as planned,

58 with code now in the main branch to add image and content-permissions API endpoints.

59

60 I've also continued to chip away at updating [CodeMirror](https://codemirror.net/) from CodeMirror 5 to CodeMirror 6.

61 CodeMirror is used for a lot of views within BookStack including code-blocks within content and the markdown editor input.

62 The jump in version is quite a significant change, and something [I started back in August](https://github.com/BookStackApp/BookStack/pull/3617)

63 but came across blockers with. During this month, I've looked to address the lack of default support in CodeMirror 6 for a couple of

64 languages we currently support. I've published my resultant work as external stand-alone open source NPM packages

65 in the event they're useful to other projects that require the same:

66

67 - [@ssddanbrown/codemirror-lang-smarty](https://www.npmjs.com/package/@ssddanbrown/codemirror-lang-smarty)

68 - [@ssddanbrown/codemirror-lang-twig](https://www.npmjs.com/package/@ssddanbrown/codemirror-lang-twig)

69

70 ### First Repeat Support Subscriber

71

72 It's now been a full year since I set-up & [launched the BookStack support services](/blog/bookstack-support-services/).

73 Since these are annual-subscription-based we're now coming across the first renewals,

74 and I'm pleased to say we've seen our first successful renewal! This may seem minor but it's

75 quite significant to me in the interest of these support services "building up momentum"

76 across years to help cover my living costs to become sustainable.

77

78 If you're interested in how these have helped finances so far, I provided

79 a fair bit of information within the ["BookStack in 2022" post](/blog/bookstack-in-2022/#project-funding--support-services).

80

81 ### Video: Installing BookStack on OpenBSD Assisted by ChatGPT

82

83 I've been wanting to expand my knowledge in the world of BSD operating systems

84 so, as a fun introduction, I decided I'd try to install BookStack on OpenBSD and

85 record the process. In addition, I thought it'd be fun to only have ChatGPT as my

86 external reference during the process:

87

88 {{<yt Qs2c20DpgbI>}}

89

90 Although this ended up with having almost 2 hours of video to edit down, I quite

91 enjoyed the process of discovery in addition to further learning the benefits and

92 weaknesses in using a tool like ChatGPT, especially in more niche subject areas.

93

94 ---

95

96 <span style="font-size: 0.8em;opacity:0.8;">Header Image Credits: <span>Photo by <a href="https://www.pexels.com/@punttim/">Tim Gouw</a></span></span>