# discourse-codebytes-plugin
**Repository Path**: mirrors_discourse/discourse-codebytes-plugin
## Basic Information
- **Project Name**: discourse-codebytes-plugin
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-21
- **Last Updated**: 2026-08-01
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
CodeBytes Discourse Plugin
- [Description](#description)
- [Setup](#setup)
- [Usage](#usage)
- [Developer Guide](#developer-guide)
## Description
## Setup
1. Install the plugin according to this tutorial: https://meta.discourse.org/t/install-a-plugin/19157
2. In admin settings, check that "code bytes enabled" is checked 
That's it!
## Usage
### Add a CodeByte to a post
#### Using the toolbar button
1. Click the "Create a Codebyte" button in the editor toolbar to insert a new, empty codebyte. 
2. The CodeByte editor will appear in the preview pane. Select the language you would like to use. This will automatically be saved to the markdown editor. 
3. You can type your code in the CodeByte editor itself. This allows you to execute your code as you go along, as well as take advantage of features such as autocomplete and syntax highlighting. The code will be auto-saved to markdown after a few seconds of inactivity. You can also click the "Save to post" button to manually save the contents of the CodeByte to markdown. 
#### Using markdown
1. If you prefer not to use the editor in the preview pane, you can use markdown directly to create a CodeByte using the [codebyte] tag.
2. Add a `language` attribute to the opening tag, e.g. [codebyte language=python]. The currently supported options are `cpp` (C++), `csharp`, `golang`, `javascript`, `php`, `python`, `ruby`.
3. Type your code in between the opening and closing tags.
4. The opening and closing tags must each be be on their own line with no other text,
## Developer Guide
1. First, set up a local Discourse development environment. See the guide here: https://meta.discourse.org/t/how-do-i-set-up-a-local-discourse-development-environment/182882
2. Clone this repository:
```sh
git clone git@github.com:codecademy/discourse-codebytes-plugin.git
```
3. Create a symlink between the CodeBytes plugin code and your Discourse plugin folder. From within your Discourse directory, run:
```sh
cd plugins
ln -s
```
You will have to determine your ``. If your discourse-code-bytes-plugin directory is at your root, this will be `~/discourse-codebytes-plugin`
4. Run Discourse. From within your Discourse directory, run:
```sh
bundle exec rails server
```
You should now be able to run Discourse at http://localhost:3000/. Log-in with your admin account.
5. Create a new post. You should see the "Create a Codebyte" button in the editor toolbar.
### Testing
Acceptance tests are run by qunit from the discourse root and are located in `test/javascripts/acceptance`. Because discourse does not support unit testing for plugins, we have a separate suite of jest tests located in `test/javascripts/unit`. In order for these tests to coexist the naming conventions are slightly different:
- for unit tests: `*.test.js`
- for acceptance tests: `*-test.js`
unit tests can be run via `pnpm test`. The easiest way to run acceptance tests is to run the discourse server and go to http://localhost:3000/qunit?module=Acceptance%3A%20CodeBytes in your web browser
### Further Resources
- [Beginner's Guide to Creating Discourse Plugins](https://meta.discourse.org/t/beginners-guide-to-creating-discourse-plugins-part-1/30515)