BookStack for IT Documentation

JaredBusch

# General auth
AUTH_METHOD=standard

# Social Authentication information. Defaults as off.
GITHUB_APP_ID=false
GITHUB_APP_SECRET=false
GOOGLE_APP_ID=false
GOOGLE_APP_SECRET=false
OKTA_BASE_URL=false
OKTA_APP_ID=false
OKTA_APP_SECRET=false
TWITCH_APP_ID=false
TWITCH_APP_SECRET=false
GITLAB_APP_ID=false
GITLAB_APP_SECRET=false
GITLAB_BASE_URI=false

# External services such as Gravatar and Draw.IO
DISABLE_EXTERNAL_SERVICES=false

# LDAP Settings
LDAP_SERVER=false
LDAP_BASE_DN=false
LDAP_DN=false
LDAP_PASS=false
LDAP_USER_FILTER=false
LDAP_VERSION=false

Alex Sage

@tim_g Correct.

black3dynamite

Is there a way to stop showing previews?
Is there a way to collapse text in Bookstack using markdown?

stacksofplates

Is anyone actually using this?

Obsolesce

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I think JB is due to some clients needing a WYSIWYG editor.

NashBrydges

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I've fully transitioned to this for the same reasons @JaredBusch did. Easier for users.

JaredBusch

@black3dynamite said in BookStack for IT Documentation:

Is there a way to stop showing previews?
Is there a way to collapse text in Bookstack using markdown?

Never looked.
I do not know of any markdown commands to do that.

stacksofplates

@nashbrydges said in BookStack for IT Documentation:

@stacksofplates said in BookStack for IT Documentation:

Is anyone actually using this?

I've fully transitioned to this for the same reasons @JaredBusch did. Easier for users.

Oh ok. Ya if you need users to do something then that makes sense.

black3dynamite

@jaredbusch said in BookStack for IT Documentation:

@black3dynamite said in BookStack for IT Documentation:

Is there a way to stop showing previews?
Is there a way to collapse text in Bookstack using markdown?

Never looked.
I do not know of any markdown commands to do that.

When using WYSIWYG for your page editor, click on source code
and add this code. It also works when using Markdown too.

## collapsible markdown?

<details><summary>CLICK ME</summary>
<p>
Hello World
</p>
</details>

Source: https://gist.github.com/joyrexus/16041f2426450e73f5df9391f7f7ae5f#collapsible-markdown

JaredBusch

Does that work here?

Collapse test:

<details>
<summary>CLICK ME</summary>
<p>
Hello World
</p>
</details>

JaredBusch

Nope.

Francesco Provino

I usually use just plaintext filed nested in folders... other mainstream solutions?

scottalanmiller

@francesco-provino said in BookStack for IT Documentation:

I usually use just plaintext filed nested in folders... other mainstream solutions?

That's basically all DokuWiki is

stacksofplates

@francesco-provino said in BookStack for IT Documentation:

I usually use just plaintext filed nested in folders... other mainstream solutions?

I use Grav. I don't have users documenting anything so it's awesome for us. It's all markdown and it's all flat file based, no databases.

JaredBusch

@stacksofplates said in BookStack for IT Documentation:

@francesco-provino said in BookStack for IT Documentation:

I usually use just plaintext filed nested in folders... other mainstream solutions?

I use Grav. I don't have users documenting anything so it's awesome for us. It's all markdown and it's all flat file based, no databases.

Yes, lots of Wiki systems exist and work well. But if entry is a style that your users cannot handle, it will not be used. If it is not used, it is worthless.

AdamF

@stacksofplates said in BookStack for IT Documentation:

Grav

Grav looks pretty sweet. There are so many solutions out there.

Obsolesce

@fuznutz04 said in BookStack for IT Documentation:

@stacksofplates said in BookStack for IT Documentation:

Grav

Grav looks pretty sweet. There are so many solutions out there.

Yeah Grav with GIT would be my go-to if I didn't have so many requirements.

AdamF

@tim_g said in BookStack for IT Documentation:

@fuznutz04 said in BookStack for IT Documentation:

@stacksofplates said in BookStack for IT Documentation:

Grav

Grav looks pretty sweet. There are so many solutions out there.

Yeah Grav with GIT would be my go-to if I didn't have so many requirements.

Requirements such as?

AdamF

@tim_g bump