Mva-meldingen

Please note: Before updating the documentation, ensure that you have committed the changes to the master branch and executed the deployment commands. Be aware that deployment may take a few minutes, during which time you may encounter a 404 error when accessing the pages.

If you are visiting this github project in order to manually test a submission of the VAT-report with the Python script, please visit http://skatteetaten.github.io/mva-meldingen/test_with_python_script/

This is the github project for the documentation "System submission of VAT-report". Please visit the documentation at http://skatteetaten.github.io/mva-meldingen/

How to update the "System submission of VAT-report" documentation

This documentation is generated using the Gatsby framework (https://www.gatsbyjs.com/)

Initial setup

Getting the gatsby-starter-skatteetaten module (TODO: Add more docs)

git submodule init
git submodule update

How to build

The project is built using npm from the current Node LTS. Install with nvm;

nvm install --lts

Then run

npm install

to install the dependencies.

npm start

will start a local web server and continuously build the documentation as you make changes.

Deploy

npm run build
npm run deploy

In order to log into GitHub, you need to have a Personal Access Token with the repo scope.
You can create a personal access token by following these steps:

1. Go to: https://github.com/settings/tokens
2. Choose "Classic token"
3. Click Generate new token
4. Give it a name and set how long it should be valid (e.g., 30 or 90 days)
5. Select the repo scope
6. Click Generate token
7. Copy the token immediately – it will only be shown once

When you run the command "npm run deploy":

1. Username: Your GitHub username
2. Password: Paste the token

Q&A

If you get the following error,

ERROR #11329
error:0308010C:digital envelope routines::unsupported

run this configuration setting in your terminal:

export NODE_OPTIONS=--openssl-legacy-provider

If you get the following error,

 ERROR #98123  WEBPACK
 Generating JavaScript bundles failed
 mva-meldingen-dokumentasjon/src/components/Layout/layout.jsx: It's not possible to compile spread arguments in `super()` without
 compiling classes.
 Please add '@babel/plugin-transform-classes' to your Babel configuration. (This is an error on an internal node. Probably an internal error.)

run this in your terminal:

npm install --save-dev @babel/plugin-transform-classes
npm install gatsby@^2.25.0