Vivliostyle Foundation FY2021 Activity Report

Chapter 1: Financial Report for FY2021

(The 4th Fiscal Year: from April 1, 2021 to March 31, 2022)

Foreword

The structure of the annual report for this fiscal year has been changed from previous years, with the first section reporting the financial results in comparison with the past, and the second section reporting the activities based on that report.

Balance Sheet for FY2021

The following table shows the status of assets held (balance sheet) as of the end of this fiscal year (March 31, 2022). The figures are in yen.

Title This FY (2021) Prev. FY (2020) Increase/Decrease
I. Assets
1. Current assets
Cash and deposits 1,180,342 345,708 834,634
Other current assets 1,058,750 1,058,750
Total current assets 2,239,092 345,708 1,893,384
2 Fixed Assets
(1) Other fixed assets
Founding expenses 113,050 113,050 0
Total other fixed assets 113,050 113,050 0
Total fixed assets 113,050 113,050 0
Total assets 2,352,142 458,758 1,893,384
II. Liabilities
1. Current liabilities
Withholdings 31,139 31,139 0
Loan from officer 4,806,561 3,806,561 1,000,000
Accounts payable 11,000 11,000
Accrued income taxes 20,000 20,000
Total current liabilities 4,868,700 3,837,700 1,031,000
Total liabilities 4,868,700 3,837,700 1,031,000
III. Net Assets
1. General Net Assets -2,516,558 -3,378,942 862,384
Total net assets -2,516,558 -3,378,942 862,384
Total liabilities and net assets 2,352,142 458,758 1,893,384

Assets that can be recovered within one year are called current assets. Total current assets for this fiscal year were 2,239,092 yen, up 1,893,384 yen from the previous fiscal year, and total assets, including fixed assets held for longer than one year, were 2,352,142 yen, also up 1,893,384 yen (the amount of fixed assets has not changed since the company was founded).

Total liabilities, on the other hand, increased by 1,031,000 yen from last year to 4,868,700 yen. Total net assets, which are total assets minus total liabilities, increased by 862,384 yen from the previous year to -2,516,558 yen. Graph below shows the main indicators on the balance sheet from the 1st fiscal year (Figure 1). It is striking that total net assets, which had been on a downward trend since its establishment, was able to turn upward in the current term, although still negative.

Figure 1: Changes in Main Indicators in the Balance Sheet since Foundation

Net Assets Increase/Decrease Statement for FY2021

Next, let’s look at the statement of changes in net assets, which shows the details of money spent and sales during this fiscal year (April 1, 2020 to March 31, 2021). This is also in yen.

Title This FY (2021) Prev. FY (2020) Increase/Decrease
I. General Net Assets Increase/Decrease
1. Ordinary Increase/Decrease
⑴ Ordinary revenues
① Business income ( 6,267,250) (1,503,721) (4,763,529)
Business income 6,267,250 1,503,721 4,763,529
② Donation received (116,546) (61,209) (55,337)
Donation received 116,546 61,209 55,337
③ Other revenues (6) (4) (2)
Interest received 6 4 2
Total ordinary revenues 6,383,802 1,564,934 4,818,868
⑵ Ordinary expenses
① Business expenses
Business expenses (325,918) (373,823) (-47,905)
Travel and transportation expenses 11,527 -11,527
Communication transportation costs 940 252 688
Consumables costs 22,000 22,000
Miscellaneous expenses 39,064 -39,064
Commission fee 97,624 65,575 32,049
Compensation paid 198,000 257,405 -59,405
Newspaper book expenses 7,354 7,354
Total business expenses 325,918 373,823 -47,905
② Administrative expenses
Outsourcing costs 5,175,500 3,454,000 1,721,500
Meeting fee 2,623 -2,623
Total administrative expenses 5,175,500 3,456,623 1,718,877
Total ordinary expenses 5,501,418 3,830,446 1,670,972
Ordinary increase/decrease before valuation gain/loss this FY 882,384 -2,265,512 3,147,896
Total valuation gain/loss 0 0 0
Ordinary increase/decrease this FY 882,384 -2,265,512 3,147,896
2. Non-ordinary Increase/Decrease
⑴ Non-ordinary revenues
Total non-ordinary revenues 0 0 0
⑵ Non-ordinary expenses
Total non-ordinary expenses 0 0 0
Non-ordinary increase/decrease this FY 0 0 0
General net assets increase/decrease before transfer to other accounts this FY 882,384 -2,265,512 3,147,896
General net assets increase/decrease before taxes this FY 882,384 -2,265,512 3,147,896
Corporate tax, resident tax and business tax 20,000 20,000 0
General net assets increase/decrease this FY 862,384 -2,285,512 3,147,896
General net assets at beginning of FY -3,378,942 -1,093,430 -2,285,512
General net assets at end of FY -2,516,558 -3,378,942 862,384
II. Designated Net Assets Increase/Decrease
Designated net assets increase/decrease this FY 0 0 0
Designated net assets at beginning of FY 0 0 0
Designated net assets at end of FY 0 0 0
III. Net Assets at End of FY -2,516,558 -3,378,942 862,384

