Merge pull request #436 from seratch/link-anchor

Adjust html anchor to work with the fixed header

Author: seratch

docs/assets/default.css

@@ -2,6 +2,11 @@ a.headerlink {
   display: none !important;
 }
 
+h2 {
+  margin-top: -120px;
+  padding-top: 120px;
+}
+
 .section-title {
   font-size: 2rem;
   line-height: 2.5rem;

docs/guides/app-distribution.md

@@ -30,6 +30,7 @@ All your app needs to do to properly handle OAuth Flow are:
 * Provide the endpoints to navigate installers for the completion/cancellation of the installation flow
   * The URLs are usually somewhere else but Bolt has simple functionality to serve them
 
+---
 ## Examples
 
 Here is a Bolt app demonstrating how to implement OAuth flow. As the OAuth flow handling features are unnecessary for many custom apps, those are disabled by default. **App** instances need to explicitly call `asOAuthApp(true)` to turn on them.

docs/guides/app-home.md

@@ -31,6 +31,7 @@ All your app needs to do to provide Home tabs to your app users are:
 
 Most commonly, [`"app_home_opened"`](https://api.slack.com/events/app_home_opened) events would be used as the trigger to call the [**views.publish**](https://api.slack.com/methods/views.publish) method. Subscribing this event type is useful particularly for the initial Home tab creation. But it's also fine to publish Home tabs by any other means.
 
+---
 ## Examples
 
 **NOTE**: If you're a beginner to using Bolt for Slack App development, consult [Getting Started with Bolt]({{ site.url | append: site.baseurl }}/guides/getting-started-with-bolt), first.

docs/guides/audit-logs-api.md

@@ -12,6 +12,7 @@ The Audit Logs API can be used by security information and event management (SIE
 
 Follow the instructions in [the API document](https://api.slack.com/docs/audit-logs-api) to get a valid token for using Audit Logs API. Your Slack app for Audit Logs API needs to be installed on the Enterprise Grid Organization, not an individual workspace within the organization.
 
+---
 ## Call Audit Logs API in Java
 
 It's straight-forward to call Audit Logs API using **slack-api-client** library.

docs/guides/bolt-basics.md

@@ -10,6 +10,7 @@ lang: en
 
 This guide covers all the basics of Bolt app development. If you're not yet familiar with Slack app development in general, we recommend reading [An introduction to Slack apps](https://api.slack.com/start/overview).
 
+---
 ## Start with the App class
 
 The **App** class is a place to write only essential parts of your Slack app without being bothered by trifles.
@@ -25,6 +26,7 @@ app.command("/echo", (req, ctx) -> {
 });
 ```
 
+---
 ## Dispatching Events
 
 Here is the list of the available methods to dispatch events.
@@ -45,6 +47,7 @@ Here is the list of the available methods to dispatch events.
 |**app.dialogCancellation**|callback_id **String** \| **Pattern**|**Dialogs**: Responds to the events where users close dialogs by clicking Cancel buttons.|
 |**app.attachmentAction**|callback_id: **String** \| **Pattern**|**Legacy Messaging**: Responds to user actions in **attachments**. These events can be triggered in only messages.|
 
+---
 ## Development Guides by Feature
 
 On these guide pages, you'll find a more concrete example code for each.
@@ -57,6 +60,7 @@ On these guide pages, you'll find a more concrete example code for each.
 * [**Events API**]({{ site.url | append: site.baseurl }}/guides/events-api)
 * [**App Distribution (OAuth Flow)**]({{ site.url | append: site.baseurl }}/guides/app-distribution)
 
+---
 ## Acknowledge Incoming Requests
 
 Actions, commands, and options events must always be acknowledged using the `ack()` method. All such utility methods are available as the instance methods of a **Context** object.
@@ -102,6 +106,7 @@ app.command("/ping", (req, ctx) -> {
 });
 ```
 
+---
 ## Respond to User Actions
 
 Are you already familiar with `response_url`? If not, we recommend reading [this guide](https://api.slack.com/interactivity/handling#message_responses) first.
@@ -123,6 +128,7 @@ app.command("/hello", (req, ctx) -> {
 });
 ```
 
+---
 ## Use Web APIs / Reply using say utility
 
 When you need to call some Slack Web APIs in Bolt apps, use `ctx.client()` for it. The **MethodsClient** created by the method already holds a valid bot token. So, you don't need to give a token to it. Just calling a method with parameters as below works for you.
@@ -176,6 +182,7 @@ app.command("/my-search", (req, ctx) -> {
 });
 ```
 
+---
 ## Use Logger
 
 You can access [SLF4J](http://www.slf4j.org/) logger in **Context** objects.
@@ -204,6 +211,7 @@ If you use the [**ch.qos.logback:logback-classic**](https://search.maven.org/art
 </configuration>
 ```
 
+---
 ## Middleware
 
 Bolt offers chaining middleware supports. You can customize **App** behavior by weaving a kind of filter to all events.
@@ -264,10 +272,12 @@ A set of the built-in middleware precedes your custom middleware. So, if the app
 
 The most common would be the case where a request has been denied by **RequestVerification** middleware. After the denial, any middleware won't be executed, so that the above middleware also doesn't work for the case.
 
+---
 ## Supported Web Frameworks
 
 Refer to [this page]({{ site.url | append: site.baseurl }}/guides/supported-web-frameworks) for more details.
 
+---
 ## Deployments
 
 [We're planning](https://github.com/slackapi/java-slack-sdk/issues/348) to have some guide documents for deployments.

docs/guides/composing-messages.md

@@ -10,6 +10,7 @@ This section shows how to build Slack messages using **slack-api-client** librar
 
 Also, before jumping into Java code, we recommend developing an understand of composing Slack messages. [Read the API documentation](https://api.slack.com/messaging/composing) for more information.
 
+---
 ## Text Formatting
 
 Composing a text message is the simplest way to post a message to Slack conversations.
@@ -32,6 +33,7 @@ ChatPostMessageResponse response = slack.methods(token).chatPostMessage(req -> r
 
 As you see, using `text` is fairly simple. The only thing to know is to give a string value with a valid format. Consult [Basic formatting with `mrkdwn`](https://api.slack.com/reference/surfaces/formatting#basics) for understanding the markup language.
 
+---
 ## Building Blocks for Rich Message Layouts
 
 [Block Kit](https://api.slack.com/block-kit) is a UI framework for Slack apps that offers a balance of control and flexibility when building experiences in messages and other [surfaces](https://api.slack.com/surfaces).

docs/guides/events-api.md

@@ -31,6 +31,7 @@ All you need to do to handle Events API requests are:
 
 Your app has to respond to the request within 3 seconds by `ack()` method. Otherwise, the Slack Platform may retry after a while.
 
+---
 ## Examples
 
 **NOTE**: If you're a beginner to using Bolt for Slack App development, consult [Getting Started with Bolt]({{ site.url | append: site.baseurl }}/guides/getting-started-with-bolt), first.

docs/guides/getting-started-with-bolt.md

@@ -25,7 +25,6 @@ This guide explains how to start your first-ever Bolt app.
 If you're not yet familiar with Slack app development in general, we recommend reading [An introduction to Slack apps](https://api.slack.com/start/overview).
 
 ---
-
 ## Project Setup
 
 Let's start building a Slack app with Bolt! This guide shows how to set up a Bolt project with Maven, and Gradle.
@@ -70,7 +69,6 @@ dependencies {
 ```
 
 ---
-
 ## Run Your Bolt App in 3 Minutes
 
 ### Use **bolt-jetty**
@@ -230,7 +228,6 @@ public class SlackAppController extends SlackAppServlet {
 Check [the detailed guide here]({{ site.url | append: site.baseurl }}/guides/supported-web-frameworks) for further information.
 
 ---
-
 ## Getting Started in Kotlin
 
 For code simplicity, [Kotlin](https://kotlinlang.org/) language would be a great option for writing Bolt apps. In this section, you'll learn how to set up a Kotlin project for Bolt apps.
@@ -308,6 +305,7 @@ From here, all you need to do is write code and restart the app. Enjoy Bolt app
 
 **Pro tip**: We strongly recommend using [IntelliJ IDEA](https://www.jetbrains.com/idea/) here even if you don't prefer using IDEs. The IDE is the smoothest way to try Kotlin application development.
 
+---
 ## Next Steps
 
 Read the [Bolt Basics]({{ site.url | append: site.baseurl }}/guides/bolt-basics) for further information.

docs/guides/incoming-webhooks.md

@@ -14,6 +14,7 @@ To enable this feature, visit the [Slack App configuration page](http://api.slac
 
 Then, install the app to your development workspace. Each time your app is installed, a new Webhook URL will be generated.
 
+---
 ## How To Use 
 
 Here is a **curl** command example demonstrating how to send a message via an Incoming Webhooks URL.

docs/guides/interactive-components.md

@@ -29,6 +29,7 @@ All your app needs to do to handle Slack requests by user interactions are:
 
 Your app has to respond to the request within 3 seconds by `ack()` method. Otherwise, the user will see the timeout error on Slack. For some of the requests including external selects, having valid parameters to the method may be required.
 
+---
 ## Examples
 
 **NOTE**: If you're a beginner to using Bolt for Slack App development, consult [Getting Started with Bolt]({{ site.url | append: site.baseurl }}/guides/getting-started-with-bolt), first.