Writerside themes and powered by options

已回答

we have started Writerside for our documentation. I have following questions I need help with 

 

1. is there a way we can turn off `Powered by JetBrains Writerside` in generated htmls ?

2. are any other themes supported for documentation or is there a plan to support more themes in future?

2

In my cfg/buildprofiles.xml I add <variables><include-in-head>additional-styles.html</include-in-head></variables>. In the file cfg/additional-styles.html I have this content:

<style>
    .footer__powered {
        display: none;
    }
</style>

The line is still in there but doesn't get displayed on the web pages anymore. Of course, you can add and override other CSS, too.

Maybe there's a simpler configuration option by now, but I haven't found it yet.

1

As per the documentation: https://www.jetbrains.com/help/writerside/custom-css-and-font.html#use-custom-css

You can inject custom css files to the project. under “cfg” folder (where buildprofiles.xml is), create a new folder called “static”, and in this folder, create a css file called “styles.css”. Add this css rule in this file:

.app__footer {
  display: none !important;
}

Then, open your buildprofiles.xml and add this in there:

<variables>
    <custom-css>styles.css</custom-css>
    …
</variables>
 
This is the current best way to do it. 

1

According to the JetBrains Community Hub, currently, there is no option to remove the “Powered by JetBrains Writerside” message from the generated HTML. However, JetBrains is actively working on enhancing the customization options for the final output, so this feature may be added in a future edition.

As for themes, Writerside currently supports four themes: “Broadcast”, “Classic”, “Modern”, and “Professional”. JetBrains is working on providing more customization options, so stay tuned! If you have any specific requests or suggestions for themes, you can report an issue in their YouTrack project or join their Slack.

0

Exposing the CSS generated for the website and allowing overrides would be helpful.

0

Thx Thomas! Being a Writerside newbie your hint will be useful in similar situations as well! But with respect to SEO  the text will probably be picked up anyway.  Are we really expected to post process generated HTML by `sed` and friends?

@Jetbrains: Still not offering a solution is disappointing. Probably 95+% of all Writerside customers will likely want to either suppress or replace your advertisement.

0

Goik Thank you for being an early user of Writerside and for your feedback! We understand that control of your documentation portal is important, so I'd love to explain the reasoning behind the watermark. 

Currently, Writerside is entirely free to use during this phase, and the “Powered by JetBrains Writerside” watermark helps us in a few key ways. Since we're a new solution, it helps us spread awareness about Writerside in a subtle and organic way. By being associated with the high quality documentation our users create, it helps others discover Writerside and learn more about the platform. So while we are in the Earcly Access phase, it is one of the few ways we can gather recognition and build trust with our prospect users. That said, we are now actively working on our business model, and are considering letting users remove the watermark in an extended edition

0

Thx for the clarification. Being a long term »XML document head«  this helps building up trust into a possible release past current EAP. Good luck!

0

Hi, thank you for your interest in Writerside!

With regard to your questions:

1. Currently, there is no option to remove it. During the Early Access period, Writerside is freely accessible, and the frontend is included in this offering. However, we are actively working on enhancing the customization options for the final output. In a future edition, we may explore the possibility of allowing users to remove it.

2. The current themes are limited to https://plugins.jetbrains.com/plugin/20158-writerside/docs/styling-and-layout.html. We are working on providing more customization options, so stay tuned! It would be really helpful to learn whether you are looking for more themes, or for specific things you'd like to tweak in the docs appearance. Feel free to report an issue in our YouTrack project or join our Slack (please look at our Code of Conduct before you do)

-1

请先登录再写评论。