First, let’s look at “I. General Net Assets”. The term “General net assets” here is the opposite of “Designated Net Assets”. While the latter is property that is designated for use and the corporation cannot decide how to use it, the former is the opposite, allowing the corporation to freely decide how to use it. Since our corporation has no “Designated net assets” as described below, we should be able to grasp the income and expenses for the 4th fiscal year by looking at this section.

Among the “I. General Net Assets Increase/Decrease” section, what catches the eye is that “Business income” raised 6,267,250 yen, which is 4,763,529 yen more than the previous fiscal year (pale yellow cell). As a result, the “Total ordinary revenues”, which indicates the profit earned in the main business, was able to raise 6,383,802 yen, which is 1,564,934 yen more than the previous year. This revenue amount is about four times that of the previous fiscal year. This was due to the expansion of contract development from external companies, which was also mentioned in the Previous Business Report in the current fiscal year. In addition, although the amount is not a large amount, we were able to obtain 116,546 yen in “Donations received”, which is 55,337 yen more than the previous fiscal year.

On the other hand, “Total business expenses”, which are the expenses to conduct business, were 325,918 yen, 47,905 yen less than the previous fiscal year. “Total administrative expenses”, which are the costs of maintaining the corporation, totaled 5,175,500 yen, 1,718,877 yen more than in the previous fiscal year. This increase was due to the aforementioned “Outsourcing costs” (labor costs to subcontractors) related to the large increase in “Business income”. As already mentioned, in the previous fiscal year, “Business income” totaled 1,503,721 yen. The reason for the four-fold increase was due in part to the increase in the number of projects, but also to the fact that the company was able to subcontract work to developers other than Representative Director Murakami. Securing development resources will be the key to securing the same or higher business profits in the next fiscal year. “Total ordinary expenses”, which are the sum of the “Total business expenses”and “Total administrative expenses” mentioned above, totaled 5,501,418 yen, 1,670,972 yen more than the previous fiscal year.

Looking further down, “Total valuation gain/loss”, which shows the difference between the purchase price and the current price of assets held related to securities, etc., is 0 yen. This is because we do not hold any securities. “Total non-ordinary expenses”, which represent income other than core business, are also zero.

At the end of “I. General Net Assets Increase/Decrease” is “General net assets at beginning of FY” and “General net assets at end of FY”. To put it simply, the former is the money carried forward from the previous term, while the latter is the money carried forward to the next term. The former, that is, the “General net assets at beginning of FY” was -3,378,942, while the latter, that is, the “General net assets at end of FY” increased by 862,384 yen to -2,516,558. To put it simply, it shows that although the deficit up to the previous term has been reduced, there is still a long way to go to eliminate it.

