404
63 |We’re sorry, but the page you were looking for can’t be found.
64 |This issue has been automatically logged.
65 | 69 |{this.props.children}
17 | ); 18 | } 19 | } 20 | 21 | export default Paragraph; 22 | -------------------------------------------------------------------------------- /src/components/atoms/Image/index.js: -------------------------------------------------------------------------------- 1 | import classNames from 'classnames'; 2 | import PropTypes from 'prop-types'; 3 | import React from 'react'; 4 | 5 | class Image extends React.PureComponent { 6 | static propTypes = { 7 | id: PropTypes.string, 8 | src: PropTypes.string.isRequired, 9 | alt: PropTypes.string.isRequired, 10 | className: PropTypes.string, 11 | }; 12 | 13 | render() { 14 | return ( 15 |
18 | {this.props.children}
19 |
20 | );
21 | }
22 | }
23 |
24 | export default MapMarker;
25 |
--------------------------------------------------------------------------------
/src/components/atoms/HorizontalRule/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | // 21 | ); 22 | } 23 | } 24 | 25 | export default HorizontalRule; 26 | -------------------------------------------------------------------------------- /api/README.md: -------------------------------------------------------------------------------- 1 | # Documentation API 2 | 3 | This package facilitates all the services required by `documentation` Web UI. 4 | 5 | It is a set of services running on NodeJS connecting to AWS DynamoDB. 6 | 7 | ## Prerequisites 8 | 9 | ```shell 10 | npm install 11 | ``` 12 | 13 | ## Development 14 | 15 | You will need to create a `./src/data/config.dev.json` file based on the `./src/data.config.template.json`, see the [DEPLOYMENT.md](./DEPLOYMENT.md) for more details. 16 | 17 | By running the following command the web API will be available at
(this.parallaxEl = el)}>
22 | {this.props.children}
23 |
24 | );
25 | }
26 | }
27 |
28 | export default ParallaxContainer;
29 |
--------------------------------------------------------------------------------
/src/components/atoms/Text/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import React from 'react';
3 | import PropTypes from 'prop-types';
4 |
5 | class Text extends React.PureComponent {
6 | static propTypes = {
7 | children: PropTypes.oneOfType([
8 | PropTypes.arrayOf(PropTypes.node),
9 | PropTypes.node
10 | ]),
11 | className: PropTypes.string,
12 | html: PropTypes.bool,
13 | };
14 |
15 | render() {
16 | if (this.props.html) {
17 | return ;
18 | }
19 |
20 | return ({this.props.children});
21 | }
22 | }
23 |
24 | export default Text;
25 |
--------------------------------------------------------------------------------
/src/utils/homeDataPropTypes.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 |
3 | const HomeDataPropTypes = PropTypes.shape({
4 | headerTopLinks: PropTypes.arrayOf(
5 | PropTypes.shape({
6 | href: PropTypes.string.isRequired,
7 | name: PropTypes.string.isRequired
8 | })
9 | ).isRequired,
10 | popularTopics: PropTypes.arrayOf(
11 | PropTypes.shape({
12 | query: PropTypes.string.isRequired,
13 | name: PropTypes.string.isRequired
14 | })
15 | ),
16 | cards: PropTypes.arrayOf(
17 | PropTypes.shape({
18 | href: PropTypes.string.isRequired,
19 | image: PropTypes.string.isRequired,
20 | name: PropTypes.string.isRequired
21 | })
22 | ).isRequired
23 | });
24 |
25 | export default HomeDataPropTypes;
--------------------------------------------------------------------------------
/src/components/molecules/Feedback/FeedbackOverlay.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | class FeedbackOverlay extends React.Component {
6 | static propTypes = {
7 | isExpanded: PropTypes.bool,
8 | children: PropTypes.oneOfType([
9 | PropTypes.arrayOf(PropTypes.node),
10 | PropTypes.node
11 | ])
12 | };
13 |
14 | render() {
15 | return (
16 |
22 | {this.props.children}
23 |
24 | );
25 | }
26 | }
27 | export default FeedbackOverlay;
28 |
--------------------------------------------------------------------------------
/src/components/molecules/HomePageCard/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import Card from './Card';
4 |
5 | class CardContainer extends React.PureComponent {
6 | static propTypes = {
7 | content: PropTypes.arrayOf(PropTypes.shape({
8 | image: PropTypes.string.isRequired,
9 | href: PropTypes.string.isRequired,
10 | name: PropTypes.string,
11 | })).isRequired
12 | };
13 |
14 | render() {
15 | return (
16 |
17 | {
18 | this.props.content.map((card) =>
19 |
23 | );
24 | }
25 | }
26 |
27 | export default CardContainer;
28 |
--------------------------------------------------------------------------------
/src/components/atoms/Label/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | class Label extends React.PureComponent {
6 | static propTypes = {
7 | id: PropTypes.string,
8 | text: PropTypes.node,
9 | className: PropTypes.string,
10 | children: PropTypes.oneOfType([
11 | PropTypes.arrayOf(PropTypes.node),
12 | PropTypes.node
13 | ])
14 | };
15 |
16 | render() {
17 | if (this.props.text) {
18 | return (
19 |
22 | );
23 | }
24 | return null;
25 | }
26 | }
27 |
28 | export default Label;
29 |
--------------------------------------------------------------------------------
/src/index.js:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import ReactDOM from 'react-dom';
3 | import { AppContainer } from 'react-hot-loader';
4 |
5 | // Your top level component
6 | import App from './App';
7 |
8 | // Export your top level component as JSX (for static rendering)
9 | export default App;
10 |
11 | // Render your app
12 | if (typeof document !== 'undefined') {
13 | const target = document.getElementById('root');
14 |
15 | const renderMethod = target.hasChildNodes()
16 | ? ReactDOM.hydrate
17 | : ReactDOM.render;
18 |
19 | const render = Comp => {
20 | renderMethod(
21 |
25 | {this.props.children}
26 |
27 | );
28 | }
29 | }
30 |
31 | export default HeadingLabel;
32 |
--------------------------------------------------------------------------------
/src/components/atoms/Heading/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | class Heading extends React.PureComponent {
6 | static propTypes = {
7 | level: PropTypes.number,
8 | children: PropTypes.oneOfType([
9 | PropTypes.arrayOf(PropTypes.node),
10 | PropTypes.node
11 | ]),
12 | text: PropTypes.string,
13 | className: PropTypes.string,
14 | id: PropTypes.string
15 | };
16 |
17 | static defaultProps = {
18 | level: 1
19 | };
20 |
21 | render() {
22 | return React.createElement(
23 | `h${this.props.level}`,
24 | {
25 | className: classNames('heading', this.props.className),
26 | id: this.props.id
27 | },
28 | this.props.children || this.props.text
29 | );
30 | }
31 | }
32 |
33 | export default Heading;
34 |
--------------------------------------------------------------------------------
/src/utils/search.js:
--------------------------------------------------------------------------------
1 | import qs from 'qs';
2 |
3 | const QUERY_PARAM_NAME = 'q';
4 | const QUERY_PARAM_HIGHLIGHTS = 'highlights';
5 |
6 | export const performSearch = (history, query) => {
7 | history.push(`/search?${constructSearchQuery(query)}`);
8 | };
9 |
10 | export const constructSearchQuery = (query) => {
11 | return `${QUERY_PARAM_NAME}=${query.trim()}`;
12 | };
13 |
14 | export const extractSearchQuery = (location) => {
15 | const params = qs.parse(location.search, { ignoreQueryPrefix: true });
16 | return params && params[QUERY_PARAM_NAME] ? params[QUERY_PARAM_NAME] : '';
17 | };
18 |
19 | export const constructHighlights = (highlights) => {
20 | return `${QUERY_PARAM_HIGHLIGHTS}=${highlights.join(';')}`;
21 | };
22 |
23 | export const extractHighlights = (location) => {
24 | const params = qs.parse(location.search, { ignoreQueryPrefix: true });
25 | return params && params[QUERY_PARAM_HIGHLIGHTS] ? params[QUERY_PARAM_HIGHLIGHTS].split(';') : [];
26 | };
27 |
--------------------------------------------------------------------------------
/src/components/molecules/EmailSignup/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import Heading from '../../atoms/Heading';
4 | import Paragraph from '../../atoms/Paragraph';
5 | import './email.css';
6 | import InputRegister from './InputRegister';
7 |
8 | class EmailSignup extends React.PureComponent {
9 | static propTypes = {
10 | apiEndpoint: PropTypes.string.isRequired
11 | };
12 |
13 | render() {
14 | return (
16 |
22 |
17 | Get the latest IOTA development news straight to your mailbox
19 |
20 |
19 |
20 |
26 | );
27 | }
28 | }
29 |
30 | export default Card;
31 |
--------------------------------------------------------------------------------
/src/utils/clipboard.js:
--------------------------------------------------------------------------------
1 | export function copyToClipboard(text) {
2 | try {
3 | const textArea = document.createElement('textarea');
4 |
5 | // Prevent zooming on iOS
6 | textArea.style.fontSize = '12pt';
7 | // Reset box model
8 | textArea.style.border = '0';
9 | textArea.style.padding = '0';
10 | textArea.style.margin = '0';
11 | // Move element out of screen horizontally
12 | textArea.style.position = 'absolute';
13 | textArea.style.left = '-9999px';
14 | // Move element to the same position vertically
15 | const yPosition = window.pageYOffset || document.documentElement.scrollTop;
16 | textArea.style.top = `${yPosition}px`;
17 |
18 | textArea.setAttribute('readonly', '');
19 | textArea.value = text;
20 |
21 | document.body.appendChild(textArea);
22 |
23 | textArea.select();
24 | document.execCommand('Copy');
25 | textArea.remove();
26 |
27 | return true;
28 | } catch (err) {
29 | // Not much we can do
30 | return false;
31 | }
32 | }
33 |
--------------------------------------------------------------------------------
/src/components/atoms/Link/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import Text from '../Text';
5 |
6 | class Link extends React.PureComponent {
7 | static propTypes = {
8 | id: PropTypes.string,
9 | href: PropTypes.string,
10 | target: PropTypes.string,
11 | text: PropTypes.string,
12 | className: PropTypes.string,
13 | children: PropTypes.oneOfType([
14 | PropTypes.arrayOf(PropTypes.node),
15 | PropTypes.node
16 | ]),
17 | disabled: PropTypes.bool
18 | };
19 |
20 | render() {
21 | return (
28 | {this.props.children ||
22 | {this.props.card.name}
23 |
24 |
25 |
24 | {
25 | this.props.content.map((c, idx) =>
26 |
30 | );
31 | }
32 | }
33 |
34 | export default ProjectTopicsContainer;
35 |
--------------------------------------------------------------------------------
/src/components/atoms/Button/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | class Button extends React.PureComponent {
6 | static propTypes = {
7 | id: PropTypes.string,
8 | large: PropTypes.bool,
9 | small: PropTypes.bool,
10 | disabled: PropTypes.bool,
11 | className: PropTypes.string,
12 | onClick: PropTypes.func,
13 | children: PropTypes.oneOfType([
14 | PropTypes.arrayOf(PropTypes.node),
15 | PropTypes.node
16 | ]),
17 | };
18 |
19 | render() {
20 | return ();
35 | }
36 | }
37 |
38 | export default Button;
39 |
--------------------------------------------------------------------------------
/src/components/atoms/MarkdownCard/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import Link from '../Link';
4 |
5 | class MarkdownCard extends React.Component {
6 | static propTypes = {
7 | alt: PropTypes.string,
8 | img: PropTypes.string,
9 | title: PropTypes.string,
10 | link: PropTypes.string,
11 | children: PropTypes.oneOfType([
12 | PropTypes.arrayOf(PropTypes.node),
13 | PropTypes.node
14 | ]),
15 | id: PropTypes.string
16 | };
17 |
18 | render() {
19 | return (
20 |
21 |
31 | );
32 | }
33 | }
34 |
35 | export default MarkdownCard;
36 |
--------------------------------------------------------------------------------
/src/utils/foundationDataPropTypes.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 |
3 | const FoundationDataPropTypes = PropTypes.shape({
4 | footerSections: PropTypes.arrayOf(
5 | PropTypes.shape({
6 | label: PropTypes.string.isRequired,
7 | items: PropTypes.arrayOf(
8 | PropTypes.shape({
9 | label: PropTypes.string.isRequired,
10 | url: PropTypes.string.isRequired
11 | })
12 | ).isRequired
13 | })
14 | ),
15 | registeredAddress: PropTypes.shape({
16 | label: PropTypes.string.isRequired,
17 | value: PropTypes.arrayOf(PropTypes.string).isRequired
18 | }),
19 | visitingAddress: PropTypes.shape({
20 | label: PropTypes.string.isRequired,
21 | value: PropTypes.arrayOf(PropTypes.string).isRequired
22 | }),
23 | information: PropTypes.arrayOf(
24 | PropTypes.shape({
25 | label: PropTypes.string.isRequired,
26 | value: PropTypes.string,
27 | urls: PropTypes.arrayOf(
28 | PropTypes.shape({
29 | label: PropTypes.string.isRequired,
30 | url: PropTypes.string.isRequired
31 | })
32 | )
33 | })
34 | ),
35 | });
36 |
37 | export default FoundationDataPropTypes;
--------------------------------------------------------------------------------
/src/containers/Container.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import ReactRouterPropTypes from 'react-router-prop-types';
4 | import Disclaimer from '../components/atoms/Disclaimer';
5 | import Footer from '../components/organisms/Footer';
6 | import FoundationDataPropTypes from '../utils/foundationDataPropTypes';
7 | import ProjectsPropTypes from '../utils/projectsPropTypes';
8 |
9 | class Container extends React.PureComponent {
10 | static propTypes = {
11 | children: PropTypes.oneOfType([
12 | PropTypes.arrayOf(PropTypes.node),
13 | PropTypes.node
14 | ]),
15 | projects: ProjectsPropTypes.isRequired,
16 | history: ReactRouterPropTypes.history,
17 | location: ReactRouterPropTypes.location,
18 | foundationData: FoundationDataPropTypes.isRequired
19 | };
20 |
21 | render() {
22 | return (
23 |
22 |
23 | 
24 |
30 |
25 |
28 |
29 | {this.props.title}
26 | {this.props.children}
27 |
25 |
26 | {this.props.content.name}
27 |
28 |
29 | {this.props.content.description}
30 |
31 |
33 | );
34 | }
35 | }
36 |
37 | export default ProjectTopics;
38 |
--------------------------------------------------------------------------------
/DEPLOYMENT.md:
--------------------------------------------------------------------------------
1 | # Deployment
2 |
3 | ## Update Content
4 |
5 | Remove all the contents from the `./docs` folder.
6 |
7 | Get the latest content from the
35 | This website uses cookies to ensure you get the best experience.
36 | Learn more.
37 |
38 |
39 |
40 | );
41 | }
42 |
43 | /**
44 | * Dismiss the disclaimer.
45 | */
46 | dismiss() {
47 | const cookies = new Cookies();
48 | cookies.set('cookieAck', 'yes', { maxAge: 31536000, path: '/' });
49 | this.setState({ ackCookies: true });
50 | }
51 | }
52 |
53 | export default Disclaimer;
54 |
--------------------------------------------------------------------------------
/src/components/molecules/EmailSignup/email.css:
--------------------------------------------------------------------------------
1 | .email-signup {
2 | display: flex;
3 | justify-content: center;
4 | min-height: 160px;
5 | background-color: #f6f6f6;
6 | }
7 |
8 | .email-signup__wrapper {
9 | max-width: 1495px;
10 | width: 100%;
11 | display: flex;
12 | flex-direction: row;
13 | justify-content: space-between;
14 | }
15 |
16 | .email-signup__content {
17 | padding: 0 20px;
18 | }
19 |
20 | @media (min-width: 768px){
21 | .email-signup__content{
22 | padding: 0 40px;
23 | }
24 | }
25 |
26 |
27 | .email-signup__content h2 {
28 | margin: 37px 0 0;
29 | }
30 |
31 | .email-signup__content h2 .text {
32 | color: #20a49d;
33 | }
34 |
35 | .email-signup__content p {
36 | color: #1c1e21;
37 | font-size: 18px;
38 | font-weight: 300;
39 | line-height: 1.76;
40 | margin-top: 5px;
41 | }
42 |
43 | .input-register-container.input-register-container--hidden {
44 | display: none;
45 | }
46 |
47 | .input-register-container__wrapper {
48 | display: flex;
49 | flex-direction: column;
50 | }
51 |
52 | .input-register-container__form {
53 | display: flex;
54 | flex-direction: column;
55 | margin: 0px 16px 25px;
56 | justify-content: flex-start;
57 | }
58 |
59 | @media (min-width: 768px){
60 | .input-register-container__form{
61 | margin: 60px 40px 0px;
62 | }
63 | }
64 |
65 | .error-message {
66 | margin-top: 10px;
67 | color: red;
68 | }
69 |
70 | .success-message {
71 | color: green;
72 | }
73 |
74 | @media (max-width: 768px) {
75 | .email-signup {
76 | height: auto;
77 | }
78 |
79 | .email-signup__wrapper {
80 | flex-direction: column;
81 | justify-content: space-between;
82 | }
83 |
84 | .email-signup__content h2 {
85 | font-size: 24px;
86 | margin: 25px 0 0;
87 | }
88 | }
89 |
--------------------------------------------------------------------------------
/api/src/routes/searchQueryList.ts:
--------------------------------------------------------------------------------
1 | import { IDataResponse } from "../models/api/IDataResponse";
2 | import { ISearchQueryListRequest } from "../models/api/ISearchQueryListRequest";
3 | import { IConfiguration } from "../models/configuration/IConfiguration";
4 | import { SearchQueryService } from "../services/searchQueryService";
5 | import { ValidationHelper } from "../utils/validationHelper";
6 |
7 | /**
8 | * Generate a report of all the search queries.
9 | */
10 | export async function searchQueryList(config: IConfiguration, request: ISearchQueryListRequest): Promise| Query | Count | |
|---|---|---|
| ${item.query} | ${item.count} |
37 |
38 |
);
49 | }
50 | }
51 |
52 | export default MessageBox;
53 |
--------------------------------------------------------------------------------
/src/components/molecules/Feedback/FeedbackButton.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 |
5 | class FeedbackButton extends React.Component {
6 | static propTypes = {
7 | isExpanded: PropTypes.bool,
8 | wasItUseful: PropTypes.string,
9 | showButtonContent: PropTypes.bool,
10 | onClick: PropTypes.func
11 | };
12 |
13 | constructor(props) {
14 | super(props);
15 |
16 | this.handleOnClick = this.handleOnClick.bind(this);
17 | }
18 |
19 | handleOnClick(e) {
20 | const { onClick } = this.props;
21 | if (onClick) {
22 | onClick(e);
23 | }
24 | }
25 |
26 | render() {
27 | return (
28 |
39 | {this.props.title && (
40 |
48 | {this.props.title}
41 | )}
42 | {this.props.content && (
43 |
44 | {this.props.content}
45 |
46 | )}
47 |
35 |
52 |
53 | );
54 | }
55 | }
56 |
57 | export default FeedbackButton;
58 |
--------------------------------------------------------------------------------
/src/components/molecules/SearchResult/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import { Link } from 'react-router-dom';
4 | import { constructHighlights, constructSearchQuery } from '../../../utils/search';
5 |
6 | class SearchResult extends React.Component {
7 | static propTypes = {
8 | foundResult: PropTypes.arrayOf(
9 | PropTypes.shape({
10 | id: PropTypes.string,
11 | title: PropTypes.string,
12 | snippet: PropTypes.string,
13 | matches: PropTypes.arrayOf(PropTypes.string)
14 | })
15 | ),
16 | indexStart: PropTypes.number,
17 | indexEnd: PropTypes.number,
18 | query: PropTypes.string
19 | };
20 |
21 | constructor(props) {
22 | super(props);
23 | }
24 |
25 | render() {
26 | const res = this.props.foundResult.length > 0 ? `Showing results ${this.props.indexStart + 1} to ${this.props.indexEnd + 1}.` : '';
27 | return (
28 |
29 |
32 |
33 | )
38 | )}
39 |
40 | );
41 | }
42 | }
43 |
44 | export default SearchResult;
45 |
--------------------------------------------------------------------------------
/api/DEPLOYMENT.md:
--------------------------------------------------------------------------------
1 | # Deployment
2 |
3 | ## Configuration
4 |
5 | Copy the `./src/data/config.template.json` to `./src/data/config.local.json` and populate the fields.
6 |
7 | ```js
8 | {
9 | "dynamoDbConnection": {
10 | "region": "AWS-REGION", // AWS Region e.g. eu-central-1"
11 | "accessKeyId": "AWS-ACCESS-KEY-ID", // AWS Access Key e.g. AKIAI57SG4YC2ZUCSABC
12 | "secretAccessKey": "AWS-SECRET-ACCESS-KEY", // AWS Secret e.g. MUo72/UQWgL97QArGt9HVUA
13 | "dbTablePrefix": "DATABASE-TABLE-PREFIX" // Prefix for database table names e.g. docs-dev-
14 | },
15 | "search": {
16 | "endpoint": "SEARCH_ENDPOINT", // Solr endpoint e.g. http://solr-server:8983
17 | "core": "SEARCH_CORE", // Solr core name e.g. document-core-local
18 | "authorization": "SEARCH_AUTHORIZATION" // Solr basic auth base64(user:password)
19 | }
20 | }
21 | ```
22 |
23 | ## Build
24 |
25 | Build the application.
26 |
27 | ```shell
28 | npm run build
29 | ```
30 |
31 | ## Deploy
32 |
33 | The build is setup to use Zeit/now for hosting, to configure this for production modify `./now.json` to point at where it needs to be deployed to, and then execute.
34 |
35 | If you want to use a different name for the config file you can specify an environment variable of CONFIG_ID, e.g. set CONFIG_ID to dev will load `config.dev.json` instead.
36 |
37 | ```shell
38 | cd api
39 | now
40 | ```
41 |
42 | ## After Deployment
43 |
44 | You can check that the api deployment has succeeded by visiting the url of the endpoint e.g. {`${this.props.foundResult.length} documents found for "${this.props.query}". ${res}`}
30 | {this.props.foundResult.slice(this.props.indexStart, this.props.indexEnd + 1).map(elm =>
31 | ({elm.title}
34 | {`/${elm.id}`}
35 |
36 | {elm.snippet}
37 |
38 |
39 |
56 | );
57 | }
58 | }
59 |
60 | export default Select;
61 |
--------------------------------------------------------------------------------
/src/components/molecules/VersionPicker/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import './index.css';
5 |
6 | class VersionPicker extends React.Component {
7 | static propTypes = {
8 | versions: PropTypes.arrayOf(PropTypes.string).isRequired,
9 | currentVersion: PropTypes.string.isRequired,
10 | onChange: PropTypes.func.isRequired
11 | };
12 |
13 | constructor(props) {
14 | super(props);
15 | }
16 |
17 | render() {
18 | const { versions, currentVersion } = this.props;
19 | return versions.length > 1 ? (
40 |
54 |
55 |
20 |
) : null;
42 | }
43 | }
44 |
45 | export default VersionPicker;
46 |
--------------------------------------------------------------------------------
/src/utils/api.js:
--------------------------------------------------------------------------------
1 | async function sendRequest(apiEndpoint, endpoint, method, data) {
2 | const response = await fetch(`${apiEndpoint}/${endpoint}`, {
3 | method,
4 | headers: {
5 | 'Content-Type': 'application/json'
6 | },
7 | body: data ? JSON.stringify(data) : undefined
8 | });
9 | return response.ok ? response.json() : null;
10 | }
11 |
12 | export async function submitFeedback(apiEndpoint, document, data) {
13 | try {
14 | return sendRequest(apiEndpoint, 'feedback', 'POST', { document, wasItUseful: data.wasItUseful, comments: data.comments });
15 | } catch (err) {
16 | // eslint-disable-next-line no-console
17 | console.error(err);
18 |
19 | return {
20 | success: false,
21 | message: 'Failed to submit feedback.'
22 | };
23 | }
24 | }
25 |
26 | export async function submitMissing(apiEndpoint, document, fromDocument) {
27 | try {
28 | return sendRequest(apiEndpoint, 'missing', 'POST', { document, fromDocument });
29 | } catch (err) {
30 | // eslint-disable-next-line no-console
31 | console.error(err);
32 |
33 | return {
34 | success: false,
35 | message: 'Failed to submit missing.'
36 | };
37 | }
38 | }
39 |
40 | export async function submitEmail(apiEndpoint, email) {
41 | try {
42 | return sendRequest(apiEndpoint, 'email', 'POST', { email });
43 | } catch (err) {
44 | // eslint-disable-next-line no-console
45 | console.error(err);
46 |
47 | return {
48 | success: false,
49 | message: 'Failed to submit email.'
50 | };
51 | }
52 | }
53 |
54 | export async function search(apiEndpoint, query) {
55 | try {
56 | return sendRequest(apiEndpoint, `search/?query=${query}`, 'GET');
57 | } catch (err) {
58 | // eslint-disable-next-line no-console
59 | console.error(err);
60 |
61 | return {
62 | success: false,
63 | message: 'Failed to search.'
64 | };
65 | }
66 | }
67 |
--------------------------------------------------------------------------------
/src/components/molecules/Navigator/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import { getNextPage, getPreviousPage, parseProjectUrl } from '../../../utils/projects';
4 | import ProjectsPropTypes from '../../../utils/projectsPropTypes';
5 | import Link from '../../atoms/Link';
6 |
7 | class Navigator extends React.Component {
8 | static propTypes = {
9 | projects: ProjectsPropTypes,
10 | pathname: PropTypes.string
11 | };
12 |
13 | constructor(props) {
14 | super(props);
15 | this.state = {
16 | nextTitle: '',
17 | nextUrl: '',
18 | previousTitle: '',
19 | previousUrl: ''
20 | };
21 | }
22 |
23 | componentDidMount() {
24 | const projectUrlParts = parseProjectUrl(this.props.pathname);
25 | const nextIndexItem = getNextPage(projectUrlParts, this.props.projects);
26 | const previousIndexItem = getPreviousPage(projectUrlParts, this.props.projects);
27 |
28 | this.setState({
29 | nextTitle: nextIndexItem ? nextIndexItem.name.replace(/\//g, ' / ') : '',
30 | nextUrl: nextIndexItem ? nextIndexItem.link : '',
31 | previousTitle: previousIndexItem ? previousIndexItem.name.replace(/\//g, ' / ') : '',
32 | previousUrl: previousIndexItem ? previousIndexItem.link : ''
33 | });
34 | }
35 |
36 | render() {
37 | return (
21 |
22 |
41 |
23 |
30 | {`${
27 | currentVersion === versions[versions.length - 1] ? 'You are viewing the latest version of this documentation' : 'There are newer versions of this documentation available'}`
28 | }
29 |
31 |
40 |
32 |
38 |
39 | Prev
40 | {this.state.previousTitle}
41 |
42 |
43 | Next
44 | {this.state.nextTitle}
45 |
46 | | Date | Document | Useful? | Comments |
|---|---|---|---|
| ${new Date(item.timestamp).toDateString()} | ${item.document} | ${item.wasItUseful} | ${item.comments ? item.comments.replace(/<[^>]*>/g, "") : ""} |
39 |
56 |
40 |
43 | {this.props.currentName}
41 |
42 | -
44 | {this.props.items.map(item => (
45 |
- 49 | 50 | {item.name} 51 | 52 | 53 | ))} 54 |
-
49 | {
50 | [...Array(this.state.numberOfPages)].map((p, index) => (
51 |
- 57 | this.handleNext(index)}> 58 | {index + 1} 59 | 60 | 61 | )) 62 | } 63 |
| Date | Document | Referenced From |
|---|---|---|
| ${item.timestamp === 0 ? "" : new Date(item.timestamp).toDateString()} | ${item.document} | ${item.fromDocument} |
74 | {this.props.children}
75 |
76 | );
77 | }
78 | }
79 |
80 | export default BottomSticky;
81 |
--------------------------------------------------------------------------------
/src/components/molecules/FloatingMenu/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import { Link } from 'react-router-dom';
5 | import ContentMenuItemsPropTypes from '../../../utils/contentMenuItemsPropTypes';
6 |
7 | class FloatingMenu extends React.Component {
8 | static propTypes = {
9 | menuItems: ContentMenuItemsPropTypes.isRequired,
10 | highlightedItem: PropTypes.string
11 | };
12 |
13 | constructor(props) {
14 | super(props);
15 |
16 | this.state = {
17 | activeTarget: null
18 | };
19 | }
20 |
21 | componentDidMount() {
22 | this.handleScroll = this.handleScroll.bind(this);
23 |
24 | this.targets = this.props.menuItems.map(item => {
25 | const target = item.name.toLowerCase().replace(/ /g, '_');
26 | return document.getElementById(target);
27 | });
28 |
29 | document.addEventListener('scroll', this.handleScroll);
30 | window.addEventListener('resize', this.handleScroll);
31 |
32 | this.handleScroll();
33 | }
34 |
35 | componentWillUnmount() {
36 | document.removeEventListener('scroll', this.handleScroll);
37 | window.removeEventListener('resize', this.handleScroll);
38 | }
39 |
40 | handleScroll() {
41 | const threshold = window.innerHeight * 0.35;
42 |
43 | let activeTarget = null;
44 |
45 | this.targets.forEach(target => {
46 | const rect = target.getBoundingClientRect();
47 |
48 | if (rect.top < threshold && rect.bottom > 0) {
49 | activeTarget = target.id;
50 | }
51 | });
52 |
53 | if (activeTarget !== this.state.activeTarget) {
54 | this.setState({
55 | activeTarget
56 | });
57 | }
58 | }
59 |
60 | render() {
61 | return (-
62 | {
63 | this.props.menuItems.map((item) => (
64 |
- 72 | 73 | {item.name} 74 | 75 | 76 | )) 77 | } 78 |
27 | {
28 | this.props.content && this.props.content.map((item, idx) =>
29 |
60 | );
61 | }
62 | }
63 |
64 | export default ProjectTopicsInner;
65 |
--------------------------------------------------------------------------------
/src/components/atoms/ScrollInContainer.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import ReactDOM from 'react-dom';
4 | class ScrollInContainer extends React.Component {
5 | static defaultProps = {
6 | topOffset: 0,
7 | bottomOffset: 100
8 | };
9 |
10 | static propTypes = {
11 | children: PropTypes.oneOfType([
12 | PropTypes.arrayOf(PropTypes.node),
13 | PropTypes.node
14 | ]),
15 | topOffset: PropTypes.number,
16 | bottomOffset: PropTypes.number
17 | };
18 |
19 | componentDidMount() {
20 | this.handleScroll = this.handleScroll.bind(this);
21 | this.handleResize = this.handleResize.bind(this);
22 |
23 | document.addEventListener('scroll', this.handleScroll);
24 | window.addEventListener('resize', this.handleResize);
25 |
26 | this.handleScroll();
27 | }
28 |
29 | componentWillUnmount() {
30 | document.removeEventListener('scroll', this.handleScroll);
31 | window.removeEventListener('resize', this.handleResize);
32 | }
33 |
34 | handleResize() {
35 | this.handleScroll();
36 | }
37 |
38 | handleScroll() {
39 | const thisDom = ReactDOM.findDOMNode(this);
40 | const parentDom = thisDom.parentNode;
41 |
42 | const thisRect = thisDom.getBoundingClientRect();
43 | const parentRect = parentDom.getBoundingClientRect();
44 |
45 | const computedParent = getComputedStyle(parentDom);
46 |
47 | if (parentRect.top < 0) {
48 | let newRelativeTop = -parentRect.top + this.props.topOffset;
49 | if (this._lastRelativeTop === undefined) {
50 | this._lastRelativeTop = newRelativeTop;
51 | }
52 |
53 | let thisHeight = thisRect.height + this.props.bottomOffset;
54 |
55 | let fixBottom = false;
56 | if (thisHeight + this._lastRelativeTop >= parentRect.height) {
57 | fixBottom = true;
58 | }
59 |
60 | this._lastRelativeTop = Math.floor(newRelativeTop);
61 |
62 | if (fixBottom) {
63 | thisDom.style.top = `${parentRect.height - thisHeight}px`;
64 | thisDom.style.position = 'relative';
65 | thisDom.style.width = 'auto';
66 | } else {
67 | const parentTopPadding = parseInt(computedParent.paddingTop, 10);
68 | const parentLeftPadding = parseInt(computedParent.paddingLeft, 10);
69 | const parentRightPadding = parseInt(computedParent.paddingRight, 10);
70 |
71 | thisDom.style.top = `${parentTopPadding + this.props.topOffset}px`;
72 | thisDom.style.position = 'fixed';
73 | thisDom.style.width = `${parentRect.width - parentLeftPadding - parentRightPadding}px`;
74 | }
75 | } else {
76 | thisDom.style.top = `${this.props.topOffset}px`;
77 | thisDom.style.position = 'relative';
78 | thisDom.style.width = 'auto';
79 | }
80 | }
81 |
82 | render() {
83 | return (
84 |
30 | {item.link && (
31 |
32 |
40 | {item.name}
41 |
42 |
43 | )}
44 | {!item.link && (
45 |
53 | {item.name}
54 |
55 | )}
56 |
58 | )}
59 |
85 | {this.props.children}
86 |
87 | );
88 | }
89 | }
90 |
91 | export default ScrollInContainer;
92 |
--------------------------------------------------------------------------------
/src/components/molecules/EmailSignup/InputRegister.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import { submitEmail } from '../../../utils/api';
5 |
6 | class InputRegister extends React.Component {
7 | static propTypes = {
8 | apiEndpoint: PropTypes.string.isRequired
9 | };
10 |
11 | constructor(props) {
12 | super(props);
13 | this.state = {
14 | email: '',
15 | loading: false,
16 | success: false,
17 | apiMessage: null,
18 | error: null,
19 | diabled: false
20 | };
21 |
22 | this.handleInputChange = this.handleInputChange.bind(this);
23 | this.submit = this.submit.bind(this);
24 | }
25 |
26 | handleInputChange({ target }) {
27 | this.setState({ email: target.value, error: null });
28 | }
29 |
30 | async submit(e) {
31 | e.preventDefault();
32 |
33 | const { email } = this.state;
34 |
35 | if (!email || !this.validateEmail(email)) {
36 | this.setState({ error: 'Please provide a valid e-mail address.' });
37 | } else {
38 | this.setState({ loading: true }, async () => {
39 | const response = await submitEmail(this.props.apiEndpoint, email);
40 | this.setState({ success: response.success, loading: false, apiMessage: response.message });
41 | });
42 | }
43 | }
44 |
45 | validateEmail(email) {
46 | const regex = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
47 | return regex.test(String(email).toLowerCase());
48 | }
49 |
50 | render() {
51 | const { email, error, success, apiMessage, loading } = this.state;
52 | return (
53 |
54 |
80 |
81 | );
82 | }
83 | }
84 |
85 | export default InputRegister;
86 |
--------------------------------------------------------------------------------
/src/components/molecules/Tabs/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import { copyToClipboard } from '../../../utils/clipboard';
5 |
6 | class Tabs extends React.Component {
7 | static propTypes = {
8 | headers: PropTypes.arrayOf(PropTypes.string),
9 | contents: PropTypes.arrayOf(PropTypes.element)
10 | };
11 |
12 | constructor(props) {
13 | super(props);
14 |
15 | this.state = {
16 | selectedIndex: 0,
17 | copyActive: false,
18 | copySuccess: false
19 | };
20 |
21 | this.handleSelect = this.handleSelect.bind(this);
22 | this.handleCopy = this.handleCopy.bind(this);
23 | }
24 |
25 | handleSelect(idx) {
26 | this.setState({ selectedIndex: idx });
27 | }
28 |
29 | handleCopy() {
30 | const markdown = this.props.contents[this.state.selectedIndex].props.source;
31 |
32 | const success = copyToClipboard(markdown.replace(/```.*/g, '').trim());
33 |
34 | this.setState({
35 | copySuccess: success,
36 | copyActive: true
37 | });
38 |
39 | setTimeout(() => {
40 | this.setState({
41 | copyActive: false
42 | });
43 | }, 2000);
44 | }
45 |
46 | render() {
47 | return (
48 |
49 |
84 | );
85 | }
86 | }
87 |
88 | export default Tabs;
89 |
--------------------------------------------------------------------------------
/src/components/organisms/StickyHeader/index.js:
--------------------------------------------------------------------------------
1 | import classNames from 'classnames';
2 | import PropTypes from 'prop-types';
3 | import React from 'react';
4 | import { Link, withRouter } from 'react-router-dom';
5 | import ReactRouterPropTypes from 'react-router-prop-types';
6 | import logo from '../../../assets/Logo.svg';
7 | import { performSearch } from '../../../utils/search';
8 | import InputSearch from '../../molecules/InputSearch';
9 |
10 | class StickyHeader extends React.Component {
11 | static propTypes = {
12 | onBurgerClick: PropTypes.func,
13 | history: ReactRouterPropTypes.history
14 | };
15 |
16 | constructor(props) {
17 | super(props);
18 |
19 | this.state = {
20 | inputExpanded: false,
21 | searchResults: []
22 | };
23 |
24 | this.inputExpandHandler = this.inputExpandHandler.bind(this);
25 | this.handleKeyUp = this.handleKeyUp.bind(this);
26 | this.onSearch = this.onSearch.bind(this);
27 | this.handleBurgerClick = this.handleBurgerClick.bind(this);
28 | this.handleCloseClick = this.handleCloseClick.bind(this);
29 | }
30 |
31 | handleBurgerClick() {
32 | this.setState({ inputExpanded: false });
33 | if (this.props.onBurgerClick) {
34 | this.props.onBurgerClick();
35 | }
36 | }
37 |
38 | handleCloseClick() {
39 | this.setState({ inputExpanded: false });
40 | }
41 |
42 | onSearch(query) {
43 | performSearch(this.props.history, query);
44 | }
45 |
46 | handleKeyUp(e) {
47 | if (e.key === 'Escape') {
48 | this.setState({ inputExpanded: false });
49 | }
50 | }
51 |
52 | inputExpandHandler() {
53 | if (!this.state.inputExpanded) {
54 | this.setState({ inputExpanded: true });
55 | this.searchInput.focus();
56 | }
57 | }
58 |
59 | render() {
60 | return (
61 |
50 |
71 | -
51 | {this.props.headers.map((header, headerIdx) => (
52 |
- 57 | this.handleSelect(headerIdx)}>{header} 58 | 59 | )) 60 | } 61 |
63 | {this.state.copySuccess ? 'Copied' : 'Failed'}
68 |
69 |
70 |
72 | {this.props.contents.map((content, contentIdx) => (
73 |
83 |
78 | {content}
79 |
80 | ))
81 | }
82 |
66 |
89 |
72 | { this.searchInput = input; }}
74 | className="input-search-sticky"
75 | placeholder="Search for topics"
76 | onKeyUp={this.handleKeyUp}
77 | onSearch={this.onSearch}
78 | />
79 |
83 |
84 |
88 |
41 |
45 |
);
88 | }
89 | }
90 |
91 | export default EventCard;
92 |
--------------------------------------------------------------------------------
/public/assets/document.svg:
--------------------------------------------------------------------------------
1 |
--------------------------------------------------------------------------------
/src/utils/foundationDataHelper.jsx:
--------------------------------------------------------------------------------
1 | import React from 'react';
2 | import { Link } from 'react-router-dom';
3 |
4 | /**
5 | * Class to help with foundation data.
6 | */
7 | export class FoundationDataHelper {
8 | /**
9 | * The location of the foundation data.
10 | */
11 | FOUNDATION_DATA_URL = 'https://webassets.iota.org/data/foundation.json';
12 |
13 | /**
14 | * Cached version of the data.
15 | */
16 | static _foundationData;
17 |
18 | /**
19 | * Load the found data.
20 | * @returns The loaded foundation data.
21 | */
22 | static async loadData() {
23 | if (!FoundationDataHelper._foundationData) {
24 | try {
25 | const foundationDataResponse = await fetch(FoundationDataHelper.FOUNDATION_DATA_URL);
26 | FoundationDataHelper._foundationData = await foundationDataResponse.json();
27 | } catch (err) {
28 | console.error(`Failed loading foundation data from ${FoundationDataHelper.FOUNDATION_DATA_URL}`);
29 | }
30 | }
31 |
32 | return FoundationDataHelper._foundationData;
33 | }
34 |
35 | /**
36 | * Create the display for a value.
37 | * @param info The information to display.
38 | * @param key The key of the item.
39 | * @returns The element to display.
40 | */
41 | static createValue(info, key) {
42 | // tslint:disable: react-no-dangerous-html
43 | return (
44 | {this.props.item.title}
42 |{moment(this.props.item.startUtc).format('MMMM Do YYYY, h:mm a')}
43 | {this.props.item.description}
44 | 45 |
46 | {this.props.item.venueName && (
47 |
53 | {this.props.item.venueName}
48 | )}
49 | {this.props.item.venueAddress && this.props.item.venueAddress.map((a, idx) => (
50 | {a}
51 | ))}
52 |
54 | More Details
55 |
56 | {this.props.item.venueLatitude && this.props.item.venueLongitude && (
57 |
58 | this.setState({ showMap: !this.state.showMap })}
61 | role="button"
62 | >{this.state.showMap ? 'Hide Map' : 'Show Map'}
63 |
64 |
65 |
86 | )}
87 |
71 |
79 |
80 | 
81 | {this.props.item.venueName}
82 |
83 |
84 |
85 | | {header.content} | 66 | ))} 67 ||
|---|---|
| {rowItem.content} | 82 | )} 83 | {!rowItem.isHeader && ( 84 |{rowItem.content} | 91 | )} 92 |
50 |
106 |
107 | );
108 | }
109 | }
110 |
111 | export default FeedbackForm;
112 |
--------------------------------------------------------------------------------
/src/components/organisms/Header/index.js:
--------------------------------------------------------------------------------
1 | import PropTypes from 'prop-types';
2 | import React from 'react';
3 | import ReactRouterPropTypes from 'react-router-prop-types';
4 | import logo from '../../../assets/Logo.svg';
5 | import { performSearch } from '../../../utils/search';
6 | import InputSearch from '../../molecules/InputSearch';
7 |
8 | class Header extends React.Component {
9 | static propTypes = {
10 | topTitles: PropTypes.arrayOf(PropTypes.shape({
11 | name: PropTypes.string,
12 | href: PropTypes.string
13 | })),
14 | popularTopics: PropTypes.arrayOf(
15 | PropTypes.shape({
16 | query: PropTypes.string.isRequired,
17 | name: PropTypes.string.isRequired
18 | })
19 | ),
20 | onBurgerClick: PropTypes.func,
21 | history: ReactRouterPropTypes.history
22 | };
23 |
24 | constructor(props) {
25 | super(props);
26 |
27 | this.handleBurgerClick = this.handleBurgerClick.bind(this);
28 | this.handleKeyUp = this.handleKeyUp.bind(this);
29 | this.onSearch = this.onSearch.bind(this);
30 | }
31 |
32 | handleBurgerClick() {
33 | if (this.props.onBurgerClick) {
34 | this.props.onBurgerClick();
35 | }
36 | }
37 |
38 | onSearch(query) {
39 | performSearch(this.props.history, query);
40 | }
41 |
42 | handleKeyUp(e) {
43 | if (e.key === 'Escape') {
44 | this.setState({ inputExpanded: false });
45 | }
46 | }
47 |
48 | render() {
49 | const { topTitles } = this.props;
50 |
51 | return (
52 |
54 |
55 |
56 |
69 |
70 | Developer Documentation
71 |
99 |
100 |
57 |
68 |
58 |
66 |
67 | -
59 | {topTitles.map((topTitle, index) =>
60 | (
- 61 | {topTitle.name} 62 | ) 63 | )} 64 |
72 |
98 |
73 |
97 |
83 |
97 |
101 |
102 |
84 |
85 |
87 |
88 |
89 |
90 |
92 |
93 |
95 |
96 |
98 | submitFeedback(this.props.apiEndpoint, '/home/', data)} />
99 |
100 |
33 | {sections.map((section, idx) => (
34 |
35 | {section.type === 'section-link' && (
36 |
45 |
95 | )}
96 |
97 | ))}
98 |
);
99 | }
100 | }
101 | export default TreeMenu;
102 |
--------------------------------------------------------------------------------
/api/src/services/amazonDynamoDbService.ts:
--------------------------------------------------------------------------------
1 | import * as aws from "aws-sdk";
2 | import { IAWSDynamoDbConfiguration } from "../models/configuration/IAWSDynamoDbConfiguration";
3 |
4 | /**
5 | * Service to handle db requests.
6 | */
7 | export abstract class AmazonDynamoDbService{section.name}
42 | )} 43 | {section.type === 'section-header' && ( 44 |{section.name}
50 |-
55 | {section.items.map((item, idx2) => (
56 |
-
65 | {item.type === 'section-header-item' && (
66 | {item.name}
67 | )}
68 | {item.type === 'section-header-sub' && (
69 |
70 | {item.name} 71 | {item.items.length > 1 ? ` [${item.items.length}]` : ''} 72 | {item.selected && ( 73 | 89 | )} 90 |-
74 | {item.items.map((child, idx3) => (
75 |
- 83 | {child.name} 84 | 85 | ))} 86 |
91 |