kotlin-patterns
1.0.0
1.0.0
  • Getting Started
  • Contributing
    • Contributing
  • User Guide
    • Upgrading
    • Troubleshooting
    • Getting Started
    • FAQ
    • Changelog
    • Code Owners
    • Code of Conduct
    • Dependency Management
  • Links
    • Resources
  • Units
    • Data Types
    • Scenarios
    • Use Cases
    • Design Patterns
Powered by GitBook
On this page
  • Filing Bugs & Troubleshooting
  • Step 1: Attempt To Upgrade fastpages
  • Step 2: Search Relevant Places For Similar Issues
  • Step 3: Observe Build Logs When Developing Locally
  • Step 4: See if there are errors in the build process of GitHub Actions.
  • Step 5: Once you have performed all the above steps, post your issue in the fastai forums or a GitHub Issue.
  • Frequent Errors

Was this helpful?

  1. User Guide

Troubleshooting

PreviousUpgradingNextGetting Started

Last updated 3 years ago

Was this helpful?

Filing Bugs & Troubleshooting

These are required prerequisites before filing an issue on GitHub

Step 1: Attempt To Upgrade fastpages

See the .

In addition to upgrading, if developing locally, refresh your Docker containers with the following commands from the root of your repo:

make remove followed by make build

Step 2: Search Relevant Places For Similar Issues

  • [ ] Search issues on the for a similar problems?

  • [ ] Read the carefully

Step 3: Observe Build Logs When Developing Locally

  • [ ] Run the

    • Pay attention to the emitted logs when you save your notebooks or files. Often, you will see errors here that will give you important clues.

  • [ ] When developing locally, you will notice that Jupyter notebooks are converted to corresponding Markdown files in the _posts folder. Take a look at the problematic blog posts and see if you can spot the offending HTML or Markdown in that code.

  • Use your browser's developer tools to see if there are any errors. Common errors are (1) not able to find images because they have not been saved into the right folder, (2) JavaScript or other errors.

  • If you receive a Jekyll build error or a Liquid error, search for this error on Stack Overflow to provide more insight on the problem.

Step 4: See if there are errors in the build process of GitHub Actions.

  • [ ] In your GitHub repository, you will have a tab called Actions. To find build errors, click on the Event dropdown list and select push. Browse through the logs to see if you can find an error. If you receive an error, read the error message and try to debug.

Step 5: Once you have performed all the above steps, post your issue in the fastai forums or a GitHub Issue.

  • [ ] If you cannot find a similar issue create a new thread instead of commenting on an unrelated one.

  • When reporting a bug, provide this information:

    1. Steps to reproduce the problem

    2. A link to the notebook or Markdown file where the error is occurring

    3. If the error is happening in GitHub Actions, a link to the specific error along with how you are able to reproduce this error. You must provide this in addition to the link to the notebook or Markdown file.

You must provide ALL of the above information.

Frequent Errors

  1. Malformed front matter. Note that anything defined in front matter must be valid YAML. Failure to provide valid YAML could result in your page not rendering in your blog. For example, if you want a colon in your title you must escape it with double quotes like this:

    - title: "Deep learning: A tutorial"

    Or in a notebook

    # "Deep learning: A tutorial"

    Colons, tilda, asterisks and other characters may cause your front matter to break and for your posts to not render. If you violoate these conventions you often get an error that looks something like this:

     Error: YAML Exception reading ... (<unknown>): mapping values are not allowed

A screenshot / dump of relevant logs or error messages you are receiving from your local development environment. The local development server as indicated in the .

See this for more information.

Can you customize the styling or theme? A: See

See the for frequently asked questions.

Upgrading guide
repository
README
fastpages blog server locally
development guide
tutorial on YAML
Customizing
FAQ