Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/api-site-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ customDocsPath: 'website-docs'

`editUrl` - url for editing docs, usage example: `editUrl + 'en/doc1.md'`. If this field is omitted, there will be no "Edit this Doc" button for each document.

`facebookAppId` - If you want Facebook Like/Share buttons at the bottom of your blog posts, provide a [Facebook application id](https://www.facebook.com/help/audiencenetwork/804209223039296), and the buttons will show up on all blog posts.
`facebookAppId` - If you want Facebook Like/Share buttons in the footer and at the bottom of your blog posts, provide a [Facebook application id](https://www.facebook.com/help/audiencenetwork/804209223039296).

`facebookPixelId` - [Facebook Pixel](https://www.facebook.com/business/a/facebook-pixel) ID to track page views.

Expand Down Expand Up @@ -154,6 +154,8 @@ h1 {

`twitter` - Set this to `true` if you want a Twitter social button to appear at the bottom of your blog posts.

`twitterUsername` - If you want a Twitter follow button at the bottom of your page, provide a Twitter username to follow. For example: `docusaurus`.

`twitterImage` - Local path to your Twitter card image (e.g., `img/myImage.png`). This image will show up on the Twitter card when your site is shared on Twitter.

`useEnglishUrl` - If you do not have [translations](guides-translation.md) enabled (e.g., by having a `languages.js` file), but still want a link of the form `/docs/en/doc.html` (with the `en`), set this to `true`.
Expand Down Expand Up @@ -231,6 +233,7 @@ const siteConfig = {
facebookAppId: '1615782811974223',
facebookPixelId: '352490515235776',
twitter: 'true',
twitterUsername: 'docusaurus',
twitterImage: 'img/docusaurus.png',
ogImage: 'img/docusaurus.png',
};
Expand Down
2 changes: 1 addition & 1 deletion lib/core/Site.js
Original file line number Diff line number Diff line change
Expand Up @@ -113,7 +113,7 @@ class Site extends React.Component {
}}
/>
)}
{this.props.config.twitter && (
{(this.props.config.twitter || this.props.config.twitterUsername) && (
<script
dangerouslySetInnerHTML={{
__html: `window.twttr=(function(d,s, id){var js,fjs=d.getElementsByTagName(s)[0],t=window.twttr||{};if(d.getElementById(id))return t;js=d.createElement(s);js.id=id;js.src='https://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js, fjs);t._e = [];t.ready = function(f) {t._e.push(f);};return t;}(document, 'script', 'twitter-wjs'));`,
Expand Down
4 changes: 4 additions & 0 deletions lib/static/css/main.css
Original file line number Diff line number Diff line change
Expand Up @@ -1826,6 +1826,10 @@ footer .copyright {
text-align: center;
}

footer .social {
padding: 5px 0;
}

.entry-share {
padding: 36px 0;
display: block;
Expand Down
65 changes: 42 additions & 23 deletions website/core/Footer.js
Original file line number Diff line number Diff line change
Expand Up @@ -8,21 +8,49 @@ const PropTypes = require('prop-types');

const React = require('react');

const GitHubButton = props => (
<a
className="github-button" // part of the https://buttons.github.io/buttons.js script in siteConfig.js
href={`https://github.com/${props.config.organizationName}/${props.config.projectName}`}
data-icon="octicon-star"
data-count-href={`/${props.config.organizationName}/${props.config.projectName}/stargazers`}
data-show-count="true"
data-count-aria-label="# stargazers on GitHub"
aria-label="Star this project on GitHub"
>
Star
</a>
const SocialFooter = props => (
<div>
<h5>More</h5>
<div className="social">
<a
className="github-button" // part of the https://buttons.github.io/buttons.js script in siteConfig.js
href={`https://github.com/${props.config.organizationName}/${
props.config.projectName
}`}
data-count-href={`/${props.config.organizationName}/${
props.config.projectName
}/stargazers`}
data-show-count="true"
data-count-aria-label="# stargazers on GitHub"
aria-label="Star this project on GitHub">
{props.config.projectName}
</a>
</div>
{props.config.twitterUsername && (
<div className="social">
<a
href={`https://twitter.com/${props.config.twitterUsername}`}
className="twitter-follow-button">
Follow @{props.config.twitterUsername}
</a>
</div>
)}
{props.config.facebookAppId && (
<div className="social">
<div
className="fb-like"
data-href={props.config.url}
data-layout="standard"
data-share="true"
data-width="225"
data-show-faces="false"
/>
</div>
)}
</div>
);

GitHubButton.propTypes = {
SocialFooter.propTypes = {
config: PropTypes.object
};

Expand Down Expand Up @@ -77,17 +105,8 @@ class Footer extends React.Component {
>
User Showcase
</a>
<a href="https://twitter.com/docusaurus">
Twitter
</a>
</div>
<div>
<h5>More</h5>
<a href="https://github.com/facebook/docusaurus">
GitHub
</a>
<GitHubButton config={this.props.config} />
</div>
<SocialFooter config={this.props.config} />
</section>

<a
Expand Down
1 change: 1 addition & 0 deletions website/siteConfig.js
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,7 @@ const siteConfig = {
gaTrackingId: 'UA-44373548-31',
facebookAppId: '1615782811974223',
twitter: 'true',
twitterUsername: 'docusaurus',
ogImage: 'img/docusaurus.png',
twitterImage: 'img/docusaurus.png',
onPageNav: 'separate',
Expand Down