PageEditorByHackmd.jsx 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446
  1. import React from 'react';
  2. import PropTypes from 'prop-types';
  3. import { withTranslation } from 'react-i18next';
  4. import loggerFactory from '~/utils/logger';
  5. import AppContainer from '~/client/services/AppContainer';
  6. import PageContainer from '~/client/services/PageContainer';
  7. import EditorContainer from '~/client/services/EditorContainer';
  8. import { withUnstatedContainers } from './UnstatedUtils';
  9. import HackmdEditor from './PageEditorByHackmd/HackmdEditor';
  10. // TODO: remove this when omitting unstated is completed
  11. import { useEditorMode } from '~/stores/ui';
  12. const logger = loggerFactory('growi:PageEditorByHackmd');
  13. class PageEditorByHackmd extends React.Component {
  14. constructor(props) {
  15. super(props);
  16. this.state = {
  17. isInitialized: false,
  18. isInitializing: false,
  19. // for error
  20. hasError: false,
  21. errorMessage: '',
  22. errorReason: '',
  23. };
  24. this.getHackmdUri = this.getHackmdUri.bind(this);
  25. this.startToEdit = this.startToEdit.bind(this);
  26. this.resumeToEdit = this.resumeToEdit.bind(this);
  27. this.onSaveWithShortcut = this.onSaveWithShortcut.bind(this);
  28. this.hackmdEditorChangeHandler = this.hackmdEditorChangeHandler.bind(this);
  29. this.penpalErrorOccuredHandler = this.penpalErrorOccuredHandler.bind(this);
  30. }
  31. componentWillMount() {
  32. this.props.appContainer.registerComponentInstance('PageEditorByHackmd', this);
  33. }
  34. /**
  35. * return markdown document of HackMD
  36. * @return {Promise<string>}
  37. */
  38. getMarkdown() {
  39. const { t } = this.props;
  40. if (!this.state.isInitialized) {
  41. return Promise.reject(new Error(t('hackmd.not_initialized')));
  42. }
  43. return this.hackmdEditor.getValue();
  44. }
  45. /**
  46. * reset initialized status
  47. */
  48. reset() {
  49. this.setState({ isInitialized: false });
  50. }
  51. getHackmdUri() {
  52. const envVars = this.props.appContainer.getConfig().env;
  53. return envVars.HACKMD_URI;
  54. }
  55. get isResume() {
  56. const { pageContainer } = this.props;
  57. const {
  58. pageIdOnHackmd, hasDraftOnHackmd, isHackmdDraftUpdatingInRealtime,
  59. } = pageContainer.state;
  60. const isPageExistsOnHackmd = (pageIdOnHackmd != null);
  61. return (isPageExistsOnHackmd && hasDraftOnHackmd) || isHackmdDraftUpdatingInRealtime;
  62. }
  63. /**
  64. * Start integration with HackMD
  65. */
  66. async startToEdit() {
  67. const { pageContainer } = this.props;
  68. const hackmdUri = this.getHackmdUri();
  69. if (hackmdUri == null) {
  70. // do nothing
  71. return;
  72. }
  73. this.setState({
  74. isInitialized: false,
  75. isInitializing: true,
  76. });
  77. const params = {
  78. pageId: pageContainer.state.pageId,
  79. };
  80. try {
  81. const res = await this.props.appContainer.apiPost('/hackmd.integrate', params);
  82. if (!res.ok) {
  83. throw new Error(res.error);
  84. }
  85. await pageContainer.setState({
  86. pageIdOnHackmd: res.pageIdOnHackmd,
  87. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  88. });
  89. }
  90. catch (err) {
  91. pageContainer.showErrorToastr(err);
  92. this.setState({
  93. hasError: true,
  94. errorMessage: 'GROWI server failed to connect to HackMD.',
  95. errorReason: err.toString(),
  96. });
  97. }
  98. this.setState({
  99. isInitialized: true,
  100. isInitializing: false,
  101. });
  102. }
  103. /**
  104. * Start to edit w/o any api request
  105. */
  106. resumeToEdit() {
  107. this.setState({ isInitialized: true });
  108. }
  109. /**
  110. * Reset draft
  111. */
  112. async discardChanges() {
  113. const { pageContainer } = this.props;
  114. const { pageId } = pageContainer.state;
  115. try {
  116. const res = await this.props.appContainer.apiPost('/hackmd.discard', { pageId });
  117. if (!res.ok) {
  118. throw new Error(res.error);
  119. }
  120. this.props.pageContainer.setState({
  121. isHackmdDraftUpdatingInRealtime: false,
  122. hasDraftOnHackmd: false,
  123. pageIdOnHackmd: res.pageIdOnHackmd,
  124. remoteRevisionId: res.revisionIdHackmdSynced,
  125. revisionIdHackmdSynced: res.revisionIdHackmdSynced,
  126. });
  127. }
  128. catch (err) {
  129. logger.error(err);
  130. pageContainer.showErrorToastr(err);
  131. }
  132. }
  133. /**
  134. * save and update state of containers
  135. * @param {string} markdown
  136. */
  137. async onSaveWithShortcut(markdown) {
  138. const { pageContainer, editorContainer } = this.props;
  139. const optionsToSave = editorContainer.getCurrentOptionsToSave();
  140. try {
  141. // disable unsaved warning
  142. editorContainer.disableUnsavedWarning();
  143. // eslint-disable-next-line no-unused-vars
  144. const { page, tags } = await pageContainer.save(markdown, this.props.editorMode, optionsToSave);
  145. logger.debug('success to save');
  146. pageContainer.showSuccessToastr();
  147. // update state of EditorContainer
  148. editorContainer.setState({ tags });
  149. }
  150. catch (error) {
  151. logger.error('failed to save', error);
  152. pageContainer.showErrorToastr(error);
  153. }
  154. }
  155. /**
  156. * onChange event of HackmdEditor handler
  157. */
  158. async hackmdEditorChangeHandler(body) {
  159. const hackmdUri = this.getHackmdUri();
  160. const { pageContainer, editorContainer } = this.props;
  161. if (hackmdUri == null) {
  162. // do nothing
  163. return;
  164. }
  165. // do nothing if contents are same
  166. if (pageContainer.state.markdown === body) {
  167. return;
  168. }
  169. // enable unsaved warning
  170. editorContainer.enableUnsavedWarning();
  171. const params = {
  172. pageId: pageContainer.state.pageId,
  173. };
  174. try {
  175. await this.props.appContainer.apiPost('/hackmd.saveOnHackmd', params);
  176. }
  177. catch (err) {
  178. logger.error(err);
  179. }
  180. }
  181. penpalErrorOccuredHandler(error) {
  182. const { pageContainer, t } = this.props;
  183. pageContainer.showErrorToastr(error);
  184. this.setState({
  185. hasError: true,
  186. errorMessage: t('hackmd.fail_to_connect'),
  187. errorReason: error.toString(),
  188. });
  189. }
  190. renderPreInitContent() {
  191. const hackmdUri = this.getHackmdUri();
  192. const { pageContainer, t } = this.props;
  193. const {
  194. revisionId, revisionIdHackmdSynced, remoteRevisionId, pageId,
  195. } = pageContainer.state;
  196. const isPageNotFound = pageId == null;
  197. let content;
  198. /*
  199. * HackMD is not setup
  200. */
  201. if (hackmdUri == null) {
  202. content = (
  203. <div>
  204. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> { t('hackmd.not_set_up')}</p>
  205. {/* eslint-disable-next-line react/no-danger */}
  206. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_associate_with_growi_to_use_hackmd_refer_to_this') }} />
  207. </div>
  208. );
  209. }
  210. /*
  211. * used HackMD from NotFound Page
  212. */
  213. else if (isPageNotFound) {
  214. content = (
  215. <div className="text-center">
  216. <p className="hackmd-status-label">
  217. <i className="fa fa-file-text mr-2" />
  218. { t('hackmd.used_for_not_found') }
  219. </p>
  220. {/* eslint-disable-next-line react/no-danger */}
  221. <p dangerouslySetInnerHTML={{ __html: t('hackmd.need_to_make_page') }} />
  222. </div>
  223. );
  224. }
  225. /*
  226. * Resume to edit or discard changes
  227. */
  228. else if (this.isResume) {
  229. const isHackmdDocumentOutdated = revisionIdHackmdSynced !== remoteRevisionId;
  230. content = (
  231. <div>
  232. <p className="text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  233. <p className="text-center"><strong>{t('hackmd.unsaved_draft')}</strong></p>
  234. { isHackmdDocumentOutdated && (
  235. <div className="card border-warning">
  236. <div className="card-header bg-warning"><i className="icon-fw icon-info"></i> {t('hackmd.draft_outdated')}</div>
  237. <div className="card-body text-center">
  238. {t('hackmd.based_on_revision')}&nbsp;
  239. <a href={`?revision=${revisionIdHackmdSynced}`}><span className="badge badge-secondary">{revisionIdHackmdSynced.substr(-8)}</span></a>
  240. <div className="text-center mt-3">
  241. <button
  242. className="btn btn-link btn-view-outdated-draft p-0"
  243. type="button"
  244. disabled={this.state.isInitializing}
  245. onClick={() => { return this.resumeToEdit() }}
  246. >
  247. {t('hackmd.view_outdated_draft')}
  248. </button>
  249. </div>
  250. </div>
  251. </div>
  252. ) }
  253. { !isHackmdDocumentOutdated && (
  254. <div className="text-center hackmd-resume-button-container mb-3">
  255. <button
  256. className="btn btn-success btn-lg waves-effect waves-light"
  257. type="button"
  258. disabled={this.state.isInitializing}
  259. onClick={() => { return this.resumeToEdit() }}
  260. >
  261. <span className="btn-label"><i className="icon-fw icon-control-end"></i></span>
  262. <span className="btn-text">{t('hackmd.resume_to_edit')}</span>
  263. </button>
  264. </div>
  265. ) }
  266. <div className="text-center hackmd-discard-button-container mb-3">
  267. <button
  268. className="btn btn-outline-secondary btn-lg waves-effect waves-light"
  269. type="button"
  270. onClick={() => { return this.discardChanges() }}
  271. >
  272. <span className="btn-label"><i className="icon-fw icon-control-start"></i></span>
  273. <span className="btn-text">{t('hackmd.discard_changes')}</span>
  274. </button>
  275. </div>
  276. </div>
  277. );
  278. }
  279. /*
  280. * Start to edit
  281. */
  282. else {
  283. const isRevisionOutdated = revisionId !== remoteRevisionId;
  284. content = (
  285. <div>
  286. <p className="text-muted text-center hackmd-status-label"><i className="fa fa-file-text"></i> HackMD is READY!</p>
  287. <div className="text-center hackmd-start-button-container mb-3">
  288. <button
  289. className="btn btn-info btn-lg waves-effect waves-light"
  290. type="button"
  291. disabled={isRevisionOutdated || this.state.isInitializing}
  292. onClick={() => { return this.startToEdit() }}
  293. >
  294. <span className="btn-label"><i className="icon-fw icon-paper-plane"></i></span>
  295. {t('hackmd.start_to_edit')}
  296. </button>
  297. </div>
  298. <p className="text-center">{t('hackmd.clone_page_content')}</p>
  299. </div>
  300. );
  301. }
  302. return (
  303. <div className="hackmd-preinit d-flex justify-content-center align-items-center">
  304. {content}
  305. </div>
  306. );
  307. }
  308. render() {
  309. const hackmdUri = this.getHackmdUri();
  310. const { pageContainer, t } = this.props;
  311. const {
  312. markdown, pageIdOnHackmd,
  313. } = pageContainer.state;
  314. let content;
  315. if (this.state.isInitialized) {
  316. content = (
  317. <HackmdEditor
  318. ref={(c) => { this.hackmdEditor = c }}
  319. hackmdUri={hackmdUri}
  320. pageIdOnHackmd={pageIdOnHackmd}
  321. initializationMarkdown={this.isResume ? null : markdown}
  322. onChange={this.hackmdEditorChangeHandler}
  323. onSaveWithShortcut={(document) => {
  324. this.onSaveWithShortcut(document);
  325. }}
  326. onPenpalErrorOccured={this.penpalErrorOccuredHandler}
  327. >
  328. </HackmdEditor>
  329. );
  330. }
  331. else {
  332. content = this.renderPreInitContent();
  333. }
  334. return (
  335. <div className="position-relative">
  336. {content}
  337. { this.state.hasError && (
  338. <div className="hackmd-error position-absolute d-flex flex-column justify-content-center align-items-center">
  339. <div className="bg-box p-5 text-center">
  340. <h2 className="text-warning"><i className="icon-fw icon-exclamation"></i> {t('hackmd.integration_failed')}</h2>
  341. <h4>{this.state.errorMessage}</h4>
  342. <p className="card well text-danger">
  343. {this.state.errorReason}
  344. </p>
  345. {/* eslint-disable-next-line react/no-danger */}
  346. <p dangerouslySetInnerHTML={{ __html: t('hackmd.check_configuration') }} />
  347. </div>
  348. </div>
  349. ) }
  350. </div>
  351. );
  352. }
  353. }
  354. /**
  355. * Wrapper component for using unstated
  356. */
  357. const PageEditorByHackmdHOCWrapper = withUnstatedContainers(PageEditorByHackmd, [AppContainer, PageContainer, EditorContainer]);
  358. const PageEditorByHackmdWrapper = (props) => {
  359. const { data } = useEditorMode();
  360. if (data == null) {
  361. return null;
  362. }
  363. return <PageEditorByHackmdHOCWrapper {...props} editorMode={data} />;
  364. };
  365. PageEditorByHackmd.propTypes = {
  366. t: PropTypes.func.isRequired, // i18next
  367. appContainer: PropTypes.instanceOf(AppContainer).isRequired,
  368. pageContainer: PropTypes.instanceOf(PageContainer).isRequired,
  369. editorContainer: PropTypes.instanceOf(EditorContainer).isRequired,
  370. // TODO: remove this when omitting unstated is completed
  371. editorMode: PropTypes.string.isRequired,
  372. };
  373. export default withTranslation()(PageEditorByHackmdWrapper);