The next section, “II. Designated Net Assets Increase/Decrease” are all zero yen, as mentioned above. And the carryover to the 5th fiscal year, “III. Net Assets at End of FY” was -2,516,558 yen (the same as “General net assets at end of FY”). Figure 2 shows a graphical representation of the changes in the main indicators on the statement of changes in net assets since the foundation of the company. The graph (Figure 2) shows that all indicators, except for “Business expenses”, have increased significantly.

Figure 2: Changes in Key Indicators in the Net Assets Increase/Decrease Statement since Foundation

Finally, “Ordinary increase/decrease this FY”, an indicator of whether a business is in the red or in the black, is shown graphically from its inception (Figure 3). It can be seen that the deficit amount had been increasing until the previous fiscal year, but this fiscal year it has been able to turn into a surplus (so-called single-year surplus) with a V-shaped recovery.

Changes in “Ordinary increase/decrease this FY” since foundation

Income and Expenditure Statement for FY2021

At the end of Chapter 1, we will look at “Income and Expenditure Statement”, which compares the budgeted amount to the closing amount during the current fiscal year (April 1, 2020 to March 31, 2021). However, since we have not developed a budget, it will remain a formality and will be substantially the same as the statement of changes in net assets in the previous section. The unit of measure is also yen.

Title Budgetary Amount Settlement Amount Difference Note
I. General Net Assets Increase/Decrease
1. Ordinary Increase/Decrease
⑴ Ordinary revenues
① Business income (0) (6,267,250) -6,267,250
Business income 6,267,250 -6,267,250
② Donation received (0) ( 116,546) (-116,546)
Donation received 116,546 -116,546
③ Other revenues (0) (6) (-6)
Interest received 0 6 -6
Total ordinary revenues 0 6,383,802 -6,383,802
⑵ Ordinary expenses
① Business expenses
Business expenses (0) (325,918) -325,918
Travel and transportation expenses 940 -940
Communication transportation costs 22,000 -22,000
Consumables costs 97,624 -97,624
Compensation paid 198,000 -198,000
Newspaper book expenses 7,354 -7,354
Total business expenses 0 325,918 -325,918
② Administrative expenses
Outsourcing costs 5,175,500 -5,175,500
Total administrative expenses 0 5,175,500 -5,175,500
Total ordinary expenses 0 5,501,418 -5,501,418
Ordinary increase/decrease before valuation gain/loss this FY 0 882,384 -882,384
Total valuation gain/loss 0 0 0
Ordinary increase/decrease this FY 0 882,384 -882,384
2. Non-ordinary Increase/Decrease
⑴ Non-ordinary revenues
Total non-ordinary revenues 0 0 0
⑵ Non-ordinary expenses
Total non-ordinary expenses 0 0 0
Non-ordinary increase/decrease this FY 0 0 0
General net assets increase/decrease before transfer to other accounts this FY 0 882,384 -882,384
General net assets increase/decrease before taxes this FY 0 882,384 -882,384
Corporate tax, resident tax and business tax 0 20,000 -20,000
General net assets increase/decrease this FY 0 882,384 -882,384
General net assets at beginning of FY 0 -3,378,942 3,378,942
General net assets at end of FY 0 -2,516,558 2,516,558
Ⅱ. Designated Net Assets Increase/Decrease
II. Designated Net Assets Increase/Decrease 0 0 0
Designated net assets at beginning of FY 0 0 0
Designated net assets at end of FY 0 0 0
III. Net Assets at End of FY 0 -2,516,558 2,516,558

Chapter 2: Activity Report for FY2021

Foreword

This fiscal year we were able to achieve a profit for the single fiscal year. The direct cause of this was the expansion of contracted development from outside companies, as mentioned in the previous chapter. However, behind this is the fact that Vivliostyle products have been enhanced and the ecosystem among these products has begun to function. In other words, without these factors, there would have been no expansion of contract development.

Therefore, this chapter describes the development status of each of the Vivliostyle products. We will also explore the challenges for the next fiscal year. Again, this is because we have an accumulated deficit, which is not small, and eliminating it is our immediate goal.

