Summary: This diff restructures the 'extending' section of the docs, and rebrands it to 'creating plugins'. It then restructures this section into 4 top-level items * Tutorial * Desktop plugin APIs * Client plugin APIs * Workflow Pages are put under the relevant sections, including pages which were before under internal. Some pages that didn't relate directly to plugin development have been moved to other top level sections (e.g. testing RN). I didn't do de-duplication between pages yet, that will be done in the next diff. Overview of changes: * Extending -> Creating Plugins * Moved Extending > Other platforms to Setup > Other platforms (as this is about clients, not plugins) * Moved Internal FB plugin development stuff into Creating Plugins * Separated Creating Plugins into ‘Tutorial’, Desktop API Reference, Cient API Reference, Workflow * Remove TypeScript strict page, we are already strict * Moved QPL linters to api docs and named id QPL lints * Grouped the different pages on extending Layout plugin (needs deduping still) * Warning about avoiding custom styling in general * Moved internal index page to the top of the navigation of FB Internal, rather than at the bottom Reviewed By: passy Differential Revision: D25585172 fbshipit-source-id: ba2aa891395097d6aa101809084b915f115ee69d
175 lines
4.4 KiB
JavaScript
175 lines
4.4 KiB
JavaScript
/**
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
|
*
|
|
* This source code is licensed under the MIT license found in the
|
|
* LICENSE file in the root directory of this source tree.
|
|
*
|
|
* @format
|
|
*/
|
|
|
|
// start-import-example
|
|
const {fbContent, fbInternalOnly} = require('internaldocs-fb-helpers');
|
|
// end-import-example
|
|
|
|
const repoUrl = 'https://github.com/facebook/flipper';
|
|
const siteConfig = {
|
|
title: fbContent({internal: 'Flipper @FB', external: 'Flipper'}),
|
|
tagline: 'Extensible mobile app debugging',
|
|
url: fbContent({
|
|
internal: 'https://flipper.thefacebook.com/',
|
|
external: 'https://fbflipper.com/',
|
|
}),
|
|
baseUrl: '/',
|
|
projectName: 'flipper',
|
|
// TODO: T69061026 enable once sandy docs are complete: external_domain: 'fbflipper.com',
|
|
themeConfig: {
|
|
navbar: {
|
|
title: fbContent({internal: 'Flipper @FB', external: 'Flipper'}),
|
|
logo: {
|
|
alt: 'Flipper Logo',
|
|
src: 'img/icon.png',
|
|
},
|
|
items: [
|
|
{
|
|
to: 'docs/features/index',
|
|
label: 'Features',
|
|
position: 'right',
|
|
},
|
|
{
|
|
to: 'docs/getting-started/index',
|
|
label: 'Setup',
|
|
position: 'right',
|
|
},
|
|
{
|
|
to: 'docs/tutorial/intro',
|
|
label: 'Creating Plugins',
|
|
position: 'right',
|
|
},
|
|
{
|
|
href: repoUrl,
|
|
label: 'GitHub',
|
|
position: 'right',
|
|
},
|
|
// start-internal-navbar-example
|
|
...fbInternalOnly([
|
|
{
|
|
to: 'docs/fb/index',
|
|
label: 'FB Internal',
|
|
position: 'right',
|
|
},
|
|
]),
|
|
// end-internal-navbar-example
|
|
],
|
|
},
|
|
colorMode: {
|
|
// Nothing against dark mode, but our current CSS doesn't have high contrast
|
|
// so it needs some work before being enabled.
|
|
defaultMode: 'light',
|
|
disableSwitch: true,
|
|
},
|
|
footer: {
|
|
style: 'dark',
|
|
links: [
|
|
{
|
|
title: 'Learn',
|
|
items: [
|
|
{
|
|
label: 'Getting Started',
|
|
to: 'docs/getting-started/index',
|
|
},
|
|
{
|
|
label: 'Plugin Creation Tutorial',
|
|
to: 'docs/tutorial/intro',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: 'Plugins',
|
|
items: [
|
|
{
|
|
label: 'Core Plugins',
|
|
to: 'docs/features/index',
|
|
},
|
|
{
|
|
label: 'Community Plugins',
|
|
href: 'https://www.npmjs.com/search?q=keywords:flipper-plugin',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: 'Legal',
|
|
// Please do not remove the privacy and terms, it's a legal requirement.
|
|
items: [
|
|
{
|
|
label: 'Privacy',
|
|
href: 'https://opensource.facebook.com/legal/privacy/',
|
|
},
|
|
{
|
|
label: 'Terms',
|
|
href: 'https://opensource.facebook.com/legal/terms/',
|
|
},
|
|
],
|
|
},
|
|
{
|
|
title: 'More',
|
|
items: [
|
|
{
|
|
label: 'Twitter',
|
|
href: 'https://twitter.com/flipper_fb',
|
|
},
|
|
{
|
|
label: 'GitHub',
|
|
href: repoUrl,
|
|
},
|
|
],
|
|
},
|
|
],
|
|
copyright: 'Copyright © ' + new Date().getFullYear() + ' Facebook',
|
|
logo: {
|
|
alt: 'Flipper Mascot',
|
|
src: 'img/mascot.png',
|
|
},
|
|
},
|
|
algolia: fbContent({
|
|
internal: undefined,
|
|
external: {
|
|
apiKey: '2df980e7ffc95c19552790f7cad32666',
|
|
indexName: 'fbflipper',
|
|
algoliaOptions: {
|
|
hitsPerPage: 5,
|
|
},
|
|
},
|
|
}),
|
|
prism: {
|
|
additionalLanguages: ['groovy', 'java', 'kotlin', 'ruby', 'swift'],
|
|
},
|
|
},
|
|
favicon: 'img/icon.png',
|
|
scripts: [
|
|
'https://buttons.github.io/buttons.js',
|
|
'https://cdnjs.cloudflare.com/ajax/libs/clipboard.js/2.0.0/clipboard.min.js',
|
|
'/js/code-blocks-buttons.js',
|
|
'/js/google-analytics.js',
|
|
],
|
|
stylesheets: [],
|
|
// start_config_example
|
|
presets: [
|
|
[
|
|
require.resolve('docusaurus-plugin-internaldocs-fb/docusaurus-preset'),
|
|
{
|
|
docs: {
|
|
path: '../docs',
|
|
sidebarPath: require.resolve('./sidebars.js'),
|
|
editUrl: 'https://github.com/facebook/flipper/blob/master/website',
|
|
},
|
|
theme: {
|
|
customCss: require.resolve('./static/css/custom.css'),
|
|
},
|
|
},
|
|
],
|
|
],
|
|
// end_config_example
|
|
};
|
|
|
|
module.exports = siteConfig;
|