Commit Graph

262 Commits

Author SHA1 Message Date
Joel Marcey c888bc52b9 Fix og:image URL to make it absolute 2017-12-14 09:53:37 -08:00
Joel Marcey 606029b9ff Fix prettier 2017-12-14 09:38:32 -08:00
Joel Marcey d6fb14cfa4
Add introductory blog post (#279)
* Add introductory blog post

For launch!

\o/

* Update post to launch date

* Add ogImage and fix how we get og:Description

Plus a few updates to the post

* Remove some code block info
2017-12-14 09:32:49 -08:00
Joel Marcey 3404b40096 Fix example website output path when copying examples 2017-12-14 09:13:21 -08:00
Joel Marcey 8481791221 Update the Docusaurus help page 2017-12-13 15:26:24 -08:00
Jan Kassens d97e2e9d81 Add newlines at end of generated files (#283) 2017-12-13 13:55:40 -08:00
Joel Marcey ecf62f80b7 Add notification that a site was built successfully
after running `npm run build`
2017-12-12 14:15:14 -08:00
Hector Ramos a7d81c629d Resolve conflicts 2017-12-12 12:49:02 -08:00
Jan Kassens b174ee2d2a Update prettier to 1.9.1 (#273) 2017-12-12 12:47:52 -08:00
Ricky Vetter c22203523f use faded primaryColor background for inline code snippets instead of link color (#276) 2017-12-12 12:46:52 -08:00
Hector Ramos ca97030005 Remove git commit status code check 2017-12-12 12:40:26 -08:00
Joel Marcey 46943906ce Fix Prettier 2017-12-12 10:18:29 -08:00
Héctor Ramos cf89dacaf6 Guard against errors during the deploy step, and install rsync (#277) 2017-12-12 10:16:26 -08:00
Joel Marcey ea5a11bcd0 Redux - Use rsync instead of copy when preparing files to publish
Realized that rsync was installed on our Circle docker image, so that
broke everything
2017-12-12 10:14:43 -08:00
Joel Marcey 3c6bc0c5de Revert using rsync
For some reason everything broke
2017-12-12 09:01:34 -08:00
Joel Marcey ae872e7ee9 Prettier fix 2017-12-12 08:54:44 -08:00
Joel Marcey b3c44060b9 Use rsync instead of copy when preparing files to publish
`shell.cp` does not support dotfiles :(

https://github.com/shelljs/shelljs/issues/79
2017-12-12 08:51:29 -08:00
Joel Marcey c9e4f4479d Prettier fix 2017-12-11 16:41:09 -08:00
Héctor Ramos 11029cf02d Update build script (#272)
* Copy dot files if present in the static folder, and add .circleci config to Docusaurus site

* Update docs
2017-12-11 16:32:05 -08:00
Héctor Ramos ad87bab09b Fix path to docs assets dir (#265) 2017-12-07 10:14:32 -08:00
Joel Marcey d89abde579 Update publish-gh.js after running Prettier 2017-12-05 21:32:36 -08:00
Ricky Vetter 8074b96c79 allow copy from /build in github.io case (#260)
* allow copy from /build in github.io case

* Comment explaining the ! in the path.join
2017-12-05 20:59:11 -08:00
Héctor Ramos 97612cf20b Link to master version of doc when editing (#262)
* Ensure Edit this Doc links always point to the master source of truth, and not a particular version

* Only show Edit this Doc link if editUrl has been set
2017-12-05 15:44:14 -08:00
Héctor Ramos 80fc8169b7 Fix background css (#261) 2017-12-05 13:35:15 -08:00
Héctor Ramos 65421db62e Add Prettier Formatting (#258)
* Add Prettier formatting to source files and example files, and check that Prettier formatting is maintained on PRs

* Remove trailing-comma as we are using Node 6 on Circle

* Use latest Node 6 LTS version in Circle

* Remove unused test
2017-12-04 19:21:02 -08:00
Ricky Vetter 0cead4b6f9 Update deployment script to work on github.io repos as well (#256)
* Update deployment script to work on github.io repos as well

* remember how index of works

* CURRENT_BRANCH
2017-12-04 09:59:49 -08:00
Cheng Lou 76e423fba3 Use `path` module instead of string concat `/` (#255)
This also in part prepares for #253. I discovered a bug when setting `projectName` to `""`, and some `"build/" + projectName + "/foo"` concatenated into `"build//foo"`. Granted, it's a hack, but we should use `path` anyway.

Test: tested on https://github.com/BuckleScript/bucklescript.github.io. Seems working
2017-12-04 09:32:02 -08:00
Héctor Ramos df05fd2bbc Switch Algolia DocSearch to load using https (#252)
* Change docsearch to explicit https
2017-12-04 09:26:44 -08:00
Héctor Ramos 31b70f053c Update docusaurus-publish (#250)
* Update publish script to allow configuration via siteConfig.js file, as well as non-CircleCI env vars

* Use || instead of |
2017-12-04 09:15:32 -08:00
Héctor Ramos bb48bb4f0c Remove keys warning when loading scripts (#244) 2017-11-27 15:14:55 -08:00
Héctor Ramos 1efce743dd Provide additional debugging information (#241) 2017-11-26 21:59:28 -08:00
Héctor Ramos ff5f6b578d Reduce init script verbosity. (#239) 2017-11-21 09:44:45 -08:00
Joel Marcey 16aa42a705 Allow deploying docs from a branch other than `master`
Still have to deploy to `gh-pages`
2017-11-17 14:26:08 -08:00
Ricky Vetter 71dec39c3b Change pointer events on language dropdown (#233)
The dropdown positioning makes it overlay the main menu on mobile layout. This means that clicking the language button a second time doesn't close the menu.
2017-11-16 09:23:54 -08:00
Héctor Ramos 09726c6361 [Versioning] Fix issue when a doc is added (#231)
* Simplify function, return error if doc not found
2017-11-15 15:55:08 -08:00
Héctor Ramos 420d2e86fb Replace diff with string comparison (#230) 2017-11-15 12:17:05 -08:00
Héctor Ramos 19e6cc7ecc Check whether a previous/next doc actually exists (#226)
* Check whether a previous/next doc actually exists

* Use reasonable defaults

* Remove extraneous space
2017-11-14 20:36:25 -08:00
Christopher Chedeau c407cdf96f Enable stylesheets as a parallel to scripts (#225)
* Enable stylesheets as a parallel to scripts

Also moves the scripts above the custom stylesheet to follow the comment :)

* Update api-site-config.md
2017-11-13 17:54:24 -08:00
Eric Nakagawa 8d14f8fb02
Merge pull request #217 from JoelMarcey/custom-docs-subdir
Allow custom path for the location of documentation
2017-11-13 13:50:39 -08:00
Christine Abernathy 1d3f71a60a Fix HTML copy file generation (#223) 2017-11-10 15:46:22 -08:00
Joel Marcey e273dfc13b Allow the docs not to just be in a folder called `docs`
Also:
- regex escaping
- update api documentation
2017-11-09 09:55:26 -08:00
Joel Marcey dc0c1390c4 [WIP] Allow custom subpath for docs within the "docs" folder
e.g.,

The default is

`docs/*.md`

This allows

`docs/somedir/*.md`

or

`docs/somedir/anotherdir/*.md`

Notes:

- All URLs are still /docs/*.html (i.e. the subpath does not get preserved in the link).
- Files in `translated_docs`, if any, will still only be one level
- This should not affect translations or versioning
2017-11-08 20:16:05 -08:00
Christopher Chedeau f19bd80d80 Center iframes and make them responsive (#209)
So if you add an image and an iframe (youtube embed), they behave the same at all resolutions.
2017-11-01 13:40:11 -07:00
Christopher Chedeau d5f26a52d4 Add the ability to render html and linkify links (#208)
Marked had the ability to display html code. This is useful if you want to embed iframes, set size to images... This allows arbitrary html to be embedded with no sanitization, so `<script>alert()</script>` will be executed. This isn't such a big issue since the markdown is written only by contributors.

I also removed the componentWillUpdate call since it's not used (and wrong).
2017-11-01 13:40:00 -07:00
Christopher Chedeau e9c5cef664 Add the ability to define a default language (#206)
* Add the ability to define a default language

I don't want to have to add the language i'm working on to every single block nor do I want to rely on a default heuristic to find the language.

This adds the ability to write

```
highlight: { defaultLang: 'xxxx' }
```

in `siteConfig.js` to force the language when not specified.

I tested it without a a highlight block, without a defaultLang attribute and with one and with a wrong one. All of them work as expected.

* Move comment around
2017-11-01 12:16:15 -07:00
Joel Marcey b2de777b1e
Add docusaurus-init to the headerlink message (#202) 2017-10-31 09:20:23 -07:00
Ricky Vetter 1ba37f857c More breakpoint consolidation fixes 2017-10-30 22:50:51 -07:00
Ricky Vetter b59b58af0d
Consolidate break points
These 900 break points were always triggered with the mobile nav. They don't make sense with the desktop navigation. See photo.
2017-10-30 22:37:07 -07:00
Héctor Ramos 09354ab738 [BREAKING] Rename Marked to MarkdownBlock (#162)
* Switch to Remarkable

* Clean up references to custom code blocks

* Remove valdiateDOMNesting warning

* Add syntax highlighting

* Add Reason support

* Breaking change: prismColor to codeColor, remove CompLibrary.Prism, expose hljs

* Completely remove Prism and associated CSS rules

* Support loading plugins and scripts

* Remove CSS rules, allowing Highlight.js theme to be used entirely

* Remove unnecessary webplayer script

* Rename Marked to MarkdownBlock

* Rename Marked to MarkdownBlock

* Remove Marked.js
2017-10-30 15:47:13 -07:00
Joel Marcey d26d263bd0
Don't try to version files that have no metadata headers (#197) 2017-10-30 12:00:55 -07:00