Classification of products and their roles

Before reporting on the development status of each product, let us review its position in the product lineup. The increase in the number of products in recent years has been gratifying, but it has become difficult to understand from the outside what role each product plays and how it fits into the overall product lineup.

The above links are to the respective repositories. In other words, the above classification is also a classification of repositories. However, the above classifications are for the sake of clarity and are not necessarily strict. For example, VFM is not only a library but also a generator that converts Markdown to HTML.

From the next section, we will explain the development status of each product in the current fiscal year according to the above classification, referring to announcements made at user events, blog posts, and other sources. For reference, the beginning of FY and end of FY versions are shown in parentheses (except Vivliostyle Themes and Vivliostyle Pub, which have no concept of release as a product).

Library: Vivliostyle.js (v2.6.2 -> v2.14.4)

Vivliostyle.js is the actual CSS typesetting software and is the core of the Vivliostyle product. Fortunately, we were able to make significant functional improvements to this product this fiscal year, as follows.

So how were these features developed? The graph shows the number of pull requests per month in the repository and compared with the previous fiscal year (Fig. 4 / Excluding automatic processing, only pull requests by humans were targeted. The same applies hereafter).

Figure 4: Monthly pull requests for the Vivliostyle.js repository compared to the previous fiscal year

The previous fiscal year also saw constant pull requests throughout the year, but the pace of development this fiscal year was even faster than that. The functional upgrades mentioned above were also realized as a result of such enthusiastic development.

The important thing here is that the enhancements Vivliostyle.js also spilled over into the Vivliostyle CLI and Vivliostyle Pub that incorporated it, and they immediately implemented the new features. It was a scene where the true nature of the library was demonstrated.

Library: VFM (v1.0.0-alpha.17 -> v1.2.1)

VFM (Vivliostyle Flavored Markdown)(https://github.com/vivliostyle/vfm), a Markdown dialect optimized for book typesetting, has released v1 this fiscal year. This v1 is partly a preparation for the upcoming v2.

Originally, this product used Remark as its Markdown conversion engine. However, its new version, Remark 13, contains many changes that are incompatible with past versions, and its implementation was expected to be a significant amount of work.

Therefore, we decided to first release a version with a range of functions that can be implemented without Remark 13 as v1, and then work on support for Remark 13 as v2. For details, please refer to the presentation by akabekobeko, the maintainer.

The v1.0.2 released on July 21, 2021 implements the functionality that can be achieved without this Remark 13. See below for details.

As with Vivliostyle.js, these enhancements were quickly implemented in the Vivliostyle CLI and other products.

Library: Vivliostyle Themes

This product is a library of style files that all Vivliostyle products share. It consists of a set of Theme files that define styles and a set of tools for creating these Themes.

Several minor updates were made this fiscal year. However, the most significant achievement is the release of the User’s Guide, which is shown below.

This product will allow users to create documents faster and easier by eliminating the need to set up new styles when using Vivliostyle products. However, to achieve this, it is necessary to publish a wide variety of themes in response to user demand. However, it is not realistic for us to create and publish many themes by ourselves. We need to make it easy for individual users to create new themes and to make them easily available to the public. This will make this product more useful as a library, which in turn will encourage the creation of new themes.

However, at present, awareness of this product is low and there is still a long way to go to reach the goal. Therefore, yamasy1549, the maintainer of this product, decided to develop a document to let people know how to use the Theme and how to create it. The above user guide is the first step. For more details, please refer to the following.

Generator: Vivliostyle CLI (v3.2.1 -> v4.8.2)

This product converts Markdown to HTML by CLI (command line interface) and outputs it. First, please take a look at the graph comparing the number of monthly pull requests with the previous fiscal year. Although not as high as in the previous fiscal year, the graph shows that development continued consistently during this fiscal year (Figure 5).

Figure 5: Monthly pull requests for the Vivliostyle CLI repository compared to the previous fiscal year

As a result of these developments, the product was able to achieve a variety of functional enhancements this fiscal year. The most significant of these is support for Docker mode, which allows execution in a virtual environment (v4.0.0). Docker virtualizes the program execution environment. This frees users from the trouble of output results changing when the OS, browser, or Vivliostyle CLI itself is upgraded. This kind of idempotency/reliability should be essential for users who want to use the Vivliostyle CLI in practice.

Here, let’s explain the update contents after v4.0.0 by referring to the presentation “Vivliostyle CLI update –2022 Spring” in “Vivliostyle User / Dev Meetup 2022 Spring” by spring-raining who is the maintainer of this product.

In his presentation, spring-raining described his vision for the future of this product as follows Expectations for the next fiscal year are growing.

Generator: create-book (v0.1.6 -> v0.5.1)

This product is a software, or installer, that allows users to interactively build an execution environment for the Vivliostyle CLI. However, there were some maintenance updates this fiscal year and no major functional upgrades.

Generator: vivliostyle-sitegen

This product was conceived as a static site generator using VFM, and development of this product was newly started this fiscal year.

The original trigger was a free discussion session at a user event in the fall (“Vivliostyle User/Dev Meetup Autumn 2021”](https://vivliostyle.connpass.com/event/227954/) on November 14, 2021) in which VFM released v1, but there were voices saying that it was a pity that VFM could not use it on the Vivliostyle site. In response, VFM maintainer akabekobeko raised his hand, and development began in January 2022.

Development is currently underway with the aim of releasing the system within the next fiscal year. After the release, the system will be implemented in a document production system for Vivliostyle users, such as vivliostyle.org. Once this happens, it will be possible to disseminate information about Vivliostyle using VFM, which has a wealth of expressive power. In this way, the Vivliostyle ecosystem will expand even further.

Web application: Vivliostyle Pub

This product is a web application that deploys Vivliostyle.js, VFM, Vivliostyle Themes, and Vivliostyle CLI on the cloud. When a user writes Markdown on the left side of the browser, CSS typesetting is immediately performed and previewed on the right side of the browser (Figure 6).

Figure 6: Vivliostyle Pub, which released an alpha version

The project was originally launched in a hurry to apply for the Unexplored Advanced Project in FY2019 with the aim of securing development funds. After two months of intensive development by a team of committers, the project was completed to PoC (Proof of Concept) in May 2020 (see annual report for the previous fiscal year).

However, after the lose in June 2020, the committers gradually left, and only takanakahiko remained and continued to develop steadily. This situation changed drastically in November 2021, when AyumuTakai joined the project. The graph below shows the number of monthly pull requests for this product compared to the previous fiscal year (Figure 7).

Figure 7: Monthly pull requests in the Vivliostyle Pub repository compared to the previous fiscal year

At first glance, there are more pull requests in the first half of this fiscal year than in the previous fiscal year (this is takanakahiko’s work), but from November to February of the following year, when Ayumu Takai joined, there does not seem to be much difference between the previous fiscal year and this fiscal year. Let us change the indicator and look at the graph comparing the number of monthly commits with the previous fiscal year (Figure 8).

Figure 8: Number of monthly commits in the Vivliostyle Pub repository compared to the previous fiscal year

The blue line shows the number of commits to the default branch in the previous fiscal year, and the green line shows the number of commits to the default branch in the current fiscal year. Looking at these two lines, as with the monthly number of pull requests in Figure 7 above, it appears that not much development progress was made from November to February of the following year. However, note the gray line. This is the number of monthly commits by Ayumu Takai on the prototype branch for the current term. The number of commits in April and May of the previous fiscal year was the result of a team of four to five developers, but the number of commits by just one person exceeds that number. However, the development method was somewhat irregular.

AyumuTakai started development on the prototype branch on November 2, but did not submit a pull request to the default branch until February, and has been accumulating many commits on the prototype branch. Perhaps, as a result of adding many improvements one after another, he lost the timing to submit a pull request. In the end, he left the prototype branch as it was and created a new branch called pre_alpha on February 3, from which he submitted only one pull request to the default branch.

As a result, although AyumuTakai’s work hardly appeared in the number of pull requests shown in Figure 7 above, his contribution could be visualized by superimposing the number of commits in the prototype branch in Figure 8 above. In this pull request, アルファ版準備 #142, you can see a list of user interface changes and added features added at this time. It can be seen that all of them were indispensable elements for the normal use of this product (AyumuTakai withdrew from development at the end of March due to the busyness of its main business. We sincerely appreciate his contribution).

So far, we have described the contributions of AyumuTakai and takanakahiko, who were directly responsible for the development of this product. However, it is important not to forget that this product has been able to incorporate the results of the Vivliostyle.js, VFM, Vivliostyle Themes, and Vivliostyle CLI updates described in the previous sections, simply by replacing the components. This means that this product has been able to incorporate the results of the Vivliostyle.js, VFM, Vivliostyle Themes, and Vivliostyle CLI updates by simply replacing components.

For example, in Figure 6 above, the Web font is displayed, but this is not this product, but a function realized by the update of the Vivliostyle .js. You can truly feel the power of Vivliostyle products as an ecosystem.

In this way, although it was far behind our original goal, we were able to announce the alpha release of this product at the “Vivliostyle User / Dev Meetup 2022 Spring” held on April 23, 2022.

Web content and its production system

This section will collectively address the following user documents related to Vivliostyle and its production system.

  1. vivliostyle.orgFoundation’s official website
  2. docs.vivliostyle.orgUser guides for each product
  3. docs-vivliostyle-pubVivliostyle Pub User Guide
  4. vivliostyle_docSample page and Annual reports

The most familiar information dissemination tool for us is the blog in #1 above. The following eight articles were updated during this fiscal year.

Also, the user guide mentioned as newly added in the Vivliostyle Themes section is one of the #2 above. And #3 above is another user guide newly added this fiscal year in preparation for the alpha release of Vivliostyle Pub.

All of them are written in Markdown, but the converters for converting them to HTML are different: Jekyll for #1, docute for #2 and #3, and Pandoc for #4. As mentioned above, vivliostyle-sitegen is an attempt to improve this situation and further enable the use of VFM’s rich expressions.

Challenges for the next fiscal year and how to address them

So far, we have described the development status of Vivliostyle products during the current term. At the beginning, our products were limited to the current Vivliostyle Viewer/Vivliostyle.js and the Vivliostyle CLI. From there, the number of repositories was gradually increased each year, and we have reached the point where the ecosystem among products as described in the previous section is beginning to function.

In the previous section, we reported that the foundation achieved a profit for the single fiscal year, and most of the revenue was generated from contracted development related to Vivliostyle products and from maintenance of products that had been delivered in the past. In other words, in our case, the development and expansion of our products are directly linked to securing business income.

However, simply expanding Vivliostyle products will not necessarily lead to an increase in business income. In other words, product expansion is not a necessary condition for increasing profits, but a sufficient condition. Then, what are the obstacles to increasing profits? We would like to list the following issues.

  1. Most of the business income is limited to contracted development.
  2. Limited number of developers who undertake contracted development.
  3. Almost only one company places orders for contracted development.

To address #1 above, it is necessary to secure a variety of revenues other than contracted development. For example, business income from Vivliostyle Pub. We should also seriously consider expanding the amount of donations we receive, which we have done little to promote since the creation of the [sponsor solicitation page] in the 3rd fiscal year.

To address #2 above, as discussed in the previous section, “Statement of Net Assets Increase/Decrease for FY2021”, we were able to secure a trustee other than Representative Murakami this fiscal year, but the key will be whether we can continue to secure a trustee in the next fiscal year. For example, we should consider asking committers to contracted development. In addition, it will be important to make efforts to increase the number of committers for the entire product in order to reduce the burden on individual committers.

Finally, to address #3 above, diversification of ordering sources is a matter of course, and addressing #1 above should also address #3 as it is.

